Django 本地 runserver 正常,上线就 502;静态文件 404、Celery 不消费、数据库连接打满。部署 Django 要同时管 WSGI、静态文件、异步任务和数据库。
部署栈
- Nginx:静态文件和反代
- Gunicorn:WSGI 服务
- Postgres:数据库
- Redis:缓存和 Celery broker
- Celery:异步任务
- systemd:守护进程
上线步骤
python -m venv /opt/app/venv
/opt/app/venv/bin/pip install -r requirements.txt
/opt/app/venv/bin/python manage.py migrate
/opt/app/venv/bin/python manage.py collectstatic --noinput
生产别用 runserver;DEBUG 关掉,ALLOWED_HOSTS 填域名。

Gunicorn
gunicorn config.wsgi:application \
--bind unix:/run/gunicorn/app.sock \
--workers 3 \
--timeout 60 \
--access-logfile -
worker 数按 CPU 算,通常 2×核数+1;内存小就少开,别把机器打爆。
systemd
[Unit]
Description=gunicorn
After=network.target
[Service]
User=www-data
WorkingDirectory=/opt/app
ExecStart=/opt/app/venv/bin/gunicorn config.wsgi:application --bind unix:/run/gunicorn/app.sock
Restart=always
[Install]
WantedBy=multi-user.target
Nginx 和静态
location /static/ { alias /opt/app/staticfiles/; }
location /media/ { alias /opt/app/media/; }
location / {
proxy_pass http://unix:/run/gunicorn/app.sock;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
静态文件不要交给 Gunicorn;Nginx 直接出,快很多。

Celery
celery -A config worker -l info --concurrency=2
celery -A config beat -l info
worker 和 beat 分开守护;beat 只能起一个,多个会重复调度。

德国还是美国
- 德国:欧盟用户近,数据合规
- 美国:北美市场、成本和机型多
- 香港/新加坡:亚洲用户近
应用、数据库、Redis 同区域;Celery worker 跟应用同区,别跨洲取任务。
性能
数据库连接复用、查询优化、缓存热点;Gunicorn worker 不是越多越好,数据库连接会先打满。
安全
DEBUG=False,SECRET_KEY不进代码库- ALLOWED_HOSTS 和 CSRF 配好
- HTTPS、HSTS、Secure Cookie
- 数据库账号最小权限
- 定期更新依赖
数据库
Postgres 连接数有限,Gunicorn worker 别开太多;用连接池或 PgBouncer 缓解。
静态文件
collectstatic 后由 Nginx 直接出,别让 Gunicorn 处理静态资源。
日志
应用、Gunicorn、Celery 日志分开;按天切,权限可写。
Worker 数
Gunicorn worker 按 CPU 和内存算,数据库连接是上限;别盲目 2×核数+1。
Beat
Celery beat 只能起一个,多个会重复调度;用 systemd 守护并监控。
数据库连接
连接数打满会 502;用连接池或 PgBouncer,别只加 worker。
备份
Postgres 每天备份,媒体文件每周;恢复演练每季度一次。
监控
看 5xx、Gunicorn worker、Celery 队列和数据库连接;先定位再扩容。
静态和媒体
静态 collectstatic,媒体单独目录;大文件走对象存储,别塞应用盘。
上线检查
迁移、静态、worker、beat、权限、HTTPS 六项逐项确认。
性能调优
数据库查询优化、缓存热点、静态走 Nginx;worker 不是越多越好。
回滚
代码和迁移都要能回滚,迁移前备份。
长期
依赖和 Python 版本定期升级,别等 EOL。
文档
部署步骤写成一页,交接不靠口口相传。
常见问题 FAQ
Q1:Django 要多大配置?
2 核 4G 起步,Celery 和并发多就 4 核 8G;数据库连接比 CPU 更容易满。
Q2:502 先查什么?
Gunicorn 是否在跑、socket 权限、Nginx 配置和日志;再看应用异常。
Q3:德国还是美国节点?
欧盟用户选德国,北美选美国;应用和数据库同区域。
Q4:Celery 不消费怎么办?
看 worker 日志、Redis 连接和队列长度;先重启 worker,再查任务异常。
Q5:静态文件 404?
collectstatic 有没有跑、Nginx alias 路径对不对、权限是否可读。
总结
Django 部署的核心是 Gunicorn、Nginx 静态、Celery 和数据库:DEBUG 关掉,静态交给 Nginx,worker 和 beat 分开守护。节点跟用户走,应用和数据同区。
需要一台 Django 机器,可以按小时开一台萤光云德国 VPS,先把 Gunicorn 和 Celery 跑通。
Gunicorn 和 Celery 分开守护,出问题好排查。







