Nginx 中怎么配置 proxy_pass 转发时保留原始 Host 头-Nginx-PHP中文网

必须显式配置 proxy_set_header host $http_host;，因为 nginx 默认用 $proxy_host（即 upstream 地址）覆盖原始 host，导致后端收到错误的 host 头；$http_host 精确保留客户端请求中的域名和端口，避免重定向、cors、cookie 等问题。

nginx 中怎么配置 proxy_pass 转发时保留原始 host 头

要在 Nginx 中让 proxy_pass 转发时保留原始 Host 头，关键不是“默认保留”，而是**必须显式覆盖 Nginx 的默认行为**——否则它会把 Host 设为 upstream 地址（比如 127.0.0.1:3000 或 backend:8080），导致后端看到的 Host 完全失真。

为什么默认不保留 Host？

Nginx 在执行 proxy_pass 时，若未配置 proxy_set_header Host，就会自动使用 $proxy_host 变量（即 proxy_pass 后面的地址部分）作为 Host 请求头发送给后端。这个值是代理内部标识，和用户访问的域名毫无关系。

浏览器请求 https://admin.example.com:8443/api/login → 原始 Host 是 admin.example.com:8443
若 Nginx 没配 proxy_set_header Host → 后端收到 Host = 127.0.0.1:3000 或 backend:8080
后果：重定向跳错、静态资源 404、Cookie 域名失效、JWT 签名校验失败

正确写法：用 `$http_host`，不是 `$host`

推荐配置：proxy_set_header Host $http_host;

FastAPI Flask Proxy

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

下载

$http_host 直接取自客户端原始请求头，完整保留域名和端口（如 api.dev:8080 或 app.example.com:443）。而 $host 会自动剥离标准端口（80/443），在非标端口或需要精确校验的场景下不可靠。

客户端 Host 头是 test.local:8080 → $http_host = test.local:8080，$host = test.local
后端若用 Host 构造跳转 URL 或做 CORS 白名单，缺端口就直接出错
HTTPS 请求中带 :443 是合法且常见的，$http_host 才能如实透传

多层代理必须每层都配

proxy_set_header 的作用域仅限当前 location 或 server 块，且只对紧随其后的 proxy_pass 生效，不会继承、不会穿透。

链路示例：CDN → ALB → Nginx → 应用
只要其中任意一层没配 proxy_set_header Host $http_host;，Host 就会在那中断
不能只在最后一层 Nginx 配，前面的负载均衡器或网关也必须同步配置

完整 location 示例

以下是最小可靠配置，适用于大多数反向代理场景：

location /api/ {
    proxy_pass http://127.0.0.1:3000/;
    proxy_set_header Host $http_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;
}