NGINX proxy_pass配置问题：请求头Host未按预期生效

我来帮你梳理下这个问题的排查思路和解决方案，先明确几个关键概念，再一步步定位问题：

先搞清楚你要修改的是哪一层的Host头 #

首先要区分两个完全不同的Host头场景：

• 浏览器发给你的NGINX代理服务器的请求头：这个Host值就是你在浏览器地址栏输入的地址（IP或域名），所以如果你直接用代理服务器IP访问，浏览器发的Host自然是这个IP——这是正常行为，和你的NGINX配置无关。
• NGINX转发给目标网站example.com的请求头：这才是你通过proxy_set_header Host配置要修改的部分，这个头不会出现在浏览器的开发者工具里，需要看后端日志或抓包才能验证。

如果你的需求是让NGINX转发到example.com的请求使用目标域名作为Host，那你的配置方向是对的，但需要验证配置是否真的生效；如果是想让浏览器发送的请求Host变成example.com，那得调整访问方式。

具体排查步骤 #

1. 验证NGINX转发的Host头是否正确 #

因为浏览器的请求头看不到转发后的Host，我们可以通过日志来验证：

• 在NGINX的http块里添加自定义日志格式，记录转发相关的信息：

  log_format proxy_details '$remote_addr [$time_local] '
                          '"$request" $status '
                          '"$proxy_host" "$upstream_http_host"';
  

• 在你的server块里指定使用这个日志格式：

  access_log /var/log/nginx/proxy_access.log proxy_details;
  

• 执行nginx -t检查配置语法，没问题的话执行nginx -s reload重载配置。
• 访问代理服务器后，查看/var/log/nginx/proxy_access.log，里面的$proxy_host应该是example.com，这就说明转发的Host头已经正确设置了。

2. 检查配置是否被覆盖或未生效 #

• 确认没有其他server块或更匹配的location块覆盖了当前的proxy_set_header设置——比如如果在server级别已经设置过proxy_set_header Host，会优先于location里的配置。
• 确保你修改配置后执行了nginx -s reload，否则新配置不会生效。

3. 如果想让浏览器发送的Host是example.com #

如果你希望浏览器请求的Host就是目标域名，那需要：

• 不要直接用IP访问代理服务器，而是用example.com域名访问：
  • 如果你有example.com的DNS控制权，把它解析到你的代理服务器IP；
  • 或者在本地电脑的hosts文件里添加一行：你的代理服务器IP example.com，然后浏览器访问https://example.com（注意需要处理SSL证书问题，比如使用自签证书或者忽略浏览器的证书警告）。

修正后的参考配置 #

如果你的目标是让NGINX转发到example.com的请求使用目标域名作为Host，这个配置可以确保生效：

server {
    listen 80;
    # 如果用HTTPS，需要配置证书
    listen 443 ssl;
    ssl_certificate /path/to/your/cert.pem;
    ssl_certificate_key /path/to/your/key.pem;

    location / {
        proxy_pass https://example.com;
        # 直接指定目标域名，比$proxy_host更明确
        proxy_set_header Host example.com;
        proxy_set_header X-Original-URI $request_uri;
        # 可选：添加真实IP相关的头
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

内容的提问来源于stack exchange，提问作者Kh0s