proxy_set_header 不负责路径转换，仅修改或添加请求头；路径转换需依赖 proxy_pass 的斜杠规则和 rewrite 指令，再配合 proxy_set_header 传递原始路径信息。
Nginx 的 proxy_set_header 本身不负责路径转换，它只用于修改或添加转发请求时的 HTTP 请求头。路径转换（比如重写 URL 路径、修改 Host、调整 Referer 或让后端看到预期的路径）需要配合 rewrite、proxy_pass 的路径匹配规则，以及合理的 proxy_set_header 配置共同实现。
理解 proxy_set_header 的作用边界
proxy_set_header 只影响请求头字段，例如：
-
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;—— 补充代理链路信息
它不会改变请求的 URI 路径本身。路径是否被改写、截断或补全，取决于 location 块中的匹配方式和 proxy_pass 后面是否带路径。
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
路径转换的关键在 proxy_pass 和 rewrite
真正实现路径转换的是以下两种机制：
-
proxy_pass 末尾斜杠决定路径替换行为：
location /api/ { proxy_pass http://backend/; }→ 请求/api/user转发为/userlocation /api/ { proxy_pass http://backend; }→ 请求/api/user转发为/api/user -
rewrite 指令显式重写 URI：
rewrite ^/v1/(.*)$ /api/$1 break;→ 把/v1/user改成/api/user再交给 proxy_pass
配合 proxy_set_header 让后端“认得”路径
即使路径已转换，后端可能仍需知道原始访问路径（如生成跳转链接、做权限校验）。这时可通过自定义请求头传递：
-
proxy_set_header X-Original-URI $request_uri;—— 保留原始完整 URI（含 query） -
proxy_set_header X-Forwarded-Prefix "/api";—— 告诉后端前端挂载路径前缀 -
proxy_set_header Host $host;或proxy_set_header Host backend.example.com;—— 确保后端收到正确的 Host，避免因 Host 错误导致 404 或 HTTPS 重定向异常
典型场景示例：API 网关路径剥离
用户访问 https://example.com/app/v2/users，需转发到 http://internal-api/users，且后端需要知道原始前缀 /app：
location /app/ {
rewrite ^/app(/v\d+/.*)$ $1 break;
proxy_pass http://internal-api;
proxy_set_header Host internal-api;
proxy_set_header X-Forwarded-Prefix "/app";
proxy_set_header X-Original-URI $request_uri;
}
这样：
– /app/v2/users?limit=10 → 转发为 /v2/users?limit=10
– 后端通过 X-Forwarded-Prefix 知道该请求来自 /app 下游，可用于构造绝对链接。
