如何在Nginx中覆盖$host变量？遇重复定义报错求助

问题原因 #

$host是Nginx的内置核心变量，由Nginx自动根据请求的Host头或server块配置生成，不允许通过set指令直接重定义，这就是你收到duplicate "host" variable报错的原因。

可行解决方案 #

1. 定义自定义变量替代（推荐） #

放弃修改$host，创建一个新变量来存储X-Real-Host的值，后续在需要的场景使用这个自定义变量：

# 在http、server或location块内定义
set $custom_host $http_x_real_host;
# 当X-Real-Host为空时，回退到原始$host的值
if ($custom_host = "") {
    set $custom_host $host;
}

# 示例1：反向代理时传递自定义Host
proxy_set_header Host $custom_host;
# 示例2：在日志中记录自定义Host
access_log /var/log/nginx/access.log combined host=$custom_host;

注意：HTTP请求头中的连字符-在Nginx变量中要替换为下划线_，所以请求头X-Real-Host对应的Nginx变量是$http_x_real_host。

2. 直接在目标场景引用$http_x_real_host #

如果只是在特定场景（比如反向代理、日志输出）需要使用X-Real-Host的值，无需额外定义变量，直接引用$http_x_real_host即可：

# 反向代理时传递真实Host
proxy_set_header Host $http_x_real_host;
# 日志中记录真实Host
access_log /var/log/nginx/real-host.log '$remote_addr - $remote_user [$time_local] "$request" $status $body_bytes_sent "$http_referer" "$http_user_agent" "$http_x_real_host"';

要是需要处理X-Real-Host为空的情况，用map指令实现默认值更优雅：

# 在http块中定义map规则
map $http_x_real_host $real_host {
    default $host;  # 为空时使用原始$host
    ~.+ $http_x_real_host;  # 非空时使用X-Real-Host的值
}

# 后续直接使用$real_host
proxy_set_header Host $real_host;

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