配置django-storages与LocalStack生成可浏览器访问的S3文件URL

核心问题 #

Docker内部Django用localstack主机名访问S3，生成的URL无法被外部浏览器访问；直接设置AWS_S3_CUSTOM_DOMAIN会导致boto3签名不匹配，触发403错误。需要分离内部通信域名和外部访问域名。

方案一：自定义存储类替换URL主机名 #

1. 基础S3配置（settings.py） #

保证boto3内部调用使用Docker网络内的LocalStack服务名：

INSTALLED_APPS = [
    # ... 其他应用
    'storages',
]

AWS_ACCESS_KEY_ID = 'test'
AWS_SECRET_ACCESS_KEY = 'test'
AWS_STORAGE_BUCKET_NAME = 'MyBucket'
AWS_S3_REGION_NAME = 'us-east-1'
# 内部通信用localstack主机名
AWS_S3_ENDPOINT_URL = 'http://localstack:4566'
AWS_S3_SIGNATURE_VERSION = 's3v4'
AWS_S3_VERIFY = False  # 测试环境关闭证书验证

2. 自定义存储类（yourapp/storages.py） #

重写URL生成逻辑，替换主机名为localhost：

from storages.backends.s3boto3 import S3Boto3Storage

class LocalStackS3Storage(S3Boto3Storage):
    def url(self, name, parameters=None, expire=None):
        original_url = super().url(name, parameters, expire)
        return original_url.replace('localstack:4566', 'localhost:4566')

3. 模型中使用自定义存储 #

# yourapp/models.py
from django.db import models
from .storages import LocalStackS3Storage

localstack_storage = LocalStackS3Storage()

class YourModel(models.Model):
    image = models.ImageField(storage=localstack_storage, upload_to='images/')

方案二：使用LocalStack官方localhost别名 #

利用LocalStack提供的localhost.localstack.cloud域名，避免手动替换URL：

# settings.py
AWS_S3_CUSTOM_DOMAIN = 'MyBucket.s3.localhost.localstack.cloud:4566'
AWS_S3_ADDRESSING_STYLE = 'virtual'
# 内部通信仍用localstack服务名
AWS_S3_ENDPOINT_URL = 'http://localstack:4566'

# 其余基础配置同方案一

此配置下，Django生成的URL直接使用可外部访问的域名，boto3内部调用用localstack主机名，签名验证不会冲突。

验证步骤 #

1. 启动Docker容器，上传图片后检查instance.image.url，确认URL主机名为localhost或localhost.localstack.cloud
2. 在浏览器中访问该URL，验证图片可正常加载
3. 查看Django/LocalStack日志，确认无403认证错误

内容的提问来源于stack exchange，提问作者Brandon Shute