nginx的location路径匹配规则
-
-
- 1、 语法
- 2、 语法说明
- 3、匹配规则（先后顺序）
- 4、测试示例
- 5、【uri】正则路径
- 5、路径替换
-
1、 语法
- [ = |~ | ~* | ^~ | @ ] /uri/ 注：uri是指匹配路径， [ =| ~ | ~* | ^~ | @ ] 是指匹配规则（可选）
location ^~/uri/{
...
}
location =/uri/{
...
}
...
2、 语法说明
- = : 完全匹配，表示精确匹配后面的url
- ^~ : 无正则普通匹配（ ^ 表示“非”，~ 表示“正则”，字符意思是：不会继续匹配正则），表示普通字符匹配，如果该选项匹配，只匹配该选项，不匹配别的选项，一般用来匹配目录
- / : 普通匹配（/xxx）
- ~ : 表示正则匹配，区分大小写
- ~* : 表示正则匹配，不区分大小写
- @ : “@” 定义一个命名的 location，使用在内部定向时，例如 error_page
3、匹配规则（先后顺序）
- = 前缀的指令严格匹配这个查询，优先级最高，一旦匹配成功，则停止搜索其他localtion的匹配项；
- 所有剩下的常规字符串（^~和普通匹配），‘最长命中’规则，优先使用匹配最长的结果。
- 正则表达式，在配置文件中定义的顺序
注： ^~ 和普通匹配。使用前缀匹配，不支持正则表达式，如果有多个location匹配成功的话，不会终止匹配过程，会记忆表达式最长的那个，如果得到的最长的location为 ^~ 类型，则表示阻断正则表达式，不再匹配正则表达式。如果得到的最长的location不是 ^~ 类型，继续匹配正则表达式，只要有一个正则成功，则使用这个正则的location，立即返回结果，并结束解析过程。
(1) 最长命中， ^~ 和普通命中，都是优先使用匹配最长的结果 ， 且 ^~ 优先级并不比普通匹配高
location ^~ /a {
root /;
}
location ^~ /aaa {
root /aaa;
}
- 请求url为/aaa，则上面两个location都匹配成功，但用于location ^~ /aaa较长，所以最终会以/aaa作为root。上例中如果是普通匹配（把location的 ^~ 去掉），结果也是一样的
location /test_1 {
return 400;
}
location ^~ /test {
return 401;
}
- 请求path为/test_1，则上面两个location都匹配成功，但用于location /test_1 较长,所以最终返回的是400，同时也可看出^~ 优先级并不比普通匹配高
(2) 得到的最长的location为 ^~ 类型，则表示阻断匹配不再继续，得到的最长的location不是 ^~ 类型，继续匹配
location /test_1 {
return 400;
}
location ^~ /test {
return 401;
}
location ~ /test {
return 402;
}
- 请求path为/test_1，返回的是402，此时^~和普通匹配只记住了最长一个location /test_1，不会阻止正则
- 请求path为/test，返回401，此时 ^~ 和普通匹配只记住了最长一个location ^~ /test，会阻止正则
(3) ~ 规则匹配，路径中只要包含就可以匹配，同时正则匹配时，放在前面的优先匹配，如果不区分大小写时，使用 ~*，因此在书写代理时尽量将精确匹配的放在前面
location ~ /hello {
return 602;
}
location ~ /helloworld {
return 601;
}
- 请求 localhost/world/helloworld 返回 602
- 请求 localhost/helloworld 返回 602
location ~ /helloworld {
return 601;
}
location ~ /hello {
return 602;
}
- 请求 localhost/world/helloworld 返回 601
- 请求 localhost/helloworld 返回 601
4、测试示例
location = /world {
return 600;
}
location = /hello {
return 601;
}
location ~ /hellowo {
return 602;
}
location ^~ /hello {
return 603;
}
- 请求 localhost/world 返回600 ：= 是精确完整匹配，且优先级最高
- 请求 localhost/hello 返回601 ：= 是精确完整匹配，且优先级最高
- 请求 localhost/hello/123 返回603：^~ 这个规则是前缀匹配，和 = 相比，范围更广，故该请求会被 ^~ 这个规则匹配上，但是 = 不会匹配
- 请求 localhost/hellow 返回603：如果 ~ 和 ^~ 同时匹配规则，则 ^~ 优先
- 请求 localhost/hellowo 返回603 ：如果 ~ 和 ^~ 同时匹配规则，则 ^~ 优先
- 请求 localhost/test/hellowo 返回602 ：~ 路径中只要包含就可以匹配
- 请求 localhost/test/hello 返回其他：^~ 这个规则是前缀匹配，不会匹配请求 url 中后面的路径，故该请求没有匹配上
- 请求 localhost/world2 localhost/test/world 返回其他
5、【uri】正则路径
这里主要填的是需要匹配的 path 路径，根据前面的符号，这里可以填写精确到 path 路径，也可以填正则表达式，下面则主要针对正则进行说明
- ： 匹配除换行符以外的任意字符
- ? ： 重复0次或1次
- ： 重复1次或更多次
- * ： 重复0次或更多次
- \d ：匹配数字
- ^ ： 匹配字符串的开始
- $ ： 匹配字符串的介绍
- {n} ： 重复n次
- {n,} ： 重复n次或更多次
- [c] ： 匹配单个字符c
- [a-z] ： 匹配a-z小写字母的任意一个
注：小括号()之间匹配的内容，可以在后面通过$1来引用，$2表示的是前面第二个()里的内容。正则里面容易让人困惑的是\转义特殊字符。
5、路径替换
- 配置proxy_pass时，可以实现url路径的部分替换。
- proxy_pass的目标地址，默认不带/，表示只代理域名，url和querystring部分不会变（把请求的path拼接到proxy_pass目标域名之后作为代理的url）
- 如果在目标地址后增加/，则表示把path中location匹配成功的部分剪切掉之后再拼接到proxy_pass目标地址
比如请求 /a/b.html
location /a {
proxy_pass http://server;
}
实际代理的目标url是http://server/a/b.html (把/a/b.html拼接到http://server之后)
location /a/ {
proxy_pass http://server/;
}
http://server/b.html (把/a/b.html的/a/去掉之后，拼接到http://server/之后)