proxy_pass 是 nginx 反向代理核心指令，需关注末尾斜杠行为、关键头部设置、超时与连接复用、upstream 健壮转发四大原则。
proxy_pass 是 Nginx 实现反向代理最核心的指令，配置是否合理直接影响请求转发准确性、协议兼容性、头部传递完整性以及后端服务稳定性。没有“一劳永逸”的模板，但有几条关键原则能覆盖绝大多数生产场景。
明确目标地址的末尾斜杠行为
proxy_pass 后面的 URL 是否带斜杠，决定路径重写逻辑，这是最容易出错的地方：
- 不带斜杠（如 proxy_pass http://127.0.0.1:8080;）：Nginx 会把原始 location 匹配的完整路径拼接到目标地址后。例如访问
/api/user，实际转发为http://127.0.0.1:8080/api/user - 带斜杠（如 proxy_pass http://127.0.0.1:8080/;）：Nginx 会把 location 中匹配的部分“替换”掉。例如
location /api/ { proxy_pass http://127.0.0.1:8080/; }，访问/api/user就转发为http://127.0.0.1:8080/user
保留并修正关键 HTTP 头部
后端服务常依赖 Host、X-Real-IP、X-Forwarded-For 等字段做路由或鉴权，必须显式设置：
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
- proxy_set_header Host $host; 或 $http_host;（推荐后者，保留原始端口和协议信息）
- proxy_set_header X-Real-IP $remote_addr; 传递真实客户端 IP
- proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; 支持多层代理链
- proxy_set_header X-Forwarded-Proto $scheme; 让后端知道是 http 还是 https
适配超时与连接复用
默认超时值偏短，高延迟或长连接场景下易触发 502/504；同时启用连接池可显著降低后端建连开销：
- proxy_connect_timeout 10s; 建立 TCP 连接的上限时间
- proxy_send_timeout 60s; 两次连续写操作间的等待上限
- proxy_read_timeout 60s; 两次连续读操作间的等待上限
- proxy_http_version 1.1; 必须开启，否则无法复用连接
- proxy_set_header Connection ''; 清空 Connection 头，避免干扰 keepalive
配合 upstream 实现健壮转发
单点 proxy_pass 缺乏容错能力，建议始终搭配 upstream 模块定义后端组：
- 使用 upstream backend { server 127.0.0.1:8080 max_fails=3 fail_timeout=30s; } 自动剔除异常节点
- 添加 keepalive 32; 到 upstream 块中，配合 proxy_http_version 1.1 复用连接
- 需要负载均衡时，直接在 upstream 内加 least_conn 或 ip_hash，无需额外模块
