Description of Nginx location matching rules - the road to dream building

1. Description of Grammar Rules

= 开头表示精确匹配；

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

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

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

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

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

2. Description of priority

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

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

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

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

3. Configuration example description

前置测试访问域名：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目录部。