白日依山尽,黄河入海流。欲穷千里目,更上一层楼。 -- 唐·王之涣

nginx配置proxy_pass之后返回404问题及Nginx host相关变量说明

预备知识

这里我们先了解Nginx中host相关的变量($host/$http_host/$proxy_host) ,有助于我们理解和解决 proxy_pass 404问题。

  • $host request 请求过来的host,不管是域名还是IP,不管是否为80/443端口,值都为域名或者IP,不带端口

  • $http_host request 请求过来的host,不管是域名还是IP,如果是非80/443端口,值都为域名或者IP加带端口,如果是非80/443端口,值都为域名或者IP

  • proxy_host 内部进行proxy配置转发的时候默认配置的Host为 $proxy_host, 值为配置的 proxy_pass的值的 域名或者IP部分

比如

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

则 proxy_host为 ops.colinspace.com;

如果配置如下

1
2
3
location /demo/ {
proxy_pass http://192.168.3.108:8090/;
}

则 proxy_host为 192.168.3.108:8090;

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

1
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 的公共配置,这个里面默认设置了

1
proxy_set_header Host $host

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

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

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

问题扩展

为什么请求的时候Header中需要带一个Host配置项呢?

这里就先不给出结论了,大家可以评论区留言讨论

作者

Colin

发布于

2022-06-30

许可协议