Nginx中proxy_set_header Host用于精准控制转发给上游的Host头，确保后端正确路由：可设为固定值、$host（保留客户端域名）、$host:$server_port（含端口）或动态拼接值，且必须置于proxy_pass之前生效。
在 Nginx 中，通过 proxy_set_header 设置主机名绑定，核心是控制转发请求时发送给上游服务器的 Host 请求头。这直接影响上游服务（如后端应用）如何识别和路由请求，尤其在多域名共用一个后端或需精确匹配虚拟主机时非常关键。
明确 Host 头的作用
Host 是 HTTP/1.1 协议强制要求的请求头，用于标识客户端想访问的目标域名。当 Nginx 作为反向代理时，默认会将客户端原始的 Host 头直接透传给上游；但有时需要覆盖它，比如：
- 后端服务只响应特定域名（如
api.example.com），而客户端可能用其他域名访问 Nginx； - 多个域名指向同一后端，但后端需根据
Host做差异化处理； - 后端部署在内网，不对外暴露公网域名，需统一设为内部可识别的 Host 值。
常用 proxy_set_header Host 配置方式
在 location 或 server 块中使用 proxy_set_header Host，常见写法有：
WebChat Voice Proxy
下载
⚠️ 已弃用 — 该技能已拆分为两个独立技能，以提升模块化程度：**webchat-https-proxy**（HTTPS/WSS 反向代理）和 **webchat-voi...**
-
固定值：
proxy_set_header Host api.internal;—— 强制所有请求都带上Host: api.internal； -
保留客户端 Host：
proxy_set_header Host $host;—— 使用客户端请求中的 Host（不含端口）； -
带端口的 Host：
proxy_set_header Host $host:$server_port;—— 适用于后端依赖端口做路由的场景； -
拼接自定义域名：
proxy_set_header Host app-$server_name.example.com;—— 动态构造 Host，适合灰度或环境隔离。
配合 proxy_pass 使用的注意事项
proxy_set_header 必须放在 proxy_pass 指令之前才生效；同时注意：
- 若
proxy_pass地址含域名（如http://backend:8000），Nginx 默认会把该域名作为 Host 发送，除非显式用proxy_set_header Host覆盖； - 若
proxy_pass用 IP+端口（如http://127.0.0.1:8000），默认 Host 会是127.0.0.1:8000，通常需手动设为有意义的域名； - 建议始终显式设置
Host头，避免依赖默认行为导致后端解析异常。
验证是否生效
可在上游服务日志或调试工具（如 curl -v）中检查实际收到的 Host 头：
- 在 Nginx 配置中临时加一条日志：
log_format upstream_log "$host → $upstream_http_host";，配合access_log查看； - 用
curl -H "Host: test.example.com" http://your-nginx/测试不同输入对最终 Host 的影响； - 确保后端能正确响应所设 Host 值，否则可能返回 404 或默认站点。
