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)需明确以下几项:
安全 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 块如下:
立即学习“Python免费学习笔记(深入)”;
-
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 等常见错误根源

















