匹配语法
匹配语法
[ = | ~ | ~* | ^~ | @ ] /uri/
解释：
- uri是指匹配路径
- [ = | ~ | ~* | ^~ | @ ] 是指匹配规则（可选）
基础示例
location ^~/uri/{
...
}
location =/uri/{
...
}
...
规则语法说明
- = : 完全匹配，表示精确匹配后面的url
- ^~ : 无正则普通匹配（ ^ 表示“非”，~ 表示“正则”，字符意思是：不会继续匹配正则），表示普通字符匹配，如果该选项匹配，只匹配该选项，不匹配别的选项，一般用来匹配目录
- / : 普通匹配（/xxx）
- ~ : 表示正则匹配，区分大小写
- ~* : 表示正则匹配，不区分大小写
- @ : “@” 定义一个命名的 location，使用在内部定向时，例如 error_page
Nginx匹配规则顺序
- = 前缀的指令严格匹配这个查询，优先级最高，一旦匹配成功，则停止搜索其他localtion的匹配项；
- 所有剩下的常规字符串（^~和普通匹配），‘最长命中’规则，优先使用匹配最长的结果。
- 正则表达式，在配置文件中定义的顺序
注： ^~ 和普通匹配。使用前缀匹配，不支持正则表达式，如果有多个location匹配成功的话，不会终止匹配过程，会记忆表达式最长的那个，如果得到的最长的location为 ^~ 类型，则表示阻断正则表达式，不再匹配正则表达式。如果得到的最长的location不是 ^~ 类型，继续匹配正则表达式，只要有一个正则成功，则使用这个正则的location，立即返回结果，并结束解析过程。
最长命中， ^~ 和普通命中，都是优先使用匹配最长的结果 ， 且 ^~ 优先级并不比普通匹配高
示例1：
location ^~ /a {
root /;
}
location ^~ /aaa {
root /aaa;
}
请求url为/aaa，则上面两个location都匹配成功，但用于location ^~ /aaa较长，所以最终会以/aaa作为root。上例中如果是普通匹配（把location的 ^~ 去掉），结果也是一样的
示例2：
location /test_1 {
return 400;
}
location ^~ /test {
return 401;
}
请求path为/test_1，则上面两个location都匹配成功，但用于location /test_1 较长,所以最终返回的是400，同时也可看出^~ 优先级并不比普通匹配高
示例3：
得到的最长的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，会阻止正则
示例4：
~ 规则匹配，路径中只要包含就可以匹配，同时正则匹配时，放在前面的优先匹配，如果不区分大小写时，使用 ~*，因此在书写代理时尽量将精确匹配的放在前面
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
示例5
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 返回其他
【uri】正则路径
这里主要填的是需要匹配的 path 路径，根据前面的符号，这里可以填写精确到 path 路径，也可以填正则表达式，下面则主要针对正则进行说明
- ： 匹配除换行符以外的任意字符
- ? ： 重复0次或1次
- + ： 重复1次或更多次
- * ： 重复0次或更多次
- \d ：匹配数字
- ^ ： 匹配字符串的开始
- $ ： 匹配字符串的介绍
- {n} ： 重复n次
- {n,} ： 重复n次或更多次
- [c] ： 匹配单个字符c
- [a-z] ： 匹配a-z小写字母的任意一个
注：小括号()之间匹配的内容，可以在后面通过$1来引用，$2表示的是前面第二个()里的内容。正则里面容易让人困惑的是\转义特殊字符。
Nginx 路径替换
- 配置proxy_pass时，可以实现URL路径的部分替换。
- proxy_pass的目标地址，默认不带/，表示只代理域名(ip+端口)，path和query部分不会变（把请求的path和query拼接到proxy_pass目标域名之后作为代理的URL）
- 如果在目标地址端口后有‘/’或者‘/xx/yy’等目录，则表示把path中location匹配成功的部分剪切掉之后再拼接到proxy_pass目标地址后面
比如请求 /a/b.html
示例1：
location /a {
proxy_pass http://server;
}
实际代理的目标url是http://server/a/b.html (把/a/b.html拼接到http://server之后)
示例2：
location /a/ {
proxy_pass http://server/;
}
http://server/b.html (把/a/b.html的/a/去掉之后，拼接到http://server/之后)
代理地址总结
- 第一，若proxy_pass代理地址端口后无任何字符，则转发后地址为：代理地址+访问的path（表格1的1、3行，端口后面没有字符，转发后的地址带着location匹配的部分）。
- 第二，若proxy_pass代理地址端口后有目录（包括"/"），则转发后地址为：代理地址+访问的path去除location匹配的路径（表格1的2、4行以及表格2，都是端口后面有/或目录，转发后的地址去除location匹配的部分）。
location后斜杆与proxy_pass后斜杆"/"问题
最好要么两者都加斜杆，要么都不加
以服务地址http://127.0.0.1:5053/api/test/getById进行说明，访问地址是http://127.0.0.1/api/test/getById。location后斜杆与proxy_pass后斜杆问题如下：
location、proxy_pass都不加斜杠，实际代理地址：http://127.0.0.1:5053/api/test/getById
location /api {
proxy_pass http://127.0.0.1:5053;
}
location加斜杠，proxy_pass不加斜杠，实际代理地址：http://127.0.0.1:5053/api/test/getById，【正确的】
location /api/ {
proxy_pass http://127.0.0.1:5053;
}
location不加斜杠，proxy_pass加斜杠，实际代理地址：http://127.0.0.1:5053//test/getById，【错误的】，也出现了双斜杠
location /api {
proxy_pass http://127.0.0.1:5053/;
}
location、proxy_pass都加斜杠，实际代理地址：http://127.0.0.1:5053/test/getById，【错误的】
location /api/ {
proxy_pass http://127.0.0.1:5053/;
}
location不加斜杠，proxy_pass加"api"，实际代理地址：http://127.0.0.1:5053/api/test/getById，【正确的】
location /api {
proxy_pass http://127.0.0.1:5053/api;
}
location加斜杠，proxy_pass加"api"，实际代理地址：http://127.0.0.1:5053/apitest/getById，【错误的】，少了一个斜杆
location /api/ {
proxy_pass http://127.0.0.1:5053/api;
}
location不加斜杠，proxy_pass加"api/"，实际代理地址：http://127.0.0.1:5053/api//test/getById，【错误的】出现双斜杠问题，后端在认证请求时会校验失败
location /api {
proxy_pass http://127.0.0.1:5053/api/;
}
location加斜杠，proxy_pass加"api/"，实际代理地址：http://127.0.0.1:5053/api/test/getById，【正确的】
location /api/ {
proxy_pass http://127.0.0.1:5053/api/;
}
https://blog.xqlee.com/article/2504181246151085.html
评论
相关文章
