当前位置:

Ngnix中location与proxy_pass配置规则总结

本文最后更新于2019-11-17,已超过 1年没有更新,如果文章内容、图片或者下载资源失效,请留言反馈,我会及时处理,谢谢!

温馨提示:本文共2038个字,读完预计6分钟。

1.location匹配变量与配置格式

location配置用于匹配请求的URL,即ngnix中的$request_uri变量

$request_uri

location配置格式:

location [ 空格 | = | ~ | ~* |^~|!~ | !~* ] /uri/ {}


2.loacation匹配顺序
location 匹配格式规则前缀有四种:

= 开头,表示精确匹配
^~ 开头,注意这不是一个正则表达式–它的目的是优于正则表达式的匹配;如果该location是最佳匹配,则不再进行正则表达式检测。
~ 开头,表示区分大小写的正则匹配;
~* 开头,表示不区分大小写的正则匹配
!~ && !~*:表示区分大小写不匹配的正则和不区分大小写的不匹配的正则
location 如果不带前缀就是普通字符串匹配:
/uri/ 普通字符串匹配
/ 绝对路径根目录匹配, 如果没有其它匹配,任何请求都会匹配到

匹配的搜索顺序优先级为:

(location =) > (location 完整路径) > (location ^~ 路径) > (location ~,~* 正则顺序) > (location 部分起始路径) > (/)

首先匹配=

其次匹配^~

再其次按照配置文件的顺序进行正则匹配

最后是交给/进行通用匹配

注意:

当有匹配成功时,立刻停止匹配,按照当前匹配规则处理请求
特别注意:

优先搜索并不意味着优先命中!
字符串匹配优先搜索,但是只是记录下最长的匹配 ( 如果 ^~ 是最长的匹配,则会直接命中,停止搜索正则 ),然后继续搜索正则匹配,如果有正则匹配,则命中正则匹配,如果没有正则匹配,则命中最长的字符串匹配。
匹配模式及顺序举例:

location = /uri    =开头表示精确匹配,只有完全匹配上才能生效。
location ^~ /uri   ^~ 开头对URL路径进行前缀匹配,并且在正则之前。
location ~ pattern  ~开头表示区分大小写的正则匹配。
location ~* pattern  ~*开头表示不区分大小写的正则匹配。
location /uri     不带任何修饰符,也表示前缀匹配,但是在正则匹配之后,如果没有正则命中,命中最长的规则。
location /      通用匹配,任何未匹配到其它location的请求都会匹配到,相当于switch中的default。
3、location与proxy_pass代理规则
3.1 location是否以“/”结尾

在ngnix中location进行的是模糊匹配

没有“/”结尾时,location/abc/def可以匹配/abc/defghi请求,也可以匹配/abc/def/ghi等
而有“/”结尾时,location/abc/def/不能匹配/abc/defghi请求,只能匹配/abc/def/anything这样的请求
3.2 proxy_pass是否以“/”结尾

在nginx中配置proxy_pass时,当在后面的url加上了/,相当于是绝对路径,则nginx不会把location中匹配的路径部分加入代理uri;如果没有/,则会把匹配的路径部分加入代理uri。

请求域名为:http://127.0.0.1
 
 
location /apiA/ {
    # 结尾的/必须加上,否则跳转会失败
    proxy_pass http://127.0.0.2/;
}
 
这里的反向跳转等价于 http://127.0.0.1/apiA/作为一个整体 全部替换成http://127.0.0.2/
请求http://127.0.0.1/apiA/test.html 会被代理到http://127.0.0.2/test.html
 
 
location /apiB/ {
    # 结尾的/必须加上,否则跳转会失败
    proxy_pass http://127.0.0.2/apix/;
}
  
这里的反向跳转等价于 http://127.0.0.1/apiB/作为一个整体 全部替换成http://127.0.0.2/apix/
请求http://127.0.0.1/apiB/test.html 会被代理到http://127.0.0.2/apix/test.html

2.一些情况下,不能确定替换的URI

location里是正则表达式,这种情况下,proxy_pass里最好不要有URI
在proxy_pass前面用了rewrite,如下,这种情况下,proxy_pass是无效的:

location /name/ {
    rewrite    /name/([^/]+) /users?name=$1 break;
    # 结尾的/必须加上,否则跳转会失败
    proxy_pass http://127.0.0.1/;

————————————————
版权声明:本文为CSDN博主「比特币爱好者007」的原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接及本声明。
原文链接:https://blog.csdn.net/weixin_43343144/article/details/97770370

本文链接:,转发请注明来源!
评论已关闭。