proxy_pass是nginx反向代理核心指令，路径处理取决于location与proxy_pass末尾斜杠组合：带/则剥离匹配前缀后拼接，不带/则原样转发；需配合proxy_set_header透传真实请求头，并支持upstream实现负载均衡与故障切换。
proxy_pass 是 Nginx 实现反向代理的核心指令，它让 Nginx 能把客户端请求“转发”给后端内部服务（如本地或局域网中的 API、Web 应用），对外只暴露一个统一入口，不直接暴露内部服务地址和端口。
proxy_pass 基本用法与路径映射逻辑
它写在 location 块中，语法简单但路径处理容易出错：
- 如果
location路径以/结尾，且proxy_pass也以/结尾，Nginx 会自动重写路径：比如location /api/ { proxy_pass http://127.0.0.1:3000/; }，访问/api/users会被转发为http://127.0.0.1:3000/users（/api/被剥离） - 如果
proxy_pass不带结尾斜杠，比如proxy_pass http://127.0.0.1:3000;，那么整个原始 URI（包括/api/users）会原样拼到目标地址后，变成http://127.0.0.1:3000/api/users - 不加
rewrite的情况下，路径是否被截断，完全取决于proxy_pass末尾有没有/—— 这是自动代理能否“透明对接”内部服务的关键细节
配合 proxy_set_header 保持真实请求上下文
后端服务常依赖原始 Host、IP 和协议信息。默认转发时这些字段可能丢失或被替换成 Nginx 自身信息，需显式设置：
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
-
proxy_set_header Host $host;：保留浏览器发来的 Host 头，避免后端因 Host 错误返回 404 或跳转异常 -
proxy_set_header X-Real-IP $remote_addr;：传递客户端真实 IP，供日志或权限校验使用 -
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;：支持多层代理时链式记录来源 IP -
proxy_set_header X-Forwarded-Proto $scheme;：让后端知道原始请求是 http 还是 https，避免强制跳转错误
支持健康检查与故障自动切换（upstream 场景）
当内部服务有多个实例（如开发环境多个端口、测试集群），可结合 upstream 块实现自动代理+容错：
- 定义一组后端：
upstream backend_api { server 127.0.0.1:3000 max_fails=2 fail_timeout=30s; server 127.0.0.1:3001 backup; } - 在 location 中使用：
proxy_pass http://backend_api; - Nginx 会轮询可用节点；某节点连续失败两次后暂停 30 秒；若主节点全不可用，则自动切到
backup节点 - 无需改代码或重启服务，就能完成服务切换，适合灰度发布或快速降级
常见陷阱与调试建议
自动代理看似简单，但实际部署时几个细节常导致 502、404 或循环重定向：
- 后端服务未监听
127.0.0.1或绑定localhost，而是只监听127.0.0.1:3000—— 确保服务监听地址允许来自 Nginx 的本地连接 - 跨域问题不是 Nginx 责任，但前端请求若带 Cookie，需后端配合设置
Access-Control-Allow-Origin和credentials，Nginx 本身不处理 CORS - 启用
proxy_redirect：当后端返回的响应头中含Location: http://localhost:3000/login，Nginx 可自动重写为公网可访问地址，避免跳转失效 - 查日志最直接：
tail -f /var/log/nginx/error.log能快速定位连接拒绝、超时或上游不可达等根本原因
