nginx中proxy_pass实现地址透传需正确配置路径映射与请求头：末尾带/时截掉location匹配部分再拼接，不带/则原样追加；须设置host、x-real-ip等头透传原始信息。

在 Nginx 的 location 块中使用 proxy_pass 实现地址透传，核心在于正确配置路径映射和请求头，确保后端服务接收到的原始 URI 和 Host 信息符合预期。关键不是简单写个地址，而是理解 Nginx 如何重写 URI 并转发。

理解 proxy_pass 的路径匹配与重写规则

proxy_pass 后跟的 URL 是否以 / 结尾，会直接影响 Nginx 对请求 URI 的处理方式：

• 如果 proxy_pass 指令末尾有 /（如 proxy_pass http://backend/;），Nginx 会截掉 location 匹配的部分，再拼接到后端地址后。例如：
  location /api/ { proxy_pass http://127.0.0.1:8000/; }
  访问 /api/users → 转发为 http://127.0.0.1:8000/users
• 如果末尾没有 /（如 proxy_pass http://backend;），Nginx 会原样保留整个请求 URI，直接追加到后端地址后。例如：
  location /api { proxy_pass http://127.0.0.1:8000;
  访问 /api/users → 转发为 http://127.0.0.1:8000/api/users

透传原始 Host 和客户端真实 IP

默认情况下，Nginx 会把 Host 头设为 proxy_pass 中指定的后端地址，后端可能无法识别原始域名。需显式设置请求头：

FastAPI Flask Proxy

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

下载

• proxy_set_header Host $host; —— 透传浏览器发送的 Host（如 example.com）
• proxy_set_header X-Real-IP $remote_addr; —— 传递客户端真实 IP
• proxy_set_header X-Forwarded-For $remote_addr; —— 补充 IP 链路（多层代理时可累加）
• proxy_set_header X-Forwarded-Proto $scheme; —— 透传 HTTP 或 HTTPS 协议

避免常见路径错位问题

当 location 和 proxy_pass 路径不一致时，容易出现 404 或重复路径。建议统一风格：

• 用带尾部 / 的 proxy_pass + 精确匹配 location，最可控。例如：
  location /static/ { proxy_pass http://192.168.1.10/static/; }
• 避免混用 location /foo 和 proxy_pass http://b.com/，易导致路径被错误截断或拼接
• 如需改写路径，可用 rewrite 配合 break 或 redirect，但优先靠 proxy_pass 本身的路径逻辑解决

完整透传示例（含 HTTPS 支持）

以下是一个典型反向代理配置，实现域名、协议、路径、IP 的完整透传：

location /app/ {
    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_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
}

访问 https://example.com/app/login 时，后端收到的是：
→ 请求地址：http://127.0.0.1:3000/login
→ Header 中含 Host: example.com、X-Forwarded-Proto: https、X-Real-IP: 客户端真实IP