Nginx location匹配规则说明 —— 筑梦之路

1. 语法规则说明

= 开头表示精确匹配；

^~ 开头表示uri以某个常规字符串开头，理解为匹配url路径即可(非正则)；

~ 开头表示区分大小写的正则匹配；

~* 开头表示不区分大小写的正则匹配；

!~和!~*分别为区分大小写不匹配及不区分大小写不匹配的正则；

/ 通用匹配，任何请求都会匹配到。

2. 优先级说明

等号类型（=）的优先级最高。一旦匹配成功，则不再查找其他location的匹配项；

^~和通用匹配。使用前缀匹配，不支持正则表达式，如果有多个location匹配成功的话，不会终止匹配过程，会匹配表达式最长的那个；

如果上一步得到的最长的location为^~类型，则表示阻断正则表达式，不再匹配正则表达式；

如果上一步得到的最长的location不是^~类型，继续匹配正则表达式，只要有一个正则成功，则使用这个正则的location，立即返回结果，并结束解析过程。

3. 配置示例说明

前置测试访问域名：www.test.com/api/upload

1)  location和proxy_pass都带/，则真实地址不带location匹配目录

location /api/ {
   proxy_pass http://127.0.0.1:8080/;
}

访问地址：www.test.com/api/upload --> http://127.0.0.1:8080/upload

2) location不带/，proxy_pass带/，则真实地址会带/

location /api {
   proxy_pass http://127.0.0.1:8080/;
}

访问地址：www.test.com/api/upload --> http://127.0.0.1:8080//upload


3) location带/，proxy_pass不带/，则真实地址会带location匹配目录/api/

location /api/ {
   proxy_pass http://127.0.0.1:8080;
}

访问地址：www.test.com/api/upload --> http://127.0.0.1:8080/api/upload

4) location和proxy_pass都不带/，则真实地址会带location匹配目录/api/

location /api {
   proxy_pass http://127.0.0.1:8080;
}

访问地址：www.test.com/api/upload --> http://127.0.0.1:8080/api/upload

5) 同1，但 proxy_pass带地址

location /api/ {
   proxy_pass http://127.0.0.1:8080/server/;
}

访问地址：www.test.com/api/upload --> http://127.0.0.1:8080/server/upload

6)  同2，但 proxy_pass带地址，则真实地址会多个/

location /api {
   proxy_pass http://127.0.0.1:8080/server/;
}

访问地址：www.test.com/api/upload --> http://127.0.0.1:8080/server//upload

7)  同3，但 proxy_pass带地址，则真实地址会直接连起来

location /api/ {
   proxy_pass http://127.0.0.1:8080/server;
}

访问地址：www.test.com/api/upload --> http://127.0.0.1:8080/serverupload

8) 同4，但 proxy_pass带地址，则真实地址匹配地址会替换location匹配目录

location /api {
   proxy_pass http://127.0.0.1:8080/server;
}

访问地址：www.test.com/api/upload --> http://127.0.0.1:8080/server/upload



1）proxy_pass代理地址端口后有目录(包括 / )，转发后地址：代理地址+访问URL目录部分去除location匹配目录；

2）proxy_pass代理地址端口后无任何，转发后地址：代理地址+访问URL目录部。

4. 小结

1）proxy_pass最后有斜线时(即端口后只有斜线,例如A和B中的proxy_pass)，location最后有斜线时，最终组成的url:proxy_pass + location最后一个斜线以后的部分

2）proxy_pass最后有斜线时(即端口后只有斜线,例如A和B中的proxy_pass)，location最后无斜线时，最终组成的url:proxy_pass + 斜线 + location后面的所有部分(但不包含location后面的所有部分的第一个斜线) //其实就是比1多个斜线

3）proxy_pass最后无斜线时，location最后有斜线时，最终组成的url:proxy_pass + location + 请求url中location以后的所有部分(不包含第一个/)

4）proxy_pass最后无斜线时，location最后无斜线时，最终组成的url:proxy_pass + location + “/” + 请求url中location以后的所有部分(不包含第一个/)

5）proxy_pass最后有斜线时(且已经包含了至少一级目录,例如E和F中的proxy_pass)，location 最后有斜线时，最终组成的url:proxy_pass + location以后的所有部分(但不包含第一个/)

6）proxy_pass最后有斜线时(且已经包含了至少一级目录,例如E和F中的proxy_pass)，location最后无斜线时，最终组成的url:proxy_pass + “/” + location以后的所有部分(包含第一个/)

7）proxy_pass最后无斜线时(且包含了至少一级目录,例如G和H中的proxy_pass)，location最后有斜线时，最终组成的url:proxy_pass + location以后的所有部分(不包含第一个/)

8）proxy_pass最后无斜线时(且包含了至少一级目录,例如G和H中的proxy_pass)，location最后无斜线时，最终组成的url:proxy_pass + location以后的所有部分(包含第一个/)

示例：

nginx 服务器及端口 127.0.0.1:80

后端服务:127.0.0.1:8080

测试url:http://127.0.0.1:80/weijishu/api/abc

A.配置

nginx配置如下：

location /weijishu/ {
   proxy_pass http://127.0.0.1:8080/;
}
实际访问的端口服务：http://127.0.0.1:8080/api/abc

B.配置

location /weijishu {
   proxy_pass http://127.0.0.1:8080/;
}
实际访问的端口服务：http://127.0.0.1:8080//api/abc

C.配置

location /weijishu/ {
   proxy_pass http://127.0.0.1:8080;
}
实际访问的端口服务：http://127.0.0.1:8080/weijishu/api/abc

D.配置

location /weijishu {
   proxy_pass http://127.0.0.1:8080;
}
实际访问的端口服务：http://127.0.0.1:8080/weijishu/api/abc

E.配置

location /weijishu/ {
   proxy_pass http://127.0.0.1:8080/server/;
}
实际访问的端口服务：http://127.0.0.1:8080/server/api/abc

F.配置

location /weijishu {
   proxy_pass http://127.0.0.1:8080/server/;
}
实际访问的端口服务：http://127.0.0.1:8080/server//api/abc

G.配置

location /weijishu/ {
   proxy_pass http://127.0.0.1:8080/server;
}
实际访问的端口服务：http://127.0.0.1:8080/serverapi/abc

H.配置

location /weijishu {
   proxy_pass http://127.0.0.1:8080/server;
}
实际访问的端口服务：http://127.0.0.1:8080/server/api/abc

root  alias区别：

1）alias指定的目录是准确的，即location匹配访问的path目录下的文件直接是在alias目录下查找的；

2）root指定的目录是location匹配访问的path目录的上一级目录,这个path目录一定要是真实存在root指定目录下的。

proxy_pass不加任何东西，则地址转向代理地址+访问的url目录，如果proxy_pass加了或者是其他路径，则跳转地址为代理地址+访问url去掉locaion部分。