一、技术栈定位与部署价值

在正式开展部署工作前，需明确三者的技术定位与协作关系。Django作为全功能Web框架，提供业务逻辑处理与路由分发能力；uWSGI作为应用服务器，负责WSGI协议的解析与进程管理；Nginx作为反向代理服务器，承担静态资源分发与负载均衡任务。三者形成”业务层-应用层-传输层”的垂直架构，相比传统开发服务器（如Django内置的runserver），该组合在并发处理能力（QPS提升3-5倍）、静态资源加载速度（CDN加速优化）、安全防护（DDoS防御）等方面具有显著优势。

二、环境基础检查

1. 系统兼容性验证

推荐使用Ubuntu 20.04 LTS或CentOS 8作为基础系统，需确认：

• 内核版本≥4.15（通过uname -r查看）
• 系统架构为x86_64（arch命令验证）
• 磁盘空间≥10GB（df -h /检查）

2. Python环境配置

采用虚拟环境隔离项目依赖：

# 安装系统级依赖
sudo apt update
sudo apt install -y python3-dev python3-pip python3-venv
# 创建虚拟环境
python3 -m venv /path/to/venv
source /path/to/venv/bin/activate
# 验证环境
python --version  # 应显示3.6+版本
pip --version    # 需≥20.3版本

3. 依赖包预安装

基础开发工具链：

sudo apt install -y build-essential libpcre3 libpcre3-dev zlib1g zlib1g-dev libssl-dev

三、组件安装与版本管理

1. Django项目初始化

# 创建项目目录
mkdir django_project && cd django_project
# 初始化项目（需在虚拟环境中）
django-admin startproject myproject
cd myproject
# 安装必要包
pip install django uwsgi
pip freeze > requirements.txt  # 记录精确版本

2. uWSGI安装与配置

推荐通过pip安装最新稳定版：

pip install uwsgi
# 验证安装
uwsgi --version  # 应显示2.0.19+版本

创建基础配置文件uwsgi.ini：

[uwsgi]
# 应用配置
chdir = /path/to/myproject
module = myproject.wsgi:application
master = true
processes = 4
threads = 2
# socket配置
socket = 127.0.0.1:8000
chmod-socket = 666
vacuum = true
# 日志配置
logto = /var/log/uwsgi/myproject.log

3. Nginx安装与基础配置

Ubuntu系统安装：

sudo apt install -y nginx
sudo systemctl start nginx
sudo systemctl enable nginx

验证服务状态：

sudo systemctl status nginx  # 应显示active (running)
curl -I localhost  # 应返回HTTP/1.1 200 OK

四、配置文件预写与验证

1. Nginx反向代理配置

创建/etc/nginx/sites-available/myproject：

server {
    listen 80;
    server_name example.com;
    location / {
        include uwsgi_params;
        uwsgi_pass 127.0.0.1:8000;
    }
    location /static/ {
        alias /path/to/myproject/static/;
        expires 30d;
    }
    error_page 500 502 503 504 /50x.html;
    location = /50x.html {
        root /usr/share/nginx/html;
    }
}

启用配置：

sudo ln -s /etc/nginx/sites-available/myproject /etc/nginx/sites-enabled/
sudo nginx -t  # 测试配置语法
sudo systemctl restart nginx

2. 静态文件收集

在Django项目的settings.py中配置：

STATIC_URL = '/static/'
STATIC_ROOT = os.path.join(BASE_DIR, 'static/')

执行收集命令：

python manage.py collectstatic

五、安全加固准备

1. 防火墙配置

开放必要端口：

sudo ufw allow 80/tcp
sudo ufw allow 22/tcp  # 保留SSH访问
sudo ufw enable

2. 用户权限管理

创建专用运行用户：

sudo useradd -r -s /bin/false django_user
sudo chown -R django_user:django_user /path/to/myproject

修改uWSGI配置中的uid和gid参数：

[uwsgi]
uid = django_user
gid = django_user

六、测试环境搭建

1. 本地测试配置

修改uwsgi.ini使用HTTP模式：

[uwsgi]
http = :8080

启动服务：

uwsgi --ini uwsgi.ini

验证访问：

curl http://localhost:8080  # 应返回Django默认页面

2. 压力测试准备

安装locust进行基准测试：

pip install locust

创建测试脚本locustfile.py：

from locust import HttpUser, task
class WebsiteUser(HttpUser):
    @task
    def load_test(self):
        self.client.get("/")

启动测试：

locust -H http://localhost:8080

七、部署文档编写

建议包含以下内容：

1. 环境拓扑图（Django→uWSGI→Nginx）
2. 依赖版本清单（Python 3.8.10, Django 3.2.7等）
3. 配置文件变更记录
4. 故障排查指南（502错误处理流程）
5. 回滚方案（版本控制策略）

八、常见问题解决方案

1. 502 Bad Gateway：

   • 检查uWSGI进程是否运行：ps aux | grep uwsgi
   • 验证socket权限：ls -l /path/to/socket
   • 查看Nginx错误日志：tail -f /var/log/nginx/error.log

2. 静态文件404：

   • 确认STATIC_ROOT路径正确
   • 检查Nginx的alias指令配置
   • 执行collectstatic后重启服务

3. 端口冲突：

   • 使用netstat -tulnp检查占用
   • 修改uWSGI的socket或Nginx的listen端口

通过以上系统化的准备工作，开发者可建立稳定的部署基础。实际部署时建议采用蓝绿部署策略，先在测试环境验证完整流程，再逐步迁移到生产环境。定期备份配置文件和数据库，建立自动化监控体系（如Prometheus+Grafana），可进一步提升系统可靠性。