proxy_pass必须严格配合upstream才能触发轮询：需写为http://name形式，置于location中，末尾斜杠控制路径重写，且须透传host、x-real-ip、x-forwarded-for头，配置后须nginx -t验证并reload生效。

proxy_pass 在 Nginx 负载均衡中不是简单填个地址，而是必须精准配合 upstream 才能触发轮询转发。写错格式或位置，Nginx 就会绕过负载均衡，直连单台后端，甚至返回 502。

必须用 http:// 或 https:// + upstream 名称

proxy_pass 后面不能写 IP 或域名，也不能省略协议。它必须是 http://backend 或 https://api_cluster 这种形式，其中 backend 和 api_cluster 是你在 http 块里定义的 upstream 名字。

• ✅ 正确：proxy_pass http://backend;
• ❌ 错误：proxy_pass http://192.168.1.10:8080;（直连单点，不走 upstream）
• ❌ 错误：proxy_pass backend;（缺协议，语法错误）
• ❌ 错误：proxy_pass http://backend:80;（upstream 未定义端口时，加 :80 会触发 DNS 解析失败）

末尾斜杠决定路径重写行为

proxy_pass 是否带末尾斜杠，直接影响 URL 路径如何拼接到后端。

FastAPI Flask Proxy

FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。

下载

• proxy_pass http://backend/;：location 匹配的部分会被截掉。比如 location /api/ { ... } 中请求 /api/user，后端收到的是 /user
• proxy_pass http://backend;：原路径完整拼接。同样请求 /api/user，后端收到的是 /api/user
• ⚠️ 注意：proxy_pass http://backend/; 在 upstream 场景下还可能触发 "upstream cannot have URI" 报错，尤其当 upstream 已含端口或协议时

必须透传关键请求头

否则后端拿不到真实客户端信息，日志、权限校验、CDN 回源都可能出错。

• proxy_set_header Host $host;（保留原始 Host）
• proxy_set_header X-Real-IP $remote_addr;（真实客户端 IP）
• proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;（支持多层代理追加）

配置生效前要验证和重载

改完 proxy_pass 和 upstream 后，不能直接等生效。

• 先运行 sudo nginx -t 检查语法——报错会明确指出哪一行、哪个指令有问题
• 确认无误后执行 sudo systemctl reload nginx（或 sudo nginx -s reload）
• 验证方式：访问服务，同时查看各后端 access 日志，确认请求在多台机器间交替出现