第九章：Django 生产环境部署 — 9.1 生产环境准备

在将 Django 应用投入真实用户使用前，严谨、系统化的生产环境准备是保障系统稳定性、安全性与高性能的基石。这不仅涉及技术组件选型与配置，更涵盖安全策略、运维规范、监控体系与风险防控的全链路设计。本节全面梳理 Django 生产环境就绪的核心要素，提供可落地的最佳实践与配置范例，助您构建健壮、可维护、符合行业标准的线上服务架构。

9.1.1 生产环境与开发环境的本质差异

开发环境以敏捷迭代与调试效率为核心，而生产环境则以高可用性、强安全性、确定性性能与可审计性为刚性要求。二者在目标、数据、约束与治理逻辑上存在根本性分野：

理解上述差异是构建生产就绪系统的认知前提——所有技术决策必须服务于风险可控、故障可溯、容量可测、安全可信四大原则。

9.1.2 生产环境基础设施选型指南

9.1.2.1 服务器形态：权衡控制力、成本与运维复杂度

✅ 推荐路径：中小团队首选 容器化部署（Docker），搭配 Nginx 反向代理与 PostgreSQL 独立实例；中大型项目直接采用 Kubernetes 托管集群，实现滚动更新、自动扩缩与服务网格能力。

9.1.2.2 操作系统：稳定、安全与生态兼容性

• Ubuntu Server 22.04 LTS：社区最活跃、Django 文档官方示例首选、apt 包管理成熟，适合 90% 场景。
• Rocky Linux 9 / AlmaLinux 9：RHEL 兼容替代品，内核与安全补丁周期长（10 年支持），金融、政府类项目首选。
• Debian 12 "Bookworm"：极致稳定，但软件包版本略保守，需自行编译新版 Python 或使用 deadsnakes PPA。

⚠️ 禁用：CentOS 7/8（EOL）、Ubuntu 非 LTS 版本（如 23.10）、任何未启用 unattended-upgrades 的系统。

9.1.2.3 数据库：PostgreSQL 为 Django 生产环境事实标准

✅ 强制要求：

• 使用 psycopg2-binary（非源码编译）加速部署；
• 启用 pg_hba.conf 客户端认证（md5 或 scram-sha-256）；
• 为 Django 用户分配最小权限：CONNECT, SELECT, INSERT, UPDATE, DELETE, USAGE on schemas。

9.1.2.4 Web 服务器：Nginx 作为反向代理与静态资源网关

• 核心角色：

  • 终止 TLS（HTTPS）连接，卸载 SSL 计算压力；
  • 高效服务静态文件（CSS/JS/Images），避免 Django WSGI 进程阻塞；
  • 实现负载均衡（多 Gunicorn Worker）、请求限速、DDoS 防护；
  • 配置 X-Forwarded-* 头，确保 Django 正确识别客户端 IP 与协议。

• 最小安全配置示例（/etc/nginx/sites-available/your-django-app）：

  server {
      listen 443 ssl http2;
      server_name yourdomain.com;
      root /var/www/your-django-app/staticfiles;
  
      # TLS 配置（使用 Certbot 自动续期）
      ssl_certificate /etc/letsencrypt/live/yourdomain.com/fullchain.pem;
      ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;
      include /etc/letsencrypt/options-ssl-nginx.conf;
  
      # 安全头
      add_header X-Content-Type-Options "nosniff" always;
      add_header X-Frame-Options "DENY" always;
      add_header X-XSS-Protection "1; mode=block" always;
      add_header Referrer-Policy "no-referrer-when-downgrade" always;
  
      # 静态资源路由
      location /static/ {
          expires 1y;
          add_header Cache-Control "public, immutable";
      }
      location /media/ {
          alias /var/www/your-django-app/media/;
      }
  
      # 动态请求代理至 Gunicorn
      location / {
          proxy_pass http://127.0.0.1:8000;
          proxy_set_header Host $host;
          proxy_set_header X-Real-IP $remote_addr;
          proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
          proxy_set_header X-Forwarded-Proto $scheme;
      }
  }
  ​

9.1.2.5 应用服务器：Gunicorn 作为 Django WSGI 标准实践

• 核心参数配置（gunicorn.conf.py）：

  import multiprocessing
  
  bind = "127.0.0.1:8000"
  bind_address = "127.0.0.1:8000"
  workers = multiprocessing.cpu_count() * 2 + 1  # 通常 3–5 个 Worker
  worker_class = "sync"
  worker_connections = 1000
  timeout = 30
  keepalive = 5
  max_requests = 1000
  max_requests_jitter = 100
  preload = True
  daemon = False
  pidfile = "/var/run/gunicorn.pid"
  user = "www-data"
  group = "www-data"
  loglevel = "info"
  accesslog = "/var/log/gunicorn/access.log"
  errorlog = "/var/log/gunicorn/error.log"
  capture_output = True
  ​

• 启动方式：通过 systemd 服务管理（/etc/systemd/system/gunicorn.service），确保崩溃自动重启与日志持久化。

图 9.1-1：Django 生产环境典型分层架构

9.1.3 Django 生产设置：安全、性能与可维护性配置

9.1.3.1 强制关闭调试模式（DEBUG=False）

# settings/production.py
DEBUG = False
​

• 安全后果：DEBUG=True 会暴露完整堆栈跟踪、环境变量、数据库连接字符串、模板源码——等同于向攻击者提供系统地图。
• 性能影响：Django 调试中间件（如 DebugToolbar）在生产环境将使响应延迟增加 200–500ms。

9.1.3.2 精确配置 ALLOWED_HOSTS

# settings/production.py
ALLOWED_HOSTS = [
    "yourdomain.com",
    "www.yourdomain.com",
    "api.yourdomain.com",
    # 云服务商负载均衡器内网 IP（如 AWS ALB）
    "10.0.1.100",
    "10.0.1.101",
]
​

• 禁止写法：['*']（允许任意 Host）、['.yourdomain.com']（子域名通配符需前置点号，但仍有风险）。
• 验证方法：部署后使用 curl -H "Host: evil.com" https://yourdomain.com 测试返回 400 Bad Request。

9.1.3.3 密钥管理：环境变量 + 随机生成

# settings/production.py
import os
import secrets

SECRET_KEY = os.environ.get("DJANGO_SECRET_KEY")
if not SECRET_KEY:
    # 仅用于开发环境 fallback（生产环境必须设置环境变量）
    SECRET_KEY = secrets.token_urlsafe(50)
​

• 生成命令：python -c "import secrets; print(secrets.token_urlsafe(50))"
• 存储规范：通过 systemd 环境文件（/etc/systemd/system/gunicorn.service.d/env.conf）或 .env 文件（配合 django-environ 库）注入。

9.1.3.4 数据库配置：环境隔离与最小权限

# settings/production.py
import os
from django.core.exceptions import ImproperlyConfigured

def get_env_var(name):
    value = os.environ.get(name)
    if not value:
        raise ImproperlyConfigured(f"Environment variable {name} is required.")
    return value

DATABASES = {
    "default": {
        "ENGINE": "django.db.backends.postgresql_psycopg2",
        "NAME": get_env_var("POSTGRES_DB"),
        "USER": get_env_var("POSTGRES_USER"),
        "PASSWORD": get_env_var("POSTGRES_PASSWORD"),
        "HOST": get_env_var("POSTGRES_HOST"),
        "PORT": get_env_var("POSTGRES_PORT", "5432"),
        "OPTIONS": {
            "connect_timeout": 10,
        },
    }
}
​

• 连接池建议：在生产环境部署 pgbouncer（连接池中间件），避免数据库连接数爆炸。

9.1.3.5 静态与媒体文件：CDN 与云存储集成

# settings/production.py
import os

# 静态文件（CSS/JS/Images）
STATIC_ROOT = os.path.join(BASE_DIR, "staticfiles")
STATIC_URL = "/static/"

# 媒体文件（用户上传）
MEDIA_ROOT = os.path.join(BASE_DIR, "media")
MEDIA_URL = "/media/"

# 云存储（AWS S3 示例）
if os.environ.get("USE_S3"):
    DEFAULT_FILE_STORAGE = "storages.backends.s3boto3.S3Boto3Storage"
    AWS_ACCESS_KEY_ID = os.environ.get("AWS_ACCESS_KEY_ID")
    AWS_SECRET_ACCESS_KEY = os.environ.get("AWS_SECRET_ACCESS_KEY")
    AWS_STORAGE_BUCKET_NAME = os.environ.get("AWS_STORAGE_BUCKET_NAME")
    AWS_S3_REGION_NAME = "us-east-1"
    AWS_S3_CUSTOM_DOMAIN = f"{AWS_STORAGE_BUCKET_NAME}.s3.amazonaws.com"
    MEDIA_URL = f"https://{AWS_S3_CUSTOM_DOMAIN}/"
​

• CDN 加速：静态资源通过 Cloudflare 或 AWS CloudFront 分发，配置 Cache-Control: public, max-age=31536000。

9.1.3.6 日志：结构化、分级与集中管理

# settings/production.py
import os
import logging

LOGGING = {
    "version": 1,
    "disable_existing_loggers": False,
    "formatters": {
        "json": {
            "format": '{"time":"%(asctime)s","level":"%(levelname)s","service":"django","module":"%(module)s","message":"%(message)s"}',
            "datefmt": "%Y-%m-%dT%H:%M:%S%z",
        }
    },
    "handlers": {
        "console": {
            "class": "logging.StreamHandler",
            "formatter": "json",
        },
        "file": {
            "level": "INFO",
            "class": "logging.handlers.RotatingFileHandler",
            "filename": os.path.join(BASE_DIR, "logs", "django.log"),
            "maxBytes": 1024 * 1024 * 5,  # 5 MB
            "backupCount": 5,
            "formatter": "json",
        },
    },
    "loggers": {
        "django": {
            "handlers": ["console", "file"],
            "level": "INFO",
            "propagate": False,
        },
        "django.security": {
            "handlers": ["console", "file"],
            "level": "WARNING",
            "propagate": False,
        },
    },
}
​

• 日志采集：使用 filebeat 或 fluentd 将日志推送到 Elasticsearch 或 Loki 进行分析。

9.1.3.7 缓存：Redis 作为主缓存后端

# settings/production.py
CACHES = {
    "default": {
        "BACKEND": "django.core.cache.backends.redis.RedisCache",
        "LOCATION": os.environ.get("REDIS_URL", "redis://127.0.0.1:6379/1"),
        "OPTIONS": {
            "CLIENT_CLASS": "django_redis.client.DefaultClient",
            "CONNECTION_POOL_KWARGS": {"max_connections": 20},
        },
    }
}
​

• 强制缓存策略：在视图中使用 @cache_page(60 * 15)（15 分钟），或对 QuerySet 使用 cache.get_or_set()。

9.1.3.8 安全中间件：HTTP 头加固与传输层保护

# settings/production.py
MIDDLEWARE = [
    "django.middleware.security.SecurityMiddleware",
    "django.contrib.sessions.middleware.SessionMiddleware",
    "django.middleware.common.CommonMiddleware",
    "django.middleware.csrf.CsrfViewMiddleware",
    "django.contrib.auth.middleware.AuthenticationMiddleware",
    "django.contrib.messages.middleware.MessageMiddleware",
    "django.middleware.clickjacking.XFrameOptionsMiddleware",
]

# SecurityMiddleware 配置
SECURE_SSL_REDIRECT = True  # 强制 HTTPS
SECURE_HSTS_SECONDS = 31536000  # 1 年 HSTS
SECURE_HSTS_INCLUDE_SUBDOMAINS = True
SECURE_HSTS_PRELOAD = True
SECURE_CONTENT_TYPE_NOSNIFF = True
SECURE_BROWSER_XSS_FILTER = True
SESSION_COOKIE_SECURE = True  # Cookie 仅 HTTPS 传输
CSRF_COOKIE_SECURE = True
SESSION_COOKIE_HTTPONLY = True  # 防 XSS 窃取 Session
CSRF_COOKIE_HTTPONLY = True
REFERRER_POLICY = "strict-origin-when-cross-origin"
​

• TLS 证书：使用 Let’s Encrypt（Certbot）自动签发与续期，避免证书过期导致服务中断。

9.1.4 数据库迁移与数据初始化

9.1.4.1 安全执行迁移

# 生产环境迁移命令（无交互、带备份）
python manage.py migrate --noinput --settings=myproject.settings.production

# 执行前强制数据库备份（示例：PostgreSQL）
pg_dump -U postgres -h db-host myproject_db > /backup/myproject_$(date +%Y%m%d_%H%M%S).sql
​

• 黄金法则：所有迁移必须在 Staging 环境完整验证后，方可执行于生产环境；禁止在生产环境执行 makemigrations。

9.1.4.2 初始数据：通过数据迁移（Data Migration）注入

# myapp/migrations/0002_create_initial_data.py
from django.db import migrations

def create_superuser(apps, schema_editor):
    from django.contrib.auth.models import User
    User.objects.create_superuser(
        username="admin",
        email="admin@yourdomain.com",
        password=os.environ.get("ADMIN_PASSWORD", "temp_pass")  # 从环境变量读取
    )

class Migration(migrations.Migration):
    dependencies = [("myapp", "0001_initial")]
    operations = [migrations.RunPython(create_superuser)]
​

• 禁止行为：硬编码密码、在 fixtures 中存储敏感数据、手动 INSERT 生产数据库。

9.1.5 静态文件收集与 CDN 部署

# 收集静态文件（生产环境必需）
python manage.py collectstatic --noinput --clear --settings=myproject.settings.production

# 验证输出
ls -la staticfiles/
# 应包含 admin/、css/、js/、images/ 等目录
​

• CDN 同步：若使用 AWS S3，执行 aws s3 sync staticfiles/ s3://your-bucket/static/ --acl public-read。

9.1.6 环境隔离与依赖管理

9.1.6.1 虚拟环境：生产环境标准化

# 创建（Python 3.10+）
python3.10 -m venv /opt/myproject/venv

# 激活并安装（使用 pip-tools 精确锁定）
source /opt/myproject/venv/bin/activate
pip install pip-tools
pip-compile requirements.in  # 生成 requirements.txt
pip install -r requirements.txt
​

9.1.6.2 依赖管理：pip-tools 替代 pip freeze

• requirements.in（声明直接依赖）：

  Django>=4.2,<5.0
  psycopg2-binary>=2.9.7
  gunicorn>=21.2
  django-environ>=0.10
  ​

• pip-compile 生成 requirements.txt（含哈希校验与间接依赖），确保跨环境一致性。

9.1.7 监控与告警：生产环境可观测性基础

• 最低可行监控：uptime、free -h、df -h、journalctl -u gunicorn、tail -f /var/log/gunicorn/error.log。

9.1.8 安全加固：生产环境最小防护基线

• 防火墙：ufw（Ubuntu）或 firewalld（RHEL），仅开放 22（SSH）、80（HTTP）、443（HTTPS）端口。
• SSH 安全：

  # /etc/ssh/sshd_config
  PermitRootLogin no
  PasswordAuthentication no
  PubkeyAuthentication yes
  AllowUsers deploy www-data
  ​

• 系统更新：启用 unattended-upgrades（Ubuntu）或 dnf-automatic（RHEL），每周自动安装安全补丁。
• Django 安全检查：部署前运行 python manage.py check --deploy --settings=myproject.settings.production。

9.1.9 预发布验证：Staging 环境全链路测试

• Staging 环境要求：

  • 与生产环境 1:1 复刻（相同 OS、Python 版本、Nginx 配置、PostgreSQL 版本）；
  • 使用生产数据库副本（每日同步）与脱敏用户数据；
  • 部署脚本与生产环境完全一致（CI/CD Pipeline 复用）。

• 必测项：

  • migrate 与 collectstatic 执行耗时与成功率；
  • Nginx TLS 配置有效性（SSL Labs 测试）；
  • Gunicorn Worker 崩溃自动恢复（systemctl restart gunicorn）；
  • 日志是否正确写入 /var/log/gunicorn/ 且可被采集；
  • curl -I https://staging.yourdomain.com 返回 200 OK 与正确安全头。

9.1.10 生产环境就绪检查清单（Production Readiness Checklist）

✅ 完成标志：所有检查项为“已确认”，且 Staging 环境连续 72 小时无严重告警（ERROR 级别日志 < 10 条/小时）。

完成本清单，即标志着 Django 应用已具备生产就绪能力。后续章节将深入自动化部署流水线（CI/CD）、蓝绿发布策略、故障应急响应与容量规划等高级运维主题。