Nginx Location配置是Nginx的核心配置,location 指令用于匹配请求的 URL 路径,并定义该路径下的特定配置。location 配置块允许你根据不同的 URL 路径指定不同的处理方式,例如代理到后端服务器、返回静态文件、重定向等。
URL匹配方式及优先级
匹配符 | 匹配规则 | 优先级 |
---|---|---|
= | 精确匹配 | 1 |
^~ | 以某个字符串开头 | 2 |
~ | 区分大小写的正则匹配 | 3 |
~* | 不区分大小写的正则匹配 | 4 |
!~ | 区分大小写的不匹配正则 | 5 |
!~* | 不区分大小写的不匹配正则 | 6 |
/ | 通用匹配,任何请求都会匹配到 | 7 |
关于 Location,举个简单的配置例子:
http {
server {
listen 80;
server_name www.yayujs.com;
location / {
root /home/www/ts/;
index index.html;
}
}
}
大致的意思是,当你访问 www.yayujs.com 的 80 端口的时候,返回 /home/www/ts/index.html 文件。
我们看下 Location 的具体语法:
location [ = | ~ | ~* | ^~ ] uri { ... }
重点看方括号中的 [ = | ~ | ~* | ^~ ],其中 | 分隔的内容表示你可能会用到的语法,其中:
= 表示精确匹配,比如:
location = /test {
return 200 "hello";
}
# /test ok
# /test/ not ok
# /test2 not ok
# /test/2 not ok
~ 表示区分大小写的正则匹配,比如:
location ~ ^/test$ {
[ configuration ]
}
# /test ok
# /Test not ok
# /test/ not ok
# /test2 not ok
~* 表示不区分大小写的正则匹配
location ~* ^/test$ {
[ configuration ]
}
# /test ok
# /Test ok
# /test/ not ok
# /test2 not ok
^~ 表示 uri 以某个字符串开头
location ^~ /images/ {
[ configuration ]
}
# /images/1.gif ok
而当你不使用这些语法的时候,只写 uri 的时候:
/ 表示通用匹配:
location / {
[ configuration ]
}
# /index.html ok
location /test {
[ configuration ]
}
# /test ok
# /test2 ok
# /test/ ok
匹配顺序
当存在多个 location 的时候,他们的匹配顺序分为两种:
1.前缀字符串(prefix string)
2.正则表达式(regular expression),具体为前面带 ~* 和 ~ 修饰符的
而匹配 location 的顺序为:
1.首先,Nginx 会尝试精确匹配(例如 /path)。
2.如果没有精确匹配,Nginx 将尝试前缀匹配(例如 /static)。
3.如果没有前缀匹配,Nginx 将按照配置文件中定义的顺序尝试正则表达式匹配。
4.如果没有匹配到任何 location 配置块,Nginx 将使用默认的 location 块,如 location /。
除了 location 配置块中的一般指令外,还可以使用一些特殊的指令,如 proxy_pass(代理到后端服务器)、try_files(尝试查找文件)、rewrite(重写 URL)等。
server {
location /doc {
[ configuration A ]
}
location /docu {
[ configuration B ]
}
}
# 请求 /document 使用 configuration B
# 虽然 /doc 也能匹配到,但在顺序上,前缀字符串顺序不重要,按照匹配长度来确定
server {
location ~ ^/doc {
[ configuration A ]
}
location ~ ^/docu {
[ configuration B ]
}
}
# 请求 /document 使用 configuration A
# 虽然 ~ ^/docu 也能匹配到,但正则表达式则按照定义顺序
server {
location ^~ /doc {
[ configuration A ]
}
location ~ ^/docu {
[ configuration B ]
}
}
# 请求 /document 使用 configuration A
# 虽然 ~ ^/docu 也能匹配到,但 ^~ 的优先级更高
server {
location /document {
[ configuration A ]
}
location ~ ^/docu {
[ configuration B ]
}
}
# 请求 /document 使用 configuration B
# 虽然 /document 也能匹配到,但正则的优先级更高
root 与 alias 的区别
当我们这样设置 root 的时候:
location /i/ {
root /data/w3;
}
当请求 /i/top.gif ,/data/w3/i/top.gif 会被返回。
当我们这样设置 alias 的时候:
location /i/ {
alias /data/w3/images/;
}
当请求 /i/top.gif ,/data/w3/images/top.gif 会被返回。
root对路径的处理:root路径 + location路径
alias对路径的处理:使用alias路径替换location路径
所以如果你这样使用 allias 定义一个路径:
location /images/ {
alias /data/w3/images/;
}
其实使用 root 会更好:
location /images/ {
root /data/w3;
}
server 和 location 中的 root
server 和 location 中都可以使用 root,举个例子:
http {
server {
listen 80;
server_name www.yayujs.com;
root /home/www/website/;
location / {
root /home/www/ts/;
index index.html;
}
}
}
如果两者都出现,是怎样的优先级呢?
简单的来说,就是就近原则,如果 location 中能匹配到,就是用 location 中的 root 配置,忽略 server 中的 root,当 location 中匹配不到的时候,则使用 server 中的 root 配置。
参考链接:https://juejin.cn/post/7048952689601806366