nginx proxy_pass转发规则解读

 更新时间:2024年01月23日 10:05:11   作者:shuxiaohua  
这篇文章主要介绍了nginx proxy_pass转发规则,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教

综述

nginx官方网站讲解proxy_pass时,只给了规则的说明,并没有给出具体的示例辅助理解。

对于英语不太好的人,理解起来真的很头痛,只能通过测试来验证对英文意思的猜测。

nginx对proxy_pass的官方说明见http://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_pass

其将proxy_pass的转发规则分为3类:

  • location为简单配置(非正则表达式),proxy_pass的url带path路径
  • location为简单配置(非正则表达式),proxy_pass的url不带path路径
  • nginx无法确认url的替换规则

url中带path路径

判断条件

如果域名后面带了“/”,则认为是url中带了path路径。比如:

  • proxy_pass http://127.0.0.1/
  • proxy_pass http://127.0.0.1/aaa
  • proxy_pass http://127.0.0.1/aaa/

转发规则

nginx官网原文如下:

If the proxy_pass directive is specified with a URI, then when a request is passed to the server, the part of a normalized request URI matching the location is replaced by a URI specified in the directive:

location /name/ {
proxy_pass http://127.0.0.1/remote/;
}

个人理解如下:

使用proxy_pass配置的url去替换location指定的部分。

如下图就是使用http://127.0.0.1/remote/去替换path中/name/这一段

url中不带path路径

判断条件

与第一点相反,proxy_pass指定url中只有域名,比如ttp://127.0.0.1

转发规则

If proxy_pass is specified without a URI, the request URI is passed to the server in the same form as sent by a client when the original request is processed, or the full normalized request URI is passed when processing the changed URI:

location /some/path/ {
proxy_pass http://127.0.0.1;
}

个人理解如下:

转发url=proxy_pass配置的url+原始url中path部分

nginx无法确认url的替换规则

这种场景nginx又细分成3类

location指定的是正则表达式

nginx官方要求配置proxy_pass时,不能带path路径。

When location is specified using a regular expression, and also inside named locations.
In these cases, proxy_pass should be specified without a URI.

path路径在location中使用rewrite重写了

比如

location /name/ {
rewrite /name/([^/]+) /users?name=$1 break;
proxy_pass http://127.0.0.1/test;
}

In this case, the URI specified in the directive is ignored and the full changed request URI is passed to the server.

这种场景,nginx会忽略proxy_pass中配置的path路径,然后使用proxy_pass中指定的域名加上rewrite中指定的path路径即为转发后的url。

proxy_pass配置的url中带变量

比如

location /name/ {
proxy_pass http://127.0.0.1$request_uri;
}

In this case, if URI is specified in the directive, it is passed to the server as is, replacing the original request URI.

这种场景,如果proxy_pass配置的url经过变量转换后带path路径,则直接使用该url。

其他

实际上,“nginx无法确认url的替换规则”3个细分类可能存在交叉的地方,这个nginx没有提到,大家只能动手自己去测试nginx的混合场景的规则了。

比如我们系统后端服务是没有context-path的,后面为了容器化需要添加context-path,详细背景见之前的博客。

为了对前端屏蔽变化,因此需要修改nginx的转发规则。

如下图所示,这样就涉及到“location指定的是正则表达式”和“proxy_pass配置的url中带变量”混合场景了。

If the location is given by regular expression, can not be a URI part in proxy_pass directive, unless there are variables in the directive

如果location使用正则表达式,proxy_pass中不能指定path,除非proxy_pass中包含变量。

补充说明

当时分析nginx转发规则,是为了解决转发时,url增加公共前缀,当时不理解为啥在正则表达场景下不能通过在proxy_pass中配置公共前缀,达到增加公共前缀的目的(像简单模式那样,使用proxy_pass替换掉url中正则表达式匹配上的那部分)。

后面在定位我们灰度分流配置时,顿悟nginx转发规则这样设计的目的。

我们需要通过url中的租户id进行分流,nginx配置如下

    location ~ /tenants/(租户id)/ {
        proxy_pass https://$gray;
    }
    location ~ / {
        proxy_pass https://$production;
    }

当时第一眼看到这个配置时,感觉灰度分流不会生效,只会走正式边。因为我们的url是/api/tenants开头,location配置中少了“/api”,结果测试发现分流正常。

初步分析,nignx中的正则表达式与我们自己写代表中的正则表达一样,它是对整个url进行匹配。

并不像普通模式那样从url起始位置开始进行匹配(当然如果需要从起始位置开始匹配,也可以通过指定"^")。

因此正则表达式匹配上的部分,可能是url中间的一部分,这样就不好实用proxy_pass替换掉location中指定的部分。

所以nignx要求,正则表达式场景下,配置proxy_pass时不能带path路径,除非proxy_pass指定的就是完整的url,这样nginx要么直接使用proxy_pass中指定的url,要么使用原始url中的path+proxy_pass中指定的域名。

proxy_pass中包含变量后,nginx这认为你指定了完整的url,因此交叉场景下,proxy_pass包含变量优先级更高。

淌坑指导-no resolver defined to resolve

当proxy_pass指定的url中带变量时,必须指定resolver。

具体解释见https://stackoverflow.com/questions/17685674/nginx-proxy-pass-with-remote-addr(这个解释也没给出细节,nginx官方也没给出具体解释)

比如:

set $originaddr http://origin.example.com;
proxy_pass $originaddr;

或者

proxy_pass http://origin.example.com$request_uri;

可以在server层级指定resolver,比如

server {
    resolver xx.xx.xx.xx;
     … …
}

具体resolver配置那个IP,可以查看系统默认配置的DNS服务器- cat /etc/resolv.conf

趟坑指导-“proxy_set_header Host $proxy_host”

背景同上

我们要将服务由虚拟机迁到公司的docker部署平台,这样可以自动部署,监控扩容啥的也更方便。

我们服务很多,nginx上面配置了很多转发规则,为了对前端屏蔽后端的组网变化,我们保留了nginx,通过nginx转发到ALB(docker通过ALB对外暴露服务)。

服务上了docker后,url要增加前缀(见背景文章),因此nginx转发规则要统一给转发后的url增加公共前缀,配置方式见上述“其他”章节。

配置后发现仍然报404(直接访问ALB是ok的)。

问题排查思路如下:

1.确认转发后的url是不是如自己期望的那样

首先想通过nginx日志打印转发后的规则,没有发现合适的参数;因此通过tcpdump工具dump报文,发现转发后的url正确,但是请求头中的Host并不是ALB对外暴露的域名,而是我们Nignx自己的域名,因此怀疑ALB的路由规则中会包含对域名的检测。(ALB也是一台Nginx,Nignx可以通过server_name将转发规则绑定到特定的域名,或者说给不同的域名指定不同的路由规则)。

2.google如何修改Host头,找到配置项"proxy_set_header Host $proxy_host",配置后验证ok。

总结

以上为个人经验,希望能给大家一个参考,也希望大家多多支持脚本之家。

相关文章

  • Nginx实现404页面的配置方法的两种方法

    Nginx实现404页面的配置方法的两种方法

    在使用Nginx作为Web服务器时,配置404页面是一项基本需求,本文介绍了两种配置404页面的方法,这两种方法各有特点,可以根据实际需求选择适合的配置方式
    2024-09-09
  • Nginx禁止国外IP访问我的网站的实现

    Nginx禁止国外IP访问我的网站的实现

    本文主要介绍了Nginx禁止国外IP访问我的网站的实现,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2023-07-07
  • nginx限制IP恶意调用短信接口处理方法

    nginx限制IP恶意调用短信接口处理方法

    这篇文章主要介绍了nginx限制IP恶意调用短信接口处理方法,一种是nginx黑名单方式,另一种是限制IP请求数。需要的朋友可以参考下
    2018-06-06
  • 详解Nginx反向代理实现Kibana登录认证功能

    详解Nginx反向代理实现Kibana登录认证功能

    这篇文章主要介绍了详解Nginx反向代理实现Kibana登录认证功能,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-06-06
  • nginx中proxy_pass各种用法详解

    nginx中proxy_pass各种用法详解

    nginx中配置location代理转发规则的时候不同写法对应不同转发规则。本文就介绍几种常见的匹配情况,感兴趣的可以了解一下
    2021-11-11
  • nginx泛域名解析配置教程

    nginx泛域名解析配置教程

    这篇文章主要介绍了nginx泛域名解析配置教程,需要的朋友可以参考下
    2017-01-01
  • 一文了解nginx HTTP安全响应问题

    一文了解nginx HTTP安全响应问题

    一些网站系统会经常遭到各类XSS攻击、点劫持等,从而造成重要信息的泄露以及服务器安全问题,本文就来介绍一下,感兴趣的可以了解一下
    2023-11-11
  • nginx 基本配置与参数说明详细介绍

    nginx 基本配置与参数说明详细介绍

    这篇文章主要介绍了nginx 基本配置与参数说明详细介绍的相关资料,需要的朋友可以参考下
    2016-10-10
  • Ubuntu 22.04.1 LTS 编译安装 nginx-1.22.1的配置过程

    Ubuntu 22.04.1 LTS 编译安装 nginx-1.22.1的配置过程

    Ubuntu安装Nginx有两种方式,一种是通过命令的方式,这种方式安装的Nginx版本低,之前漏扫扫出来Nginx版本低,需要升级所以现在用编译的方式安装版本高点的,本文介绍Ubuntu22.04.1 LTS编译安装nginx1.22.1的配置过程,本文给大家介绍的非常详细,需要的朋友参考下吧
    2024-01-01
  • Nginx的基本概念和原理

    Nginx的基本概念和原理

    这篇文章主要介绍了Nginx的基本概念和原理,Nginx专为性能优化而开发,性能是器最重要的考量,实现上非常注重效率,能经受高负载的考验,据报告能支持高达50,000个并发连接数。下文我们就来看看Nginx概念和原理,需要的小伙伴可以参考一下
    2022-03-03

最新评论