1. 为什么需要区分$http_host、$host和$proxy_host
在Nginx配置中处理HTTP请求时，我们经常会遇到需要获取或设置主机名的情况。这时候$http_host、$host和$proxy_host这三个变量就会频繁出现在配置文件中。很多开发者在使用时容易混淆它们，导致一些微妙的配置错误。
这三个变量的核心区别在于它们的来源和作用场景：
- $http_host直接来自HTTP请求头中的Host字段
- $host是Nginx内部处理后的规范化主机名
- $proxy_host则与反向代理场景密切相关
理解它们的差异对于正确配置Nginx至关重要，特别是在以下场景：
- 需要精确控制传递给后端服务器的Host头时
- 在多域名环境下需要区分请求的原始目标
- 在反向代理配置中需要保持URL重写的正确性
- 日志记录中需要包含准确的域名信息
2. 变量定义与核心特性解析
2.1 $http_host：原始请求的忠实记录者
$http_host变量直接对应客户端HTTP请求头中的Host字段。它的特点是：
- 完全保留客户端发送的原始值，包括端口号（如果存在）
- 如果请求中没有Host头，则该变量为空
- 大小写敏感，保留原始的大小写形式
典型值为："example.com:8080"或"api.example.org"
在Nginx配置中，$http_host常用于：
nginx复制proxy_set_header Host $http_host; # 将原始Host头传递给后端
2.2 $host：Nginx的规范化处理结果
$host变量是Nginx对Host头进行规范化处理后的结果，具有以下特性：
- 自动去除端口号（即使原始请求包含端口）
- 如果请求没有Host头，会fallback到server_name指令的第一个值
- 统一转换为小写形式
- 不包含默认端口（80或443）
典型值为："example.com"或"api.example.org"
常见使用场景：
nginx复制if ($host != 'example.com') {
return 301 https://example.com$request_uri;
}
2.3 $proxy_host：反向代理的专属变量
$proxy_host变量专门用于反向代理场景，表示proxy_pass指令中指定的上游服务器地址：
- 包含完整的主机名和端口（除非是默认端口）
- 当proxy_pass指向upstream名称时，值为upstream名称
- 默认端口（80/443）会被省略
典型值为："backend-server:8080"或"upstream-backend"
典型配置示例：
nginx复制location / {
proxy_pass http://backend;
proxy_set_header X-Forwarded-Host $proxy_host;
}
3. 端口号处理行为的深度对比
端口号的处理是这三个变量最显著的区别点之一，也是实际配置中最容易出错的地方。
3.1 端口号保留情况
| 变量 | 默认端口(80/443) | 非默认端口 | 无端口请求 |
|---|---|---|---|
| $http_host | 保留 | 保留 | 不添加 |
| $host | 去除 | 去除 | 不添加 |
| $proxy_host | 去除 | 保留 | N/A |
3.2 实际案例验证
假设有以下请求和配置：
- 请求：
curl -H 'Host:Example.com:8080' http://nginx-server - Nginx配置：
nginx复制server { listen 80; server_name nginx-server; location / { proxy_pass http://backend:8888; return 200 "http_host=$http_host\nhost=$host\nproxy_host=$proxy_host"; } }
响应结果将是：
code复制http_host=Example.com:8080
host=example.com
proxy_host=backend:8888
3.3 端口处理背后的逻辑
这种差异设计有其实际考虑：
- $http_host保留端口：需要完整原始信息用于日志或透传
- $host去除端口：主要用于服务器内部路由决策，端口无关
- $proxy_host智能显示端口：方便调试但避免默认端口冗余
4. 反向代理场景下的关键差异
在反向代理配置中，这三个变量的差异会带来实质性影响，需要特别注意。
4.1 典型反向代理配置分析
考虑以下配置：
nginx复制server {
listen 80;
server_name proxy.example.com;
location / {
proxy_pass http://backend.example.com:8080;
proxy_set_header Host $host;
# 其他proxy_set_header配置
}
}
这种情况下：
- $proxy_host = "backend.example.com:8080"
- $host = 请求中的主机名（无端口）
- $http_host = 原始请求的Host头（可能带端口）
4.2 常见配置错误与修正
错误配置1：错误传递Host头
nginx复制proxy_set_header Host $proxy_host; # 错误！后端会收到"backend.example.com:8080"
修正方案：
nginx复制proxy_set_header Host $host; # 或明确指定域名
错误配置2：忽略端口导致的重定向问题
nginx复制proxy_set_header Host $host; # 当后端需要端口信息时会出错
修正方案：
nginx复制proxy_set_header Host $http_host; # 保留原始端口信息
4.3 不同场景下的最佳实践
- 普通反向代理：
nginx复制proxy_set_header Host $host;
- 需要保留原始端口信息：
nginx复制proxy_set_header Host $http_host;
- 自定义域名场景：
nginx复制proxy_set_header Host "custom.example.com";
- 需要传递原始Host和代理信息：
nginx复制proxy_set_header Host $http_host;
proxy_set_header X-Proxy-Host $proxy_host;
5. 实战中的边缘情况处理
在实际生产环境中，我们会遇到各种边界情况，需要特别注意这些变量的行为。
5.1 缺失Host头的情况
当请求没有Host头时：
- $http_host为空字符串
- $host会fallback到server_name的第一个值
- $proxy_host不受影响
测试案例：
bash复制curl --http1.0 -H "Host:" http://nginx-server
Nginx配置示例：
nginx复制server {
listen 80;
server_name fallback.example.com;
location / {
if ($http_host = "") {
return 200 "Missing Host header! Using $host as fallback";
}
}
}
5.2 非标准端口请求处理
对于非标准端口的请求：
- $http_host会包含端口（如"example.com:8080"）
- $host会去除端口（"example.com"）
- $proxy_host取决于proxy_pass的配置
典型问题：当使用非标准端口时，后端可能无法正确处理重定向。
解决方案：
nginx复制proxy_set_header Host $http_host; # 保留端口信息
5.3 大小写敏感问题
- $http_host保留原始大小写
- $host统一转为小写
- $proxy_host取决于proxy_pass的配置
这可能导致某些严格检查Host头的应用出现问题。解决方案：
nginx复制proxy_set_header Host $http_host; # 保留原始大小写
# 或
proxy_set_header Host example.com; # 使用规范形式
5.4 IPv6地址处理
当Host包含IPv6地址时：
bash复制curl -H "Host:[2001:db8::1]:8080" http://nginx-server
- $http_host = "[2001:db8::1]:8080"
- $host = "2001:db8::1"（注意：方括号被去除）
- $proxy_host = 取决于proxy_pass配置
需要特别注意方括号的处理，必要时手动添加：
nginx复制proxy_set_header Host [$host]:$server_port;
6. 性能与安全考量
正确使用这些变量不仅关乎功能实现，还影响服务的安全性和性能。
6.1 安全注意事项
- Host头注入风险：
- 直接使用$http_host可能存在注入风险
- 建议对用户提供的Host头进行验证
安全配置示例：
nginx复制if ($http_host !~* ^(example\.com|api\.example\.org)$) {
return 403;
}
- 信息泄露风险：
- 避免在响应中直接返回$proxy_host
- 可能暴露内部网络结构
6.2 性能优化建议
- 变量缓存：
- 频繁使用的变量应考虑缓存
- 例如在map块中预处理：
nginx复制map $http_host $cached_host {
default $http_host;
"" $server_name;
}
- 条件判断优化：
- 避免重复计算相同的变量
- 例如：
nginx复制set $final_host $http_host;
if ($final_host = "") {
set $final_host $host;
}
6.3 日志记录最佳实践
在日志中记录这些变量可以帮助调试：
nginx复制log_format proxy_log '$remote_addr - $http_host -> $proxy_host [$time_local] '
'"$request" $status $body_bytes_sent';
这样可以在日志中清晰看到：
- 原始请求的Host头
- 实际代理到的后端服务器
- 请求处理时间等信息
7. 与其他Nginx变量的交互
这些Host相关变量常与其他Nginx变量配合使用，形成强大的配置组合。
7.1 与$server_name的关系
当$http_host为空时，$host会fallback到$server_name的第一个值。这意味着：
nginx复制server {
listen 80;
server_name primary.example.com secondary.example.com;
location / {
# 当无Host头时，$host = "primary.example.com"
}
}
7.2 与$request_uri的配合
在重定向场景中，常需要组合使用：
nginx复制if ($host != 'example.com') {
return 301 https://example.com$request_uri;
}
7.3 在rewrite规则中的应用
rewrite规则可以使用这些变量进行条件判断：
nginx复制rewrite ^/(.*)$ https://$host/api/$1 permanent;
注意：这里使用$host而非$http_host，因为我们通常不需要端口信息。
7.4 与自定义变量的组合
可以创建更复杂的逻辑：
nginx复制map $http_host $api_version {
"~*v1.example.com" "v1";
"~*v2.example.com" "v2";
default "v1";
}
server {
location / {
proxy_pass http://backend-$api_version;
}
}
8. 调试技巧与问题排查
当Host相关配置出现问题时，以下调试方法非常有用。
8.1 实时查看变量值
简单有效的方法是在响应中返回变量值：
nginx复制location /debug {
return 200 "http_host=$http_host\nhost=$host\nproxy_host=$proxy_host";
}
使用curl测试：
bash复制curl -H "Host: debug.example.com:8080" http://nginx-server/debug
8.2 日志级别调整
提高错误日志级别可以获取更多信息：
nginx复制error_log /var/log/nginx/error.log debug;
8.3 常见问题排查清单
-
后端收到错误的Host头：
- 检查proxy_set_header Host的设置
- 确认使用的是$host还是$http_host
-
重定向丢失端口信息：
- 确保在Location头中包含正确的端口
- 考虑使用$http_host而非$host
-
代理到错误的上游：
- 检查$proxy_host的值是否符合预期
- 确认proxy_pass配置正确
8.4 使用Nginx调试工具
第三方工具如nginx-debug可以帮助分析变量值：
bash复制# 使用lua模块打印变量
location /debug {
content_by_lua_block {
ngx.say("http_host: ", ngx.var.http_host)
ngx.say("host: ", ngx.var.host)
ngx.say("proxy_host: ", ngx.var.proxy_host)
}
}