这篇文章资料来自于网络，对部分知识整理，这里只是记录一下，仅供参考。

关于变量 host，在 Nginx 的官网 wiki 中是如下说明的：

$host：in this order of precedence: host name from the request line, or host name from the “Host” request header field, or the server name matching a request

直白的翻译一下：host 变量的值按照如下优先级获得：

  1. 请求行中的 host
  2. 请求头中的 Host 头部
  3. 与一条请求匹配的 server name

很清楚，有三点，取优先级最高的那个。仅从字面意思上来理解，这个选择的过程为：

  • 如果请求行中有 host 信息，则以请求行中的 host 作为 host 变量的值（host 与 host 变量不是一个东西，很拗口）；
  • 如果请求行中没有 host 信息，则以请求头中的 Host 头的值作为 host 变量的值；
  • 如果前面两者都没有，那么 host 变量就是与该请求匹配所匹配的 serve 名。

为了表示语气的加强，再重复一遍，这个规则包含了三个步骤。

但由于某种不知名的原因，网上能找到的大部分关于该变量的说明都只包含两点。

例如这个：

$host

请求中的 Host 字段，如果请求中的 Host 字段不可用，则为服务器处理请求的服务器名称。

再例如这个：

$host，请求信息中的“Host”，如果请求中没有 Host 行，则等于设置的服务器名。

        这些说法都是错误的。它们将一个本来很有内涵的东西向读者隐藏起来，如果你只是一扫而过，在心里默念，哦，这个变量原来是这样的，很简单嘛，那就会错过很多东西。下面就来详细的说明一下该变量。

1. 什么是请求行中的host?

        我们知道，HTTP 是一个文本协议，建立在一个可靠的传输层协议之上。这个传输层协议要是可靠的，面向连接的。由于 TCP 的普及程度，让它成了 HTTP 下层协议事实上的标准。但我们要知道，HTTP 并不仅限于建立在 TCP 之上。只要是可靠的，面向连接的传输层协议，都可以用来传输 HTTP。下面所说的 HTTP，都是指搭载在 TCP 之上的 HTTP。

        一个 HTTP 请求过程是这样的，客户端先与服务器建立起 TCP 连接，然后再与服务器端进行请求和回复的收发。请求包含请求行、请求头和请求体，其中，根据请求方法的不同，请求体是可选的。

下面开始说请求行。

        在发送请求行之前，客户端与服务器已经建立了连接。所以此时请求行中并不需要有服务器的信息。例如，可以如下：

GET /index.php HTTP/1.1

        这就是一个完整的 HTTP 请求行。虽然请求行中不需要有服务器的信息，但仍然可以在请求行中包含服务器的信息。例如：

GET www.pureage.info/index.php HTTP/1.1

        两者一比较，就很容易理解什么叫请求行中的 host 了。第一个请求行中，就没有 host，第二种请求行中，就带了 host，为 wwww.pureage.info。

2. Host 请求头与 HTTP/1.0、HTTP/1.1

        一个请求，请求行下面就是一些列的请求头。这些请求头，在 HTTP/1.0 中，都是可选的，且 HTTP/1.0 不支持 Host 请求头；而在 HTTP/1.1 中，Host 请求头部必须存在。

        除了阅读 RFC2616 来确认这一点外，我们来看看 Nginx 中的代码：

ngx_int_t  
ngx_http_process_request_header(ngx_http_request_t *r)  
...(略)...  
if (r->headers_in.host == NULL && r->http_version > NGX_HTTP_VERSION_10) {  
        ngx_log_error(NGX_LOG_INFO, r->connection->log, 0,  
                   "client sent HTTP/1.1 request without \"Host\" header");  
        ngx_http_finalize_request(r, NGX_HTTP_BAD_REQUEST);  
        return NGX_ERROR;  
...(略)...

即，如果协议版本在 HTTP/1.0 之上，且请求头部没有 Host 的话，会直接返回一个 Bad Request 错误响应。

3. 什么是与请求匹配的 server name?

        server name 是指在 Nginx 配置文件中，在 server 块中，用 server_name 指令设置的值。一个server 可以多次使用 server_name 指令，来实现俗称的“虚拟主机”。例如：

server {  
    listen      80;  
    server_name example.org www.example.org;  
    ...  
}  
  
server {  
    listen      80;  
    server_name example.net www.example.net;  
    ...  
}  
  
server {  
    listen      80;  
    server_name example.com www.example.com;  
    ...  
}

关于虚拟主机的确定方法，还是引用 Nginx 的官方文档：

在这个配置中，nginx 仅仅检查请求的“Host”头以决定该请求应由哪个虚拟主机来处理。

如果Host 头没有匹配任意一个虚拟主机，或者请求中根本没有包含 Host 头，那 nginx 会将请求分发到定义在此端口上的默认虚拟主机。

在以上配置中，第一个被列出的虚拟主机即 nginx 的默认虚拟主机——这是 nginx 的默认行为。而且，可以显式地设置某个主机为默认虚拟主机，即在"listen"指令中设置"default_server"参数：

server {
listen 80 default_server;
server_name example.net www.example.net;
…
}

4. 整理一下

        上面所有的说明，都仅仅是解释了 Nginx 官方文档中关于 host 变量选择的三个来源值。不过，知道了这三个值是什么，怎么来的，以及 HTTP/1.0 与 HTTP/1.1 的区别，我们就能彻底搞清楚这个 host 变量是怎么确定的了。

        首先，无论是 HTTP/1.0 还是 HTTP/1.1 请求，只要请求行中带了主机信息，那么 host 变量就是该请求行中所带的 host。需要注意的是，host 变量是不带端口号的。

所以，下面两条请求的 host 变量都是 www.pureage.info：

GET http://www.pureage.info/index.php HTTP/1.0
GET http://www.pureage.info/index.php HTTP/1.1

        其次，假设请求行中不带主机信息，那么我们就来看请求头部中的 Host 头。此时 HTTP/1.0 请求和HTTP/1.1 请求的表现就大不相同了。有如下几种情况：

  1. HTTP/1.0 请求，不带 Host 头

    GET /index.php HTTP/1.0

    此时，host 变量为与该请求匹配的虚拟主机的主机名，及在 nginx 配置文件中与之匹配的 server 段中 server_name 指令设置的值。如果该 server 中没有使用 server_name 指令，那么 host 变量就是一个空值，不存在。

  2. HTTP/1.0请求，带Host头

    GET /index.php HTTP/1.0  Host: www.pureage.info

    此时，host 变量即为 www.pureage.info

  3. HTTP/1.1 请求，不带 Host 头

    GET /index.php HTTP/1.1

    如前所述，HTTP/1.1 请求必须携带 Host 头部。所以这种情况，请求会返回一个 Bad Request 错误响应。host 变量当然就更不存在了。

  4. HTTP/1.1请求，带Host头

    GET /index.php HTTP/1.1 Host: www.pureage.info

    此时，host 变量即为 www.pureage.info

        通过上面的例子，可以看出:

  • 对于HTTP/1.1 请求，host 变量不会为空，它要么在请求行中指定，要么在 Host 头部指定，要么就是一条错误的请求；
  • 而对于 HTTP/1.0 请求，host 变量有为空的情况，即请求行和请求头中没有指定 host，且匹配的 server 也没有名称时。

5、延伸： Nginx 的 host与http_host 的区别

        $host 是nginx的官方变量，可以从官方查询
        $http_host 则是读取请求头header里面的key，所有请求头里面的key再nginx里面都可以通过小写和下划线来让nginx读取。例如header里面的Host就能转成$http_host, user_agent可以转成$http_user_agent。
        所以，只要是header的请求头都可以这样被nginx读取， 我们测试一下：

HEAD /rec/app/detail/youxidaren.html HTTP/1.1 
Host: mo.ouwan.com
Content-type: html/txt
Test-key: test-value

HTTP/1.1 200 OK
Server: nginx/1.4.6 (Ubuntu)
Date: Thu, 22 Mar 2018 12:28:56 GMT
Content-Type: text/html; charset=utf-8
Connection: keep-alive
Vary: Cookie
# 这三个头都是我请求的时候加的。
x_host: mo.ouwan.com
x_test_key: test-value
x_content_type: html/txt

当然这个几个头部能在response显示是因为在nginx加了add_header控制的：

location / {
        add_header x_host   $http_host;
        add_header x_test_key $http_test_key;
        add_header x_content_type $http_content_type;
}

        $http_header的应用：当我们一个项目部署在两个服务器下面，然后在另外一个服务器搭建nginx反响代理，反响代理把请求转发给两个服务器的时候，他们的日志记录的是反向代理的ip， 而不是真正请求的用户IP， 这时就可以通过配置proxy_set_header 把真实IP设置给一个X-forwarded-For 或者 X-Real-IP 转给后端服务器，然后后端服务器读取通过http_x_real_ip来读取真实IP， 记录到access_log下面

 location / {
                proxy_pass http://tg_web_cluster;
                proxy_set_header Host      $host;
                proxy_set_header X-Real-IP $remote_addr;
                proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
                # proxy_set_header X-Forwarded-Proto $scheme;
        }

日志的格式把第一个IP换成刚才转发过来的头部X-Real-IP就可以记录用户IP了：

    log_format tg_log '$http_x_real_ip - $remote_user [$time_local] '
                '"$request" $status $body_bytes_sent '
                '"$http_referer" "$http_user_agent" "$gzip_ratio" - $request_time';

6、Host重复配置

1
2
3

# proxy.conf文件
proxy_set_header        Host            $host;
proxy_set_header        X-Forwarded-For $proxy_add_x_forwarded_for;

1
2
3

include conf/proxy.conf; # proxy.conf文件中已经设置了Host字段值
proxy_set_header        Host            $host;
proxy_set_header        X-Forwarded-For $proxy_add_x_forwarded_for;

        注：两个proxy_set_header Host $host;语句，配置在同一个语句块中，不存在子语句块覆盖父语句块的情况：HTTP RFC2616

        可以存在具有相同字段名的多个消息头字段在消息中，当且仅当该标头的整个字段值字段被定义为以逗号分隔的列表。通过将每个后续字段值附加到第一个，每个用逗号分隔。因此代理不得改变转发时这些字段值的顺序 。

1
2
3
4

Cache-Control: no-cache
Cache-Control: no-store
# 相当于
Cache-Control: no-cache, no-store

由于Host字段值不允许以逗号分隔，nginx会报400状态码错误。

nginx中$host、$http_host和$proxy_host区别

  • $host是 request 请求过来的host，不管是域名还是IP，不管是否为80/443端口，值都为域名或者IP，不带端口
  • $http_host是request 请求过来的host，不管是域名还是IP，如果是非80/443端口，值都为域名或者IP加带端口，如果是非80/443端口，值都为域名或者IP
  • $proxy_host 是内部进行proxy转发配置的后端URL，$proxy_host值为配置的 proxy_pass的值的 域名或者IP部分

应用描述：

        前端应用域名为A（ww.a.com）, 后端服务域名为B（www.b.com）; 为了解决跨域问题，配置nginx反向代理如下：

...
proxy_set_header Host $host;
...
location ^~ /api/ {
    rewrite "^/api/(.*)$"  /$1 break;
    proxy_pass    http://www.b.com;
}

问题：

        配置反向代理时，这样配置完成后，接口报404问题。


解决：

  • 方案一：将proxy_set_header注释掉
  • 方案二：修改反向代理配置，设置请求头Host，如下所示：

location ^~ /api/ {
    rewrite "^/api/(.*)$"  /$1 break;
    proxy_pass    http://www.b.com;
    proxy_set_header Host $proxy_host;   //方式一：设置请求头host为www.b.com的ip和端口号
    proxy_set_header Host www.b.com;    //方式二：设置请求host为www.b.com
}

例子2

location /demo/ {
    proxy_pass http://ops.colinspace.com/;
}

则 proxy_host为 ops.colinspace.com;

如果配置如下

location /demo/ {
    proxy_pass http://192.168.3.108:8090/;
}

则 proxy_host为 192.168.3.108:8090;

然后我们再说 proxy_pass抓发的时候默认的Host为 $proxy_host, 在nginx官网有个解释：

By default, NGINX redefines two header fields in proxied requests, “Host” and “Connection”, and eliminates the header fields whose values are empty strings. “Host” is set to the $proxy_host variable, and “Connection” is set to close.

来源参考： https://docs.nginx.com/nginx/admin-guide/web-server/reverse-proxy/

问题分析和修正

其实通过上面的预备知识，现在我们很容易猜到问题所在。

对，问题的点就在于 proxy_pass 转发的时候 Host 变量的值不对。

对问题进行问题

1、我们可以在access_log 的输出中打印分别打印出来这三个变量的值，然后进行请求观察分析日志，

2、对比分析不同的域名下关于 proxy相关的配置，发现出问题的域名相比没有问题的域名引用了一个 proxy.conf 的公共配置，这个里面默认设置了

proxy_set_header Host $host

但是proxy转发的时候这个值应该为 $proxy_host 才对， 所以要么取消 对 proxy.conf 公共引用（不建议，因为历史添加肯定有原因）；要么采用如下方案在对应的location中进行添加

location /demo/ {
    proxy_set_host Host $proxy_host;
    # 或者也可以直接指定为转发的域名
    # proxy_set_host Host 'ops.colinspace.com'; 
    proxy_pass http://ops.colinspace.com/;
}

然后reload，再次请求验证，404 问题修正

例子3：反向代理配置：

1

2

3

4

5

6

7

8

9

10

11

12

server {

    listen 80;

    server_name mirrors.maqian.work;

    location / {

        proxy_pass http://mirrors.aliyun.com;

        proxy_redirect off;

        proxy_set_header Host $proxy_host;

        proxy_set_header X-Real-IP $remote_addr;

        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

    }

}

在浏览器访问mirrors.maqian.work时：

7 .参考：

关于nginx中的host变量
What's the difference of ​编辑http_host in Nginx

Nginx $host变量详解 - 简书

# nginx # 运维
Logo
乐奇 Rokid 开放社区

更多推荐

cover

极刻觅镜 | AI眼镜周报｜Rokid四款硬件发布与Android XR工具转稳定版

avatar 乐奇 Rokid 开放社区
cover

极刻觅镜 | AI眼镜日报｜北京发布七项消费举措、韩国高考排查AI眼镜

avatar 乐奇 Rokid 开放社区
cover

极刻觅镜 | AI眼镜日报｜京东智能眼镜西安站活动与千问AI眼镜OTA升级

avatar 乐奇 Rokid 开放社区