怎样在生产环境中使用Nginx转发Python Flask应用的请求？-Python教程-PHP中文网

Flask内置服务器仅适用于开发，因单线程、无并发、不安全、未优化，生产环境必须用Gunicorn等WSGI服务器配合Nginx反向代理实现高并发、TLS终止、静态文件服务与安全防护。

怎样在生产环境中使用nginx转发python flask应用的请求？

Flask 的 app.run() 启动的是 Werkzeug 开发服务器，单进程、无并发处理能力、不抗压、无健康检查、不自动重启——这些在生产中全是硬伤。Nginx 在这里不是“可选代理”，而是必须的前置网关，负责 TLS 终止、静态文件服务、连接复用、请求限流和反向代理转发。

Flask 应用需搭配 WSGI 服务器（如 gunicorn）运行，Nginx 再把 HTTP 请求转给它。常见错误是直接 proxy_pass 到 http://127.0.0.1:5000（即 Flask 自带 server），这会绕过所有生产级保障。

实操建议：

用 gunicorn --bind unix:/var/run/flask_app.sock --workers 3 --chdir /opt/myapp app:app 启动，走 Unix socket 更安全高效
Nginx 配置里用 proxy_pass http://unix:/var/run/flask_app.sock;，而非 http://127.0.0.1:8000
必须设置 proxy_set_header Host $host; 和 proxy_set_header X-Real-IP $remote_addr;，否则 Flask 的 request.host 和 request.remote_addr 会失效
加 proxy_buffering off; 如果应用返回流式响应（如 SSE 或大文件下载），否则 Nginx 可能缓存并延迟发送

Flask 默认不托管静态资源，但开发者常误设 static_url_path 或在 Nginx 里漏配 location /static/，导致 CSS/JS 404，或更糟：Nginx 把 API 请求也当静态路径匹配了。

关键点：

让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限

下载

Flask 应用中保持 static_folder='static'（默认），前端构建产物放 /opt/myapp/static/
Nginx 配置里显式拦截：location /static/ { alias /opt/myapp/static/; } —— 注意末尾斜杠和 alias 的路径映射逻辑
所有非静态路径交给 Flask：location / { proxy_pass http://unix:/var/run/flask_app.sock; }，不要写成 location /api/ 这类子路径代理，除非你真用了 URL 前缀
若 Flask 使用了 url_for('static', filename='...')，确保 Nginx 的 alias 路径与 Flask 的 static_folder 物理路径一致

这是 Nginx 找不到后端服务时最典型的报错，原因往往不在 Nginx 配置本身，而在上下游衔接环节。

排查顺序：

检查 gunicorn 进程是否存活：ps aux | grep gunicorn；socket 文件是否存在且权限正确（ls -l /var/run/flask_app.sock，Nginx worker 用户需有读写权）
确认 gunicorn 绑定地址与 Nginx proxy_pass 完全一致（unix:/path vs http://ip:port，不能混用）
看 Nginx error log：tail -f /var/log/nginx/error.log，出现 connect() to unix:/var/run/flask_app.sock failed (13: Permission denied) 就是权限问题
临时改用 http://127.0.0.1:8000 测试，排除 socket 相关干扰；成功后再切回 socket 并修复权限