文章目录
- Nginx系列-Nginx Location匹配规则
- 1. 语法基础
- 2. 匹配规则
- 2.1 精确匹配(`=`)
- 2.2. 最长前缀匹配(`^~`)
- 2.3. 正则表达式匹配(`~`和`~*`)
- 2.4. 普通前缀匹配(无修饰符)
- 2.5. 默认匹配(`/`)
- 3. 注意事项
- 4. 常见的正则符号
Nginx系列-Nginx Location匹配规则
1. 语法基础
Nginx 的 location
指令的基本语法如下:
location [=|~|~*|^~|@] uri { ... }
=
表示精确匹配。~
表示区分大小写的正则匹配。~*
表示不区分大小写的正则匹配。^~
表示非正则匹配,如果该选项匹配,则不再进行正则匹配。( ^ 表示“非”,~ 表示“正则”,字符意思是:不会继续匹配正则)@
定义一个命名的 location,通常用于内部重定向。
2. 匹配规则
Nginx 对多个 location 的匹配遵循一定的规则和优先级。当 Nginx 收到一个请求时,它会按照以下顺序进行匹配
2.1 精确匹配(=
)
- 优先级最高。当请求的URI与
location
后面的字符串完全相同时,Nginx会选择这个location
块进行处理。(这个好理解,就是路径完全匹配,一模一样,优先级最高) - 示例:
只有当请求URI严格为location = /favicon.ico {# 处理/favicon.ico的请求 }
/favicon.ico
时,上述location
块才会被使用。
2.2. 最长前缀匹配(^~
)
- 以
^~
开头的location
表示最长前缀匹配。如果请求的URI以某个location
后面的字符串开头,并且这个字符串是最长的(或者使用了^~
修饰符),Nginx会选择这个location
块。但请注意,^~
修饰符实际上会停止后续的正则匹配搜索。(最长前缀匹配,意思就是以location后面的字符开始的且最长匹配,有的地方叫做非正则匹配,意思是满足了最长前缀匹配,就不会再匹配正则匹配了,也可以理解为即满足最长前缀匹配,也满足正则匹配,就匹配最长前缀匹配,也就是所说的最长前缀匹配优先级高于正则匹配,所谓的优先级是两者或多着都匹配的情况下,才会显现优先级) - 示例:
对于请求location ^~ /hello {return 601;}location ^~ /hellow {return 602;}location ^~ /hello/world {return 603;}location ~ /hello {return 604;}
/hello
,满足 601和 604,实际返回601,就是因为^~优先级高于正则匹配;
对于请求/hellow
,满足 601和 602,实际返回602,因为最长前缀匹配原则;
2.3. 正则表达式匹配(~
和~*
)
- 正则表达式匹配允许定义更复杂的URI匹配模式。
~
表示区分大小写的正则匹配,而~*
表示不区分大小写的正则匹配。 - Nginx会按照配置文件中的顺序逐个检查正则表达式
location
块,直到找到第一个匹配的块。因此,正则表达式的顺序很重要。 - 示例:
对于请求location ~ \.(gif|jpg|png)$ {# 处理以.gif、.jpg或.png结尾的请求(区分大小写) } location ~* \.(GIF|JPG|PNG)$ {# 处理以.GIF、.JPG或.PNG结尾的请求(不区分大小写) }
/images/photo.jpg
,第一个location
块将被匹配(如果请求是区分大小写的)。
2.4. 普通前缀匹配(无修饰符)
-
普通前缀匹配也按照配置文件中出现的先后顺序进行匹配,先出现的
location
指令优先匹配。 -
示例:
location /hello {return 601;}location /hellow {return 602;}
对于请求
/hellow
,满足 601和 602,实际返回602,证明满足长前缀匹配原则
再增加一项配置
```location ~ /hello[a-z] {return 603;}
```
对于请求/hellow
,满足 601、 602和603,实际返回603,证明正则匹配优先级高于普通匹配
2.5. 默认匹配(/
)
- 如果请求的URI与任何特定的
location
块都不匹配,Nginx将使用默认的location
块(如果有的话)。通常,默认的location
块是一个不带任何修饰符的location /
块。 - 示例:
location / {# 处理所有其他请求 }
综上所述
Nginx的location
匹配规则优先级可以总结为:
- 精确匹配(
=
) - 最长前缀匹配(
^~
),但会停止后续的正则匹配搜索 - 正则表达式匹配(
~
和~*
),按配置顺序 - 普通前缀匹配(无修饰符),也按配置顺序
- 默认匹配(
/
)
3. 注意事项
- 正则匹配与顺序:正则
location
的匹配顺序很重要,因为 Nginx 会按照配置文件中定义的顺序进行匹配。 proxy_pass
的路径替换:在配置proxy_pass
时,需要注意location
后面的 URI 是否包含斜杠(/
),这会影响请求的转发路径。通常建议location
和proxy_pass
要么都加斜杠,要么都不加。- 性能优化:将精确匹配放在前面,可以减少不必要的正则匹配,提高 Nginx 的处理效率。
4. 常见的正则符号
符号 | 描述 | 示例 |
---|---|---|
^ | 匹配字符串的开始位置 | ^http 匹配以"http"开头的字符串 |
$ | 匹配字符串的结束位置 | \.com$ 匹配以".com"结尾的字符串 |
. | 匹配除换行符以外的任意单个字符 | a.c 匹配"abc"、"a1c"等 |
* | 匹配前面的子表达式零次或多次 | ab*c 匹配"ac"、“abc”、"abbc"等 |
+ | 匹配前面的子表达式一次或多次 | ab+c 匹配"abc"、“abbc”、“abbbc"等,但不匹配"ac” |
? | 匹配前面的子表达式零次或一次 | ab?c 匹配"ac"、“abc” |
| | 或匹配模式,匹配左边的表达式或右边的表达式 | (jpg|gif|png) 匹配"jpg"、“gif"或"png” |
\ | 转义字符,用于匹配特殊字符 | \. 匹配"."字符本身 |
[ ] | 字符集合,匹配集合中的任意单个字符 | [a-z] 匹配任意小写字母 |
[^ ] | 反向字符集合,匹配不在集合中的任意单个字符 | [^a-z] 匹配任意非小写字母 |
{n} | n 是一个非负整数,匹配确定的 n 次 | o{2} 匹配"oo" |
{n,} | n 是一个非负整数,至少匹配 n 次 | o{2,} 匹配"oo"、“ooo”、"oooo"等 |
{n,m} | n 和 m 均为非负整数,其中n <= m,匹配至少 n 次,但不超过 m 次 | o{2,4} 匹配"oo"、“ooo”、“oooo” |