默认情况下Nginx的proxy_pass会重置Host头为上游地址，导致后端无法识别原始域名；需显式配置proxy_set_header Host $host;以保留客户端Host头，并配合X-Real-IP、X-Forwarded-For、X-Forwarded-Proto等头部确保后端正确识别访问意图。
默认情况下，Nginx 使用 proxy_pass 转发请求时会**重置 Host 请求头**为上游服务器的地址（如 proxy_pass http://127.0.0.1:8080 时 Host 变成 127.0.0.1:8080），这会导致后端服务无法识别原始访问域名，影响虚拟主机路由、HTTPS 重定向、资源路径生成等逻辑。要保持客户端发送的原始 Host 头，关键在于显式设置 proxy_set_header Host $host;。
为什么需要手动设置 Host 头
Nginx 的 proxy_pass 默认行为是“安全优先”：它不信任客户端传来的 Host 值，避免 Host 头被恶意篡改引发虚拟主机混淆或缓存污染。因此，除非明确配置，否则它会用 upstream 地址覆盖 Host。后端应用（如 Django、Spring Boot、WordPress）若依赖 Host 判断当前站点域名，就会出错——比如生成错误的跳转链接或加载不到静态资源。
正确保留原始 Host 的写法
在 location 或 server 块中添加以下指令：
-
proxy_set_header Host $host;—— 传递客户端请求中的 Host 值（不含端口，如example.com） -
proxy_set_header X-Real-IP $remote_addr;—— 透传真实客户端 IP（可选但推荐） -
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;—— 补充 IP 链路（可选）
注意：$host 是 Nginx 内置变量，取自请求行或 Host 头；$http_host 会原样保留 Host 头（含端口，如 example.com:8080），一般用 $host 更稳妥。
⚠️ 已弃用 — 该技能已拆分为两个独立技能，以提升模块化程度：**webchat-https-proxy**（HTTPS/WSS 反向代理）和 **webchat-voi...**
配合其他常见代理头一起配置
仅设 Host 不够，完整代理场景建议一并配置：
-
proxy_set_header Connection '';—— 清除 Connection 头，避免干扰 HTTP/1.1 keepalive -
proxy_http_version 1.1;—— 显式启用 HTTP/1.1，支持长连接和 chunked 编码 -
proxy_set_header X-Forwarded-Proto $scheme;—— 传递协议（http/https），方便后端判断是否启用 HTTPS
这些组合能确保后端正确识别用户访问意图，尤其在 SSL 终止于 Nginx 的典型架构中必不可少。
避免 Host 头被意外覆盖的细节
如果 upstream 定义了多个服务器（如 upstream backend { server 10.0.0.1; server 10.0.0.2; }），且你在 upstream 块里写了 proxy_set_header，该配置不会生效——必须放在 location 或 server 块中。另外，若使用 rewrite 改写 URI 后再 proxy_pass，Host 头仍由 proxy_set_header 控制，不受 rewrite 影响。
