举杯邀月

nginx 的 location 配置,匹配规则、匹配顺序及例子展示

摘要:location 是 nginx的一个重要组成部分,所以在配置的时经常使用到。它的作用是根据用户请求的URI来执行不同的应用,也就是根据用户请求的网站URL进行匹配,匹配成功即进行相关的操作。今天整理了一些常用的规则方便于理解和学习。

语法规则

location [=|~|~*|^~] /uri/ {
    …
}
1
2
3
1
2
3
1
2
3
1
2
3
1
2
3
1
2
3
1
2
3
1
2
3
1
2
3
1
2
3

= 表示精确匹配,这个优先级也是最高的
^~ 表示 uri 以某个常规字符串开头,理解为匹配 url 路径即可。
~ 表示区分大小写的正则匹配
~* 表示不区分大小写的正则匹配(和上面的唯一区别就是大小写)
!~* 表示区分大小写不匹配
表示不区分大小写不匹配的正则
/ 通用匹配,任何请求都会匹配到,默认匹配

规则和优先级

多个 location 配置的情况下匹配顺序为(仅限参考):

优先级 = > ^~
首先匹配 =,其次匹配^~, 其次是按文件中顺序的正则匹配,最后是交给 / 通用匹配。当有匹配成功时候,停止匹配,按当前匹配规则处理请求。

例:配置文件为:

location / {
    echo "/";   # 需要安装 echo 模块才行,这边大家可以改成各自的规则
}
location = / {
    echo "=/";
}
location = /nginx {
    echo "=/nginx";
}
location ~ \.(gif|jpg|png|js|css)$ {
    echo "small-gif/jpg/png";
}
location ~* \.png$ {
    echo "all-png";
}
location ^~ /static/ {
    echo "static";
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

以下是各种的访问情况

访问:curl http://a.ttlsa.com/
结果:=/
因为 / 是完全匹配的

访问:curl http://a.ttlsa.com/nginx
结果:=/nginx
因为完全匹配了 =/nginx

访问:curl http://a.ttlsa.com/xxx/1111.PNG
结果:all-png
从第一个开始尝试匹配,最后匹配到了~* .png$

访问:http://a.ttlsa.com/static/1111.png
结果:Static
虽然 static 放在最后面,但是因为有^的缘故,他是最匹配的.

好了,最后给出我们线上环境的静态文件的匹配规则

location ~* .*\.(js|css)?$
{
    expires 7d;       # 7 天过期,后续讲解
    access_log off;   # 不保存日志
}
location ~* .*\.(png|jpg|gif|jpeg|bmp|ico)?$
{
    expires 7d;
    access_log off;
}
location ~* .*\.(zip|rar|exe|msi|iso|gho|mp3|rmvb|mp4|wma|wmv|rm)?$
{
    deny all;          # 禁止这些文件下载,大家可以根据自己的环境来配置
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
1
2
3
4
5
6
7
8
9
10
11
12
13
14
1
2
3
4
5
6
7
8
9
10
11
12
13
14
1
2
3
4
5
6
7
8
9
10
11
12
13
14
1
2
3
4
5
6
7
8
9
10
11
12
13
14
1
2
3
4
5
6
7
8
9
10
11
12
13
14
1
2
3
4
5
6
7
8
9
10
11
12
13
14
1
2
3
4
5
6
7
8
9
10
11
12
13
14
1
2
3
4
5
6
7
8
9
10
11
12
13
14
1
2
3
4
5
6
7
8
9
10
11
12
13
14

作者:举杯邀月

出处: http://www.hug-code.cn/archives/5fca04d3971d2.html

2020-09-04 标签: nginx