第九章：Django 应用部署指南

核心摘要：本章系统讲解 Django 项目从开发环境到生产环境的完整部署流程，涵盖部署准备、环境配置、平台选型、主流部署方案（VPS、PaaS、Docker）及上线后关键运维实践。内容聚焦Django 生产部署最佳实践，强调安全性、性能与可维护性，为构建高可用 Web 服务提供可落地的技术路径。

9.1 部署的重要性与准备工作

本地开发服务器便于快速迭代，但生产环境需应对高并发、数据持久化、安全防护与持续稳定运行等严苛要求。Django 部署的本质，是将开发成果转化为可靠、高效、安全的在线服务，直接承载真实用户访问与业务价值。

充分的部署准备是成功上线的前提，可显著降低故障率、缩短恢复时间，并保障服务平滑过渡。

9.1.1 代码审查与测试

上线前必须完成全链路质量验证：

• 代码审查：由团队成员交叉检查逻辑完整性、安全漏洞（如 XSS、CSRF 防护缺失）、数据库查询效率及编码规范符合性；
• 多层级测试：覆盖单元测试（验证单个函数/方法）、集成测试（验证模块间协作）与端到端系统测试（模拟真实用户路径），确保核心业务流在负载压力下仍保持稳定。

# myapp/tests.py
from django.test import TestCase
from .models import MyModel

class MyModelTests(TestCase):
    def test_model_creation(self):
        instance = MyModel.objects.create(name="Test Instance")
        self.assertEqual(instance.name, "Test Instance")

    def test_model_string_representation(self):
        instance = MyModel.objects.create(name="Another Test Instance")
        self.assertEqual(str(instance), "Another Test Instance")
​

执行测试命令：

python manage.py test myapp
​

9.1.2 生产环境配置（settings.py）

Django 的 settings.py 是部署安全与性能的核心。开发与生产配置必须严格分离，DEBUG = False 是生产环境不可妥协的底线——启用调试模式将暴露敏感路径、SQL 查询与堆栈信息，构成严重安全风险。

# settings/production.py
import os
from pathlib import Path

DEBUG = False

ALLOWED_HOSTS = ['yourdomain.com', 'www.yourdomain.com', '192.0.2.1']

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql_psycopg2',
        'NAME': os.environ.get('DB_NAME', 'prod_db'),
        'USER': os.environ.get('DB_USER', 'prod_user'),
        'PASSWORD': os.environ.get('DB_PASSWORD'),
        'HOST': os.environ.get('DB_HOST', 'localhost'),
        'PORT': '5432',
    }
}

STATIC_ROOT = '/var/www/your_project/static/'
MEDIA_ROOT = '/var/www/your_project/media/'

SECRET_KEY = os.environ.get('DJANGO_SECRET_KEY')
if not SECRET_KEY:
    raise ValueError("DJANGO_SECRET_KEY must be set in environment variables")

LOGGING = {
    'version': 1,
    'disable_existing_loggers': False,
    'handlers': {
        'file': {
            'level': 'INFO',
            'class': 'logging.handlers.RotatingFileHandler',
            'filename': '/var/log/django/production.log',
            'maxBytes': 1024*1024*5,  # 5 MB
            'backupCount': 5,
        },
    },
    'loggers': {
        'django': {
            'handlers': ['file'],
            'level': 'INFO',
            'propagate': True,
        },
    },
}
​

关键配置详解：

• ALLOWED_HOSTS：强制白名单机制，防御 Host Header 欺骗攻击；
• DATABASES：禁用 SQLite，选用 PostgreSQL 或 MySQL；连接参数通过环境变量注入；
• STATIC_ROOT / MEDIA_ROOT：明确静态资源与用户上传文件的物理存储路径；
• SECRET_KEY：绝不硬编码，必须由环境变量提供，推荐使用 django.core.management.utils.get_random_secret_key() 生成；
• LOGGING：启用轮转日志（RotatingFileHandler），避免单日志文件无限膨胀。

最佳实践：

• ✅ 使用 django-environ 或 python-decouple 解析环境变量，提升配置可移植性；
• ✅ 采用模块化配置结构：settings/base.py（通用）、settings/development.py、settings/production.py，通过 DJANGO_SETTINGS_MODULE 环境变量切换；
• ✅ 将 production.py 排除在 Git 版本控制之外，防止密钥泄露。

9.1.3 静态文件与媒体文件处理

生产环境必须分离静态资源与动态请求处理，以释放 Django 应用服务器压力。

执行静态文件收集：

python manage.py collectstatic --noinput
​

--noinput 参数避免交互式确认，在自动化部署中必需。

9.1.4 依赖管理：requirements.txt

requirements.txt 是环境一致性的基石。生成时应锁定精确版本，避免因依赖更新引发兼容性问题。

pip install pip-tools
pip-compile requirements.in  # 生成带哈希校验的 requirements.txt
​

部署时安装：

pip install --no-cache-dir -r requirements.txt
​

--no-cache-dir 减少磁盘占用，pip-tools 支持依赖分层（如 requirements.in 定义顶层依赖，自动生成带哈希的 requirements.txt），增强安全性与可重现性。

9.2 部署环境与策略

三环境隔离模型

主流部署策略对比

9.3 主流 Django 部署平台实践

9.3.1 VPS/裸金属服务器：全栈自主掌控

适用于对成本、安全、性能有极致要求的场景。典型技术栈：Ubuntu 22.04 + Nginx + Gunicorn + PostgreSQL + systemd。

关键配置示例

Nginx 反向代理配置（/etc/nginx/sites-available/your_project）：

upstream django_app {
    server 127.0.0.1:8000;
}

server {
    listen 80;
    server_name yourdomain.com;
    return 301 https://$server_name$request_uri;
}

server {
    listen 443 ssl http2;
    server_name yourdomain.com;

    ssl_certificate /etc/letsencrypt/live/yourdomain.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;

    location /static/ {
        alias /var/www/your_project/static/;
        expires 1y;
        add_header Cache-Control "public, immutable";
    }

    location /media/ {
        alias /var/www/your_project/media/;
        expires 1y;
    }

    location / {
        proxy_pass http://django_app;
        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;
        proxy_redirect off;
    }
}
​

Gunicorn Systemd 服务（/etc/systemd/system/gunicorn.service）：

[Unit]
Description=Gunicorn for Django Project
After=network.target

[Service]
User=www-data
Group=www-data
WorkingDirectory=/var/www/your_project
ExecStart=/var/www/your_project/venv/bin/gunicorn \
    --access-logfile /var/log/gunicorn/access.log \
    --error-logfile /var/log/gunicorn/error.log \
    --bind 127.0.0.1:8000 \
    --workers 3 \
    --timeout 120 \
    --keep-alive 5 \
    your_project.wsgi:application

[Install]
WantedBy=multi-user.target
​

启用服务：sudo systemctl daemon-reload && sudo systemctl enable gunicorn && sudo systemctl start gunicorn

9.3.2 PaaS 平台：Heroku 快速上线

适合 MVP 验证、内部工具或轻量级应用，5 分钟完成部署。

核心文件清单：

• Procfile：定义进程类型与启动命令
• requirements.txt：Python 依赖
• runtime.txt：指定 Python 版本（如 python-3.11.7）
• settings.py：配置 ALLOWED_HOSTS = ['*']（Heroku 动态域名）

Procfile：

web: gunicorn your_project.wsgi --log-file -
release: python manage.py migrate
​

部署流程：

heroku login
heroku create your-unique-app-name
git add .
git commit -m "Deploy to Heroku"
git push heroku main
heroku open
​

Heroku 自动执行：依赖安装 → 运行 release 命令迁移数据库 → 启动 web 进程。免费层含 550 小时/月运行时，适合低流量场景。

9.3.3 Docker 容器化部署：标准化与云原生

构建生产就绪镜像（Dockerfile）

FROM python:3.11-slim-bookworm

ENV PYTHONDONTWRITEBYTECODE=1
ENV PYTHONUNBUFFERED=1

WORKDIR /app

COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

COPY . .

RUN python manage.py collectstatic --noinput

EXPOSE 8000

CMD exec gunicorn --bind :8000 --workers 3 --threads 2 --timeout 120 your_project.wsgi:application
​

多服务编排（docker-compose.prod.yml）

version: '3.9'
services:
  web:
    build:
      context: .
      dockerfile: Dockerfile
    image: your-django-app:prod
    restart: unless-stopped
    environment:
      - DJANGO_SETTINGS_MODULE=your_project.settings.production
      - DATABASE_URL=postgres://django:changeme@db:5432/django_db
    depends_on:
      - db
      - redis
    volumes:
      - static_volume:/var/www/your_project/static
      - media_volume:/var/www/your_project/media

  db:
    image: postgres:15
    restart: unless-stopped
    environment:
      - POSTGRES_DB=django_db
      - POSTGRES_USER=django
      - POSTGRES_PASSWORD=changeme
    volumes:
      - postgres_data:/var/lib/postgresql/data/

  redis:
    image: redis:7-alpine
    restart: unless-stopped

  nginx:
    image: nginx:alpine
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./nginx/conf.d:/etc/nginx/conf.d
      - static_volume:/var/www/your_project/static
      - media_volume:/var/www/your_project/media
      - /etc/letsencrypt:/etc/letsencrypt

volumes:
  postgres_data:
  static_volume:
  media_volume:
​

启动命令：docker-compose -f docker-compose.prod.yml up -d
镜像推送至私有仓库后，可无缝部署至 AWS ECS、阿里云 ACK 或自建 Kubernetes 集群。

9.4 部署后的关键运维实践

上线不是终点，而是持续优化的起点。以下维度决定服务长期健康度。

9.4.1 数据库可靠性保障

• 自动化备份：每日全量 + 每小时增量，保留 30 天，异地存储；
• 灾备演练：每季度执行一次备份恢复测试；
• 慢查询监控：启用 PostgreSQL log_min_duration_statement=1000，接入 Prometheus + Grafana 告警。

9.4.2 全栈可观测性

• 日志统一收集：Filebeat → Logstash → Elasticsearch → Kibana（ELK Stack）；
• 指标监控：Django 暴露 /metrics 端点（django-prometheus），采集请求延迟、错误率、数据库连接池状态；
• 分布式追踪：集成 Jaeger 或 Zipkin，定位跨服务调用瓶颈。

9.4.3 持续安全加固

• HTTPS 强制：Nginx 配置 HSTS 头（strict-transport-security: max-age=31536000; includeSubDomains）；
• Django 安全中间件：启用 SecurityMiddleware，配置 SECURE_HSTS_SECONDS、SECURE_CONTENT_TYPE_NOSNIFF；
• 依赖漏洞扫描：CI 流程中集成 safety check -r requirements.txt 或 pip-audit。

9.4.4 性能优化黄金法则

9.4.5 CI/CD 自动化流水线

典型 GitHub Actions 流程：

name: Django CI/CD
on:
  push:
    branches: [main]
    paths-ignore:
      - '**.md'
      - 'docs/**'

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Set up Python
        uses: actions/setup-python@v4
        with:
          python-version: '3.11'
      - run: pip install -r requirements.txt
      - run: python manage.py test

  deploy:
    needs: test
    if: github.ref == 'refs/heads/main'
    runs-on: ubuntu-latest
    steps:
      - name: Deploy to Production
        run: |
          # SSH 部署脚本或触发 Webhook 调用 Ansible Tower
          ssh user@prod-server "cd /var/www/your_project && git pull && ./deploy.sh"
​

自动化带来：部署频率提升 10 倍、故障平均恢复时间（MTTR）缩短至分钟级、人为失误归零。

结语：部署即产品化

Django 部署远不止“让网站跑起来”。它是将开发价值转化为用户可感知服务的关键环节，是安全、性能、可靠性与运维效率的综合体现。从 DEBUG=False 的第一行配置，到 CI/CD 流水线的每一次自动部署，每一个决策都在塑造产品的最终形态。

掌握本章所述的标准化配置、环境隔离原则、容器化范式与自动化运维实践，开发者即可构建出经得起流量考验、抵御安全威胁、支持持续演进的现代 Web 应用。部署不是终点，而是产品生命周期中持续交付、持续优化的坚实起点。