nginx必须显式配置proxy_set_header host $host;，以确保后端服务收到客户端原始域名（如api.example.com），而非proxy_pass目标地址（如127.0.0.1:8080），避免400错误、重定向失败和虚拟主机匹配异常。
Linux 下 Nginx 配置 proxy_set_header Host 的核心目的，是让后端服务（如 Node.js、Spring Boot、Django）收到请求时，能正确识别原始访问的域名，而不是看到 127.0.0.1 或上游 IP。不配或配错，常导致 400 错误、重定向失败、虚拟主机匹配错误等问题。
为什么必须显式设置 Host 头
Nginx 默认转发时会把 Host 头设为 proxy_pass 指定的目标地址（比如 127.0.0.1:8080），而非用户实际访问的域名。后端依赖 Host 判断租户、路由、SSL 跳转或生成绝对链接，一旦丢失，逻辑就可能中断。
- 用户访问
https://api.example.com/v1/user，但后端收到的 Host 是127.0.0.1:8080→ 可能返回 400 或默认站点 - 后端做 302 重定向时拼接 URL，用了错误 Host → 重定向到内网地址或丢端口，造成 404
- 多域名共用一个后端实例时，无法区分请求来源 → 全部走默认配置
推荐写法：用 $host 最稳妥
proxy_set_header Host $host; 是生产环境最常用、最安全的写法：
-
$host自动取请求头中的 Host 值，不含端口（如api.example.com） - 相比
$http_host（带端口，如api.example.com:443），它避免了重定向时暴露非标准端口的问题 - 相比
$proxy_host（即 proxy_pass 地址），它真正传递了用户意图
示例配置：
Browser Setup (No-Root Linux)
下载
在无 root/sudo 权限的环境（云容器、VPS、隔离主机）中安装并配置 OpenClaw 浏览器工具的 headless Chrome。适用场景：...
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;
}
其他 Host 变量对比与适用场景
不同变量行为差异明显，选错容易引发问题：
-
$host：推荐默认使用。取Host请求头（优先）或server_name，自动小写，无端口 -
$http_host：原样保留客户端发来的 Host 头，含端口。适合需要精确还原原始请求的调试场景，但上线慎用——HTTPS 请求带:443可能干扰后端跳转逻辑 -
$proxy_host：就是proxy_pass后面的地址（如backend:8080）。仅在明确要“隐藏前端域名、只暴露后端标识”时才用，非常少见
验证是否生效
改完配置别忘了重载：sudo nginx -t && sudo systemctl reload nginx
快速验证方法：
- 在后端服务里打印接收到的
Host请求头（如 Node.js 的req.headers.host） - 用 curl 模拟请求：
curl -H "Host: test.example.com" http://your-nginx-ip/api/test，再检查后端日志是否收到test.example.com - 抓包看 Nginx 发给后端的请求中，Host 字段内容是否符合预期
