关于nginx中proxy_set_header的设置

 

Seven7707 2018-09-05 16:53:40  73417  收藏 16

分类专栏： nginx

 

版权声明：本文为博主原创文章，未经博主允许不得转载。 https://blog.csdn.net/felix_yujing/article/details/51682655

昨天一个开发找我帮忙配置一个nginx的转发，本来很容易的配置，但是坑了我好久才解决。。。需求大致是：

nginx上配有aaa.example.com的虚拟主机，现在需要将访问http://aaa.example.com/api/x.x/client/的请求转到http://bbb.example.com/api/x.x/client/，bbb.example.com的虚拟主机在另外一台nginx上，其中x.x表示位数不定的版本号，如：1.0或1.20.345都可能。请求转过去要求url保持不变

用rewrite转发的话，url会发生变化的，那就用proxy_pass吧，于是添加了如下的配置：

1.  
   location ~ ^/api/([0-9]+)(.[0-9]+)*/client/ {
2.  
   proxy_pass http://bbb.example.com;
3.  
   }

• 1
• 2
• 3

在现有环境的nginx里添加这段配置之后，访问却始终转不过去，查看nginx日志也只能看到是404信息，并没有更多定位问题的信息。检查了许久也没找到原因，于是重新装了一台新nginx，里面只加上面这段配置，结果nginx是能够转发成功的，这说明单独来看这条location的配置是没有问题的，很有可能是现有环境nginx里的某些配置影响到了这个转发。 
为了定位问题原因，我将aaa.example.com虚拟主机下的其他配置注意注释掉来调试，最后发现当注释掉proxy_set_header Host $http_host ;这条配置之后，就能成功转发了。这才注意到是反向代理配置的问题。现有环境中原有的配置也不能随便删掉，上网查了下原因，找到下面这种解决方案：

1.  
   location ~ ^/api/([0-9]+)(.[0-9]+)*/client/ {
2.  
   proxy_pass http://bbb.example.com;
3.  
   proxy_set_header Host $proxy_host;
4.  
   }

• 1
• 2
• 3
• 4

即，在location里面添加一条proxy_set_header Host $proxy_host;配置。当Host设置为$http_host时，则不改变请求头的值，所以当要转发到bbb.example.com的时候，请求头还是aaa.example.com的Host信息，就会有问题；当Host设置为$proxy_host时，则会重新设置请求头为bbb.example.com的Host信息。

另外，关于proxy_pass转发url的参数，可以通过在location中用rewrite来做，所以完善后的配置如下：

1.  
   location ~ ^/api/([0-9]+)(.[0-9]+)*/client/ {
2.  
   rewrite /(.*)$ /$1 break;
3.  
   proxy_pass http://bbb.example.com;
4.  
   proxy_set_header Host $proxy_host;
5.  
   }

• 1
• 2
• 3
• 4
• 5

在location用rewrite改变了URI之后，proxy_pass将使用改变后的URI。上面例子(.*)是将所有参数传给$1，转发时/$1会拼接在http://bbb.example.com后面。

补习

自己之前并没有太留意nginx中proxy_set_header的设置，借这次遇到的问题，补习下功课。

proxy_set_header用来重定义发往后端服务器的请求头。

语法格式： 
proxy_set_header Field Value;

Value值可以是包含文本、变量或者它们的组合。常见的设置如： 
proxy_set_header Host $proxy_host; 
proxy_set_header X-Real-IP $remote_addr; 
proxy_set_header X-Forwarded-For $remote_addr;

注意：在nginx的配置文件中，如果当前模块中没有proxy_set_header的设置，则会从上级别继承配置。继承顺序为：http, server, location。