Nginx中$http_host、$host与$proxy_host变量详解

1. 理解Nginx中的host变量

在Nginx配置中，$http_host、$host和$proxy_host这三个变量看似相似，实则各有其特定的使用场景和行为特点。作为一款高性能的Web服务器和反向代理服务器，Nginx在处理HTTP请求时会产生大量内置变量，这些变量在配置文件中扮演着重要角色。

我刚开始接触Nginx时，也曾被这些相似的变量名搞得晕头转向。直到在实际项目中踩过几次坑后，才真正理解了它们之间的区别。今天，我就把这些经验分享给大家，希望能帮助各位少走弯路。

这三个变量都用于处理与主机名相关的信息，但它们的来源、用途和特性各不相同。理解它们的区别对于编写正确的Nginx配置至关重要，特别是在处理虚拟主机、反向代理和重定向等场景时。一个错误的变量选择可能导致网站无法访问、重定向循环或安全漏洞等问题。

2. 变量定义与来源解析

2.1 $http_host的组成与特性

$http_host变量直接取自HTTP请求头中的Host字段。当客户端（如浏览器）发送请求时，会在HTTP头部包含类似"Host: example.com"的信息，这个值就会被Nginx捕获并存储在$http_host变量中。

这个变量的特点是：

• 完全按照客户端发送的原始Host头存储，不做任何处理
• 包含端口号（如果客户端在Host头中指定了非标准端口）
• 可能为空（如果客户端没有发送Host头）
• 在HTTP/1.0请求中可能不存在，因为Host头在HTTP/1.1中才是强制要求的

实际抓包看到的请求示例：

code复制GET / HTTP/1.1
Host: example.com:8080
User-Agent: curl/7.68.0

在这种情况下，$http_host的值就是"example.com:8080"。

2.2 $host变量的处理逻辑

$host变量是Nginx经过"规范化"处理后的主机名，它的值按以下顺序确定：

1. 来自请求行中的主机名（HTTP/1.0）
2. 来自"Host"请求头字段的主机名
3. 与请求匹配的server_name

Nginx会对$host做以下处理：

• 去除端口号（即使原始Host头包含端口）
• 转换为小写形式
• 如果Host头不存在，会使用匹配的server_name

例如，对于Host头"Example.COM:8080"，$host的值会是"example.com"。

2.3 $proxy_host的作用场景

$proxy_host变量主要用于proxy_pass指令中，表示上游服务器的地址和端口。当Nginx作为反向代理时，这个变量特别有用。

它的特性包括：

• 只在proxy_pass指令的上下文中有效
• 由proxy_pass指令中指定的URI决定
• 包含端口号（如果显式指定）
• 默认使用80端口(HTTP)或443端口(HTTPS)

例如配置：

nginx复制location / {
    proxy_pass http://backend:8080;
}

这里$proxy_host的值就是"backend:8080"。

3. 关键区别对比分析

3.1 变量来源对比

让我们通过表格清晰对比三个变量的来源差异：

3.2 端口号处理差异

端口号处理是这三个变量的重要区别点：

• $http_ho