笙亿网络策划

如何用S3或阿里云OSS存储Django静态文件

约 8 分钟读完 7 阅
文章导读
在考虑是否使用云存储托管Django静态文件时，首先需要评估项目的规模和访问量。如果应用部署在多台服务器或使用容器化环境，本地存储会导致每台机器需要同步文件，增加维护成本。云存储的优势在于文件集中管理，并且通过CDN加速可以降低服务器带宽压力。对于小型个人项目或开发环境，本地存储仍然足够，无需引入额外依赖。
📋 目录
  1. A 什么时候该用云存储
  2. B 配置步骤：S3 与阿里云 OSS
  3. C 容易踩的坑
  4. D 如何验证配置是否正确
  5. E 需要注意的边界情况
A A

什么时候该用云存储

在考虑是否使用云存储托管Django静态文件时，首先需要评估项目的规模和访问量。如果应用部署在多台服务器或使用容器化环境，本地存储会导致每台机器需要同步文件，增加维护成本。云存储的优势在于文件集中管理，并且通过CDN加速可以降低服务器带宽压力。对于小型个人项目或开发环境，本地存储仍然足够，无需引入额外依赖。

如果你正在搭一个个人博客或小工具，一台服务器就能跑，那用 `django.contrib.staticfiles` 配合 `STATIC_ROOT` 就够了。但一旦出现需要手动同步静态文件到多台机器、或者容器重启后文件丢失的情况，就该考虑切到云存储了。我的做法是先确认当前架构：是单机还是多机？静态文件是经常更新还是部署时一次性生成？如果是后者，用 Nginx 直接托管加 CDN 回源也能解决问题，不一定非要上云存储。只有当文件需要由用户上传（媒体文件）并且量比较大时，云存储才真的是刚需。

配置步骤：S3 与阿里云 OSS

阿里云OSS的配置与S3类似，首先需要在Django项目的settings.py中添加django-storages和boto3依赖，并设置DEFAULT_FILE_STORAGE为'storages.backends.s3boto3.S3Boto3Storage'。然后配置AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY、AWS_STORAGE_BUCKET_NAME、AWS_S3_REGION_NAME等参数。注意，阿里云OSS需要将AWS_S3_ENDPOINT_URL设置为对应的OSS域名，例如'https://your-bucket.oss-cn-hangzhou.aliyuncs.com'。

实际配置时，我最容易搞混的是两点：一是 `AWS_S3_REGION_NAME` 要填区域代码，比如 `cn-north-1` 或 `oss-cn-hangzhou`，但阿里云 OSS 的区域 ID 和 AWS 并不一样，需要从 OSS 控制台确认。二是 `AWS_S3_ENDPOINT_URL` 必须显式设置，否则 boto3 会默认走 AWS 的 endpoint，导致连接失败。另外，建议把密钥放在环境变量或 IAM 角色里，避免写死在代码中。如果你用阿里云，也可以使用 RAM 子账号授权，这样即使密钥泄露也能限制权限。

配置好之后，别忘了把 `STATICFILES_STORAGE` 也改成同样的 storage，这样 `collectstatic` 才会把静态文件上传到云存储。示例 settings 片段：

INSTALLED_APPS = [
    ...
    'storages',
]

DEFAULT_FILE_STORAGE = 'storages.backends.s3boto3.S3Boto3Storage'
STATICFILES_STORAGE = 'storages.backends.s3boto3.S3Boto3Storage'

AWS_ACCESS_KEY_ID = os.getenv('AWS_ACCESS_KEY_ID')
AWS_SECRET_ACCESS_KEY = os.getenv('AWS_SECRET_ACCESS_KEY')
AWS_STORAGE_BUCKET_NAME = 'my-bucket'
AWS_S3_REGION_NAME = 'oss-cn-hangzhou'
AWS_S3_ENDPOINT_URL = 'https://my-bucket.oss-cn-hangzhou.aliyuncs.com'

容易踩的坑

一个常见问题是静态文件的缓存策略。Django的staticfiles应用在collectstatic时会将静态文件同步到云存储，但如果文件名没有使用哈希值（如ManifestStaticFilesStorage），浏览器可能缓存旧文件。建议在settings.py中设置STATICFILES_STORAGE为'storages.backends.s3boto3.S3Boto3Storage'，并启用版本控制或添加查询参数。另外，注意不要在生产环境中暴露密钥，应使用环境变量或IAM角色。

除了缓存，还需要留意文件名的冲突。如果你同时使用默认的 `StaticFilesStorage` 和云存储，`collectstatic` 会先清空本地 `STATIC_ROOT`，再把文件上传到云存储。但如果之前已经有同名旧文件在存储桶里，上传不会覆盖吗？默认会覆盖，但最好在存储桶上启用版本控制，这样万一部署有问题可以回滚。另外，如果你用阿里云 OSS，它的对象版本控制是付费功能，我就踩过这个坑——以为免费，结果每月多了一笔小账单。

如何用S3或阿里云OSS存储Django静态文件

如何验证配置是否正确

配置完成后，可以通过Django shell测试文件上传：执行 `from django.core.files.storage import default_storage` 后调用 `default_storage.save('test.txt', Content('hello'))`，返回的路径应为云存储URL。然后尝试通过URL直接访问该文件，确认权限设置正确。如果访问返回403，需要检查存储桶的读写权限策略，通常需要为存储桶设置公共读权限或生成临时URL。

我还习惯在本地开一个 `python manage.py collectstatic --noinput`，看看控制台有没有报错。如果一切正常，可以去存储桶里刷新一下，确认文件的 Content-Type 是否正确（比如 CSS 是不是 text/css，JS 是不是 application/javascript）。因为 Django 的 storage 会自动根据文件名设置，但有时候自定义了后缀就会搞错，需要手动加 `AWS_S3_OBJECT_PARAMETERS` 来强制指定。

需要注意的边界情况

使用云存储后，Django应用不再直接管理文件，这导致文件访问延迟增加，尤其对于高频小文件的读写。建议将媒体文件（用户上传）和静态文件（CSS/JS/图片）分开存储，静态文件可开启CDN缓存。同时，注意云存储的跨域问题，如果前端直接请求文件，需在存储桶的CORS配置中允许来自应用域名的跨域访问。另外，删除文件时需手动清理存储桶中的冗余对象，否则会持续产生费用。

另一个容易被忽视的问题是备份。本地存储你可能会定时打包静态文件，但云存储的对象通常需要单独的备份策略。我见过的做法是给存储桶开启跨区域复制，或者用生命周期规则定期把文件转存到低成本存储层。还有就是注意文件权限，如果设置成私有读，那么前端页面会加载失败，而 Nginx 代理回源的方式又增加了复杂度。对于纯静态文件，建议直接设为公共读，配合 CDN 的 URL 鉴权来防止盗刷。

最后，如果你决定上云存储，建议先在预发布环境跑一两个版本，观察 collectstatic 耗时和文件访问速度。如果静态文件数量很大，第一次上传可能会很慢，可以分目录上传或先手动同步一部分。总体来看，云存储带来的集中管理和扩展便利远大于初期配置的麻烦，只要把上面几个点检查清楚，基本不会出大问题。