参见
想要 django.contrib.staticfiles
的使用指南,请参考 How to manage static files (e.g. images, JavaScript, CSS)。
在生产环境提供静态文件服务
在生产环境部署静态文件的基础要点有两步:在静态文件变化时,运行 collectstatic
,然后将已收集的静态文件目录配置(STATIC_ROOT
)移至静态文件服务器并提供服务。 STATICFILES_STORAGE
配置可能会要求手动将文件移动到新位置,不过 Storage
类的 post_process
方法可能会处理它。
像所有的部署任务一样,细节决定成败。每个生成环境的配置可能都有点不同个,所以,需要调整基础配置以满足你的需求。以下是常见模式,可能对你有所帮助。
在同一服务器提供站点和静态文件服务
如果你想在早已提供站点服务器服务器上同时提供静态文件服务,操作步骤类似这样:
- 将代码推送至部署服务器。
- 在服务器上运行
collectstatic
,将所有的静态文件拷贝至STATIC_ROOT
。 - 配置 Web 服务器,使其在
STATIC_URL
下为STATIC_ROOT
目录下的文件提供静态文件服务。例如, 这里是如何以 Apache 配合 mod_wsgi 开始。
你可能期望将该流程自动化,特别是在你有好几个 web 服务器的时候。
专用服务器提供静态文件服务
大多数大型 Django 网站使用一个单独的 Web 服务器——即一个不同时运行 Django 的服务器——来提供静态文件。这台服务器通常运行不同类型的网络服务器——速度更快,但功能不全。一些常见的选择是:
如何配置这些服务器超出了本文范围;查阅这些服务器各自的文档获取介绍。
由于静态文件服务器并不运行 Django,你需要将部署策略改成这样:
- 当静态文件改变时,本地运行
collectstatic
。 - 将本地
STATIC_ROOT
推送到静态文件服务器提供服务的目录。 rsync 是一个常见选项,因为这种配置只会传输文件修改部分的数据流。
从云服务或 CDN 提供静态文件服务
另一个常见的策略是从云存储供应商,如亚马逊的 S3 和/或 CDN(内容交付网络)中提供静态文件。这可以让你忽略提供静态文件的问题,而且通常可以使网页的加载速度更快(特别是在使用 CDN 时)。
使用这些服务时,基本的工作流程与上面类似,除了要将静态文件传输给存储服务商或 CDN,而不是用 rsync
将静态文件传输给服务器。
有很多中方法可以实现目的,但是若服务商提供一个 API,你可以使用一个 自定义文件储存后端 将自定义 CDN 文件后端集成到你的 Django 项目中。若你已编写或正在使用第三方的自定义存储后端,你可以通过配置 STATICFILES_STORAGE
配置指向该存储引擎告诉 collectstatic
启用它。
例如,若你已在 myproject.storage.S3Storage
中写了一个 S3 存储后端,可以这么用:
STATICFILES_STORAGE = 'myproject.storage.S3Storage'
只要完成了上述流程,你就只需运行 collectstatic
,静态文件将通过存储包推送给 S3。如果稍后需要切换至另一个存储服务商,你可能只需简单地修改配置 STATICFILES_STORAGE
配置。
关于如何编写这些后端的细节,参考 如何编写一个自定义的文件存储类。有很多可用的第三方应用提供了针对常见文件存储 API 的存储后端。 djangopackages.org 入门 是个不错的起点。
了解更多
想要了解所有配置项,命令,模板标签和 django.contrib.staticfiles
包含的其它零碎的完整细节,参考 staticfiles 参考。
讨论区