您如何将Django应用程序部署到生产环境？

Question

Accepted Answer

将Django部署到生产环境涉及在适当的**WSGI/ASGI服务器**和**Web服务器**后面运行它、正确提供静态文件、保护设置以及管理数据库——这与内置的开发服务器有很大区别（内置开发服务器**不适合**生产环境）。

## 生产堆栈

```text
Client → NGINX (web server) → GUNICORN (WSGI app server) → DJANGO
           │                      (runs your Python app, multiple workers)
           └─ serves static/media files directly (efficient)

❌ NEVER use `python manage.py runserver` in production — it's single-threaded,
   insecure, and not built for load. Use Gunicorn (WSGI) or Uvicorn (ASGI for async).
```

dev服务器不适合生产环境。标准堆栈：**应用程序服务器**（WSGI使用Gunicorn/uWSGI，ASGI/异步使用Uvicorn）以多个workers运行Django，位于**Web服务器**（nginx）后面，该服务器处理传入连接、TLS和静态文件。

## 生产设置（安全关键）

```python
DEBUG = False                            # ❗ MUST be False — DEBUG=True leaks sensitive info
ALLOWED_HOSTS = ["example.com"]          # required when DEBUG=False
SECRET_KEY = os.environ["SECRET_KEY"]    # from the environment, NOT committed
SECURE_SSL_REDIRECT = True               # force HTTPS
SESSION_COOKIE_SECURE = True
SECURE_HSTS_SECONDS = 31536000
```

## 静态文件

```bash
python manage.py collectstatic           # gather static files into STATIC_ROOT
# then serve them via nginx or a CDN — or use WhiteNoise to serve them from the app
# (Django does NOT serve static files itself in production)
```

## 数据库和迁移

```bash
python manage.py migrate                  # apply migrations to the production DB
# use a real database (PostgreSQL), connection pooling, regular backups
```

## 典型的部署检查清单

```text
1. Set production environment variables (SECRET_KEY, DB credentials, DEBUG=False)
2. Run migrations (manage.py migrate)
3. Collect static files (collectstatic) → serve via nginx/CDN/WhiteNoise
4. Run the app with Gunicorn/Uvicorn (multiple workers, behind nginx)
5. Enable HTTPS (TLS certificates, e.g. Let's Encrypt)
6. Set up logging, error monitoring (Sentry), health checks
7. Add a process manager (systemd/supervisor) or use containers (Docker) + orchestration
8. Run `manage.py check --deploy` to audit security settings
```

## 现代部署方法

```text
✓ Containers (Docker) + orchestration (Kubernetes) or platforms (Heroku, Railway, Render)
✓ Managed databases, separate static/media storage (S3 + CDN)
✓ Background workers (Celery) + a broker (Redis) as separate services
✓ Horizontal scaling: multiple app instances behind a load balancer (keep app STATELESS)
```

## 为什么这很重要

将Django正确部署到生产环境是将应用程序从开发转向实际使用的基础知识，它涉及与本地开发从根本上不同的重要考虑因素——部署不当会导致安全漏洞、性能下降或应用程序损坏。

理解**生产堆栈**是基础：内置开发服务器（`runserver`）明确不适合生产环境（它是单线程的、不安全的、无法处理负载），因此您必须在适当的**应用程序服务器**（WSGI使用Gunicorn/uWSGI，或ASGI/异步使用Uvicorn）后面以多个workers运行Django，前面由**Web服务器**（nginx）处理连接、TLS和静态文件提供。

几个方面在安全和正确性上至关重要：**生产设置**（特别是`DEBUG=False`，这是强制的，因为`DEBUG=True`会向攻击者泄露敏感的回溯和配置信息，加上`ALLOWED_HOSTS`、来自环境的秘密`SECRET_KEY`和HTTPS强制执行）、**静态文件处理**（运行`collectstatic`并通过nginx/CDN/WhiteNoise提供文件，因为Django在生产环境中不自己提供文件——这是常见的部署失败）和**数据库管理**（实际数据库如PostgreSQL、应用迁移、备份）。

了解部署检查清单、现代方法（Docker/容器、托管平台、媒体的云存储、Celery workers作为独立服务、使用无状态应用进行水平扩展）和运营关注点（日志记录、使用Sentry进行监控、健康检查、进程管理），这就是将正常工作的生产部署与脆弱或不安全部署区分开来的关键。

因为每个真实的Django应用程序最终都必须部署，而且因为部署错误（保留`DEBUG=True`、处理不当的静态文件、泄露秘密、使用dev服务器）会导致真实的安全和可靠性问题，理解如何正确部署Django——堆栈、安全关键设置、静态/媒体处理和现代部署实践——是重要的、高风险的知识，它反映了交付生产就绪应用程序的能力，这是一个经常相关且专业上必不可少的话题，对任何负责实时系统的Django开发人员来说都很重要。