nginx中proxy_pass路径重写核心在于location与proxy_pass结尾斜杠组合：/api/匹配+http://backend-server/转发时自动剥离前缀；/api/匹配+http://backend-server则原样拼接易出错；需灵活改写时用rewrite配合break。

在 Nginx 中使用 proxy_pass 实现路径重写，核心在于理解 Nginx 如何处理请求路径与后端服务路径的映射关系。关键不是“重写路径”本身，而是通过 location 匹配和 proxy_pass 的结尾斜杠（/）控制路径拼接逻辑。

location 末尾带斜杠 + proxy_pass 末尾带斜杠：自动剥离前缀

这是最常用、最安全的路径重写方式。Nginx 会自动去除 location 匹配到的路径前缀，并将剩余路径拼接到 proxy_pass 地址后。

location /api/ {
    proxy_pass http://backend-server/;
}

说明：

• 客户端请求 GET /api/users?name=jack
• Nginx 匹配到 /api/，剥离后剩下 users?name=jack
• 转发给后端：http://backend-server/users?name=jack

✅ 推荐用于代理到根路径的服务（如后端 API 期望接收 /users 而非 /api/users）。

location 末尾带斜杠 + proxy_pass 末尾不带斜杠：路径原样拼接

此时 Nginx 不会剥离前缀，而是把完整原始 URI 拼到 proxy_pass 后——通常导致 404 或路径错乱，应避免。

location /api/ {
    proxy_pass http://backend-server;  # ❌ 缺少结尾 /
}

后果：

FastAPI Flask Proxy

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

下载

• 请求 /api/users → 转发为 http://backend-server/api/users
• 若后端没有 /api/ 这层路由，就会返回 404

需要更灵活重写时：搭配 rewrite 指令

当需修改路径结构（如去掉某段、替换前缀、添加固定前缀），可在 proxy_pass 前用 rewrite 显式改写 $uri。

location /v1/ {
    rewrite ^/v1/(.*)$ /api/$1 break;
    proxy_pass http://backend-server;
}

说明：

• 请求 /v1/users → 重写为 /api/users
• break 表示重写后不再匹配其他 location，直接走 proxy_pass
• proxy_pass 末尾不加 /，因为 URI 已被显式改写完成

⚠️ 注意：rewrite ... last 会重新匹配 location，可能引发循环；break 更可控。

保留原始路径但修改 Host 和协议头

路径重写常需配套设置请求头，确保后端能正确生成跳转链接或识别来源：

• 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_set_header X-Forwarded-Proto $scheme; —— 告诉后端是 http 还是 https

这些虽不改变路径，但对后端正确响应（尤其是重定向、资源链接生成）至关重要。