nginx $host $http_host

$host 和 $http_host 是 Nginx 配置中的两个内置变量，它们用于表示客户端请求的主机名。这两个变量在处理 HTTP 请求时非常有用，尤其是在重定向和反向代理的场景中。

基础概念

• $host: 这个变量包含请求头中的 "Host" 字段值，如果没有该字段，则使用服务器的监听地址。它通常用于构建 URL 或进行重定向。
• $http_host: 这个变量直接反映了客户端请求头中的 "Host" 字段的原始值，不做任何修改。如果请求头中没有 "Host" 字段，Nginx 会使用配置文件中指定的 server_name 作为默认值。

优势

• 灵活性: 使用这些变量可以在配置中动态地引用请求的主机名，使得配置更加灵活和通用。
• 易于维护: 当需要更改域名或服务器地址时，只需修改一处配置即可，无需逐个修改各个重定向规则。

类型与应用场景

应用场景

1. 重定向: 当网站更换域名时，可以使用 $host 变量将旧域名的请求重定向到新域名。
2. 反向代理: 在设置反向代理时，可以使用 $host 来确保代理服务器正确地将请求转发到目标服务器。
3. 虚拟主机: 在同一台服务器上托管多个网站时，$host 可以用来区分不同的站点，并将请求路由到正确的目录。

示例代码

server {
    listen 80;
    server_name example.com www.example.com;

    location / {
        proxy_pass http://backend_server;
        proxy_set_header Host $host;
    }

    # 重定向 www 到非 www
    if ($host = www.example.com) {
        return 301 https://example.com$request_uri;
    }
}

遇到的问题及解决方法

问题

如果在配置中使用 $host 或 $http_host 时遇到问题，可能是由于以下原因：

1. 请求头中没有 "Host" 字段: 如果客户端发送的请求没有包含 "Host" 字段，Nginx 将使用服务器的监听地址作为 $host 的值。
2. 配置错误: 可能是由于 Nginx 配置文件中的语法错误或逻辑错误导致的。

解决方法

1. 检查请求头: 确保客户端发送的请求包含了正确的 "Host" 字段。
2. 验证配置: 使用 nginx -t 命令检查配置文件的语法是否正确，并使用 nginx -s reload 命令重新加载配置。
3. 调试: 在 Nginx 配置中添加日志记录，输出 $host 和 $http_host 的值，以便于调试和排查问题。

log_format debug_host '$remote_addr - $remote_user [$time_local] '
                      '"$request" $status $body_bytes_sent '
                      '"$http_referer" "$http_user_agent" '
                      '$host $http_host';

access_log /var/log/nginx/debug.log debug_host;

通过以上步骤，可以有效地诊断和解决与 $host 和 $http_host 相关的问题。