【非常经典的总结】 Ngnix中location与proxy_pass配置规则总结

￡神魔★判官ぃ 2021-09-30 09:34 298阅读 0赞

**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/;
    }