location配置详解
# 前言
location 是我们日常配置中用的最多的,其中各种模式各种优先级问题在此好好梳理一番。
location [ = | ~ | ~* | ^~ ] uri { ... }
location @name* { ... }
1
2
2
# 支持的模式
=
开头表示精确匹配^~
开头**,注意这不是一个正则表达式(是提升优先级的字符串匹配)**–它的目的是优先于正则表达式的匹配。如果该location是最佳匹配,则不再进行正则表达式检测。~
开头表示区分大小写的正则匹配;~*
开头表示不区分大小写的正则匹配!~
&&!~*
:表示区分大小写不匹配的正则和不区分大小写的不匹配的正则- 字符串匹配
/
通用匹配, 如果没有其它匹配,任何请求都会匹配到
# 优先级
- 首先精确匹配
=
- 其次匹配
^~
- 其次按照配置文件的顺序进行正则匹配
- 其次字符串最长匹配的
- 最后是交给
/
进行通用匹配
当有匹配成功时,立刻停止匹配,按照当前匹配规则处理请求。
字符串匹配优先搜索,但是只是记录下最长的匹配 ,然后继续搜索正则匹配,如果有正则匹配,则命中正则匹配,如果没有正则匹配,则命中最长的字符串匹配。 ( 如果 ^~ 是最长的匹配,则会直接命中,停止搜索正则 )
# 案例
# 精确匹配
# 正常情况
location = /images/test.png {
echo 'config1';
}
location /images/test.png {
echo 'config2';
}
location \/images\/test\.png$ {
echo 'config3';
}
1
2
3
4
5
6
7
8
9
10
11
2
3
4
5
6
7
8
9
10
11
输出 config1, 毋容置疑,精确匹配优先级最高!
curl http://127.0.0.1/images/test.png
-------
config1
1
2
3
2
3
# 特殊情况
location = / {
index index.html;
}
location / {
echo 'config2';
}
1
2
3
4
5
6
7
2
3
4
5
6
7
最终输出 config2,因为 = / 被映射到了目录,所以最终的路径为 /index.html,这个再去匹配就匹配到 config2 那个了。
curl http://127.0.0.1
-------
config2
1
2
3
2
3
# 正则与字符串
location /images/test.png {
echo 'config1';
}
location ~ \/images\/test\.png$ {
echo 'config3';
}
location ^~ /images/ {
echo 'config2';
}
location ~ \/images\/ {
echo 'config4';
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
2
3
4
5
6
7
8
9
10
11
12
13
14
15
常规字符串匹配与正则优先级测试
curl http://127.0.0.1/images/test.png
-------
config3
1
2
3
2
3
加上 ^~
的与正则
curl http://127.0.0.1/images/
-------
config2
1
2
3
2
3
在 GitHub 编辑此页 (opens new window)
上次更新: 2024/02/25, 12:11:11