nginx中proxy_pass末尾斜杠决定路径是替换（带/）还是透传（不带/），配置不当会导致404或重定向死循环；必须设置proxy_set_header host $host等头字段，确保后端正确识别请求。
在 Nginx 中配置 proxy_pass 实现基础反向代理，核心是用 location 块匹配请求路径，并通过 proxy_pass 指令把请求转发给后端服务。关键点在于路径拼接规则和必要的代理头设置，否则容易出现 404、重定向失败或后端获取不到真实客户端信息等问题。
基本语法与路径处理规则
proxy_pass 后面跟的 URL 地址决定了路径如何传递：
- 如果
proxy_pass以/结尾（如http://127.0.0.1:8080/），Nginx 会去掉 location 匹配的前缀，再拼接到目标地址末尾 - 如果
proxy_pass不以/结尾（如http://127.0.0.1:8080），则整个原始 URI（包括 location 前缀）会被原样追加过去
例如：location /api/ { proxy_pass http://127.0.0.1:3000/; }
访问 /api/users → 转发到 http://127.0.0.1:3000/users
而：location /api/ { proxy_pass http://127.0.0.1:3000; }
访问 /api/users → 转发到 http://127.0.0.1:3000/api/users
必须设置的代理头字段
只写 proxy_pass 往往不够，后端服务需要知道原始请求的真实信息：
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
常见问题与补充配置
实际使用中常遇到这些情况，建议一并加上：
-
超时控制：添加
proxy_connect_timeout、proxy_send_timeout、proxy_read_timeout，防止后端响应慢拖垮 Nginx -
重定向修正：后端返回 302 时，默认会用自身地址跳转，加
proxy_redirect off;或显式重写（如proxy_redirect http://127.0.0.1:3000/ /api/;） -
WebSocket 支持：若需代理 WebSocket，要额外加
proxy_http_version 1.1;和proxy_set_header Upgrade $http_upgrade;、proxy_set_header Connection "upgrade";
一个完整可用的示例
（假设后端服务运行在 localhost:3000，希望把 /api/ 下所有请求代理过去）
location /api/ {
proxy_pass http://127.0.0.1:3000/;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_connect_timeout 30;
proxy_send_timeout 60;
proxy_read_timeout 60;
}
