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部分。