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