nginx 不运行 python 代码，仅作反向代理；uwsgi 负责调用 django 的 wsgi 接口执行业务逻辑。nginx 处理静态文件、tls 终止、安全策略，uwsgi 管理 python 进程与并发，二者通过 socket 明确分工，协同实现高效生产部署。
Nginx 本身不运行 Python 代码，它通过反向代理把动态请求转给 uWSGI，由 uWSGI 调用 Django 的 WSGI 接口来执行业务逻辑。这种配合不是“Nginx 托管 Django”，而是 Nginx + uWSGI 各自承担明确职责：Nginx 管静态、管连接、管安全；uWSGI 管 Python 进程、管并发、管与 Django 的通信。
核心分工必须理清
用户请求进来后，Nginx 第一时间判断路径：
- 匹配 /static/ 或 /media/ —— 直接读取服务器磁盘文件返回，不碰 uWSGI，也不进 Django
- 匹配根路径 / 或 API 路径（如 /api/v1/）—— 用
uwsgi_pass指令转发到 uWSGI 的 socket（如127.0.0.1:8001或 Unix socket 文件） - 所有 TLS 终止、HTTP/2、gzip 压缩、访问控制、限流等均由 Nginx 完成，Django 完全无感知
uWSGI 配置要点
uWSGI 是桥梁，配置文件（如 uwsgi.ini）需明确以下几项：
Secure Python Code Sandbox
下载
安全 Python 代码沙箱：在隔离的沙箱中执行任意 Python 代码，预装 requests、NumPy、pandas 库。返回 stdout、stderr。
-
chdir：指向 Django 项目根目录（含
manage.py） -
module：格式为
myproject.wsgi:application，确保能 import 到 WSGI 可调用对象 -
socket：必须用
socket = 127.0.0.1:8001或socket = /tmp/myproject.sock，不能用http参数（否则 Nginx 的uwsgi_pass会连不上） -
processes & threads：根据服务器 CPU 核心数设合理值（如
processes = 4），避免过度占用内存 - chmod-socket & chown-socket：若用 Unix socket，需确保 Nginx worker 进程有读写权限
Nginx 配置关键段落
在 /etc/nginx/sites-enabled/myapp 中，典型 server 块如下：
-
location /static { alias /path/to/staticfiles/; }—— 注意末尾斜杠和路径一致性，alias不是root -
location /media { alias /path/to/media/; }—— 媒体文件同理，确保 Django 的MEDIA_ROOT与之对应 -
location / { include uwsgi_params; uwsgi_pass 127.0.0.1:8001; }—— 必须包含uwsgi_params，它定义了标准的 uWSGI 协议变量传递规则 -
uwsgi_read_timeout 300;—— 避免长任务（如文件上传、报表生成）被误判超时断开
启动与验证顺序不能错
部署不是配完就完事，要按依赖链逐层验证：
- 先手动运行
uwsgi --ini uwsgi.ini，检查日志是否成功加载 Django、有没有 ImportError 或数据库连接失败 - 再用
curl -v http://127.0.0.1:8001（如果用了 socket 则跳过这步），或直接看 uWSGI 日志里是否有 worker 启动成功信息 - 接着
nginx -t测试配置语法，再systemctl reload nginx - 最后用浏览器或
curl http://your-domain/访问，同时查看/var/log/nginx/error.log和 uWSGI 日志，定位 502/504 等常见错误根源
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
