nginx负载均衡需upstream与proxy_pass配合实现：upstream必须定义在http块内，proxy_pass须以http://name形式指向其名称，否则仅反向代理不参与轮询；默认轮询，支持least_conn、ip_hash等策略切换。

proxy_pass 本身不直接实现负载均衡，它只是将请求转发给后端服务器。真正的负载均衡需要配合 upstream 模块来完成。单纯用 proxy_pass 指向单个地址，只是反向代理；只有把它指向一个 upstream 块，才能实现多节点间的流量分发与切换。

定义 upstream 块做流量分发基础

upstream 是 Nginx 实现负载均衡的核心配置段，必须在 http 块内定义，不能放在 server 或 location 内。每个 upstream 块起一个名字（如 backend），里面列出多个后端服务地址：

• 支持 IP + 端口、域名、UNIX socket 等多种后端地址格式
• 可为每个 server 设置 weight、max_conns、fail_timeout、max_fails 等参数，控制权重和容错行为
• 例如：upstream backend { server 192.168.1.10:8080 weight=3; server 192.168.1.11:8080; }

proxy_pass 指向 upstream 实现动态切换

location 中使用 proxy_pass 时，目标必须是 upstream 名称（带协议前缀会失效），这样请求才会进入负载均衡流程：

FastAPI Flask Proxy

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

下载

• 正确写法：proxy_pass http://backend;（注意末尾斜杠和协议）
• 错误写法：proxy_pass http://192.168.1.10:8080; —— 这绕过 upstream，不参与负载均衡
• 若 location 路径含前缀（如 /api/），proxy_pass 后的路径会影响重写逻辑，需注意是否保留或替换前缀

通过健康检查与状态标记自动切换流量

Nginx 开源版不支持主动健康检查，但可通过 passive 方式（基于失败响应触发）实现故障隔离：

• 设置 max_fails=3 fail_timeout=30s：连续失败 3 次，30 秒内不再分发请求
• 搭配 down 标记可手动下线节点，backup 标记设为备用节点（仅当其他全不可用时启用）
• 商业版 NGINX Plus 支持主动健康检查（health_check 指令），能更及时发现并剔除异常节点

切换策略可选：轮询、加权、IP Hash 或最少连接

upstream 默认使用轮询（round-robin），但可通过指令显式指定策略：

• least_conn：优先分发到当前活跃连接数最少的后端
• ip_hash：客户端 IP 哈希固定到某台后端，适合有状态会话场景（注意 IPv6 和 NAT 环境影响）
• hash $request_uri consistent：按 URI 哈希，配合一致性哈希减少缓存失效
• 所有策略都依赖 upstream 定义，proxy_pass 本身不参与决策，只执行转发