Nginx中Location配置超详细讲解

一、语法

Location 是 Nginx 中一个非常核心的配置,关于Location,举个简单的配置例子:

server {
 listen 80;
 server_name 10.0.7.115;
 location / {
 root /data/app/;
 index index.html;
 }
}

当访问 http://10.0.7.115:80 的时候,返回的是 /data/app/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

/ 表示通用匹配:

location / { 
 [configuration] 
}

例如:

/index.html ok
location /test {
 [configuration] 
}

例如:

/test ok
/test2 ok
/test/ ok

二、匹配顺序

Location的定义分为两种:

  • 前缀字符串(prefix string)
  • 正则表达式(regular expression),具体为前面带 ~* 和 ~ 修饰符

当存在多个 Location 的时候,匹配的顺序为:

检查使用前缀字符串的 locations,在使用前缀字符串的 locations 中选择最长匹配的,并将结果进行储存;

  • 如果符合带有 = 修饰符的URI,则立刻停止匹配;
  • 如果符合带有 ^~ 修饰符的URI,则也立刻停止匹配;
  • 然后按照定义文件的顺序,检查正则表达式,匹配到就停止;
  • 当正则表达式匹配不到的时候,使用之前储存的前缀字符串;

总结:

在顺序上:

  • 前缀字符串顺序不重要,按照匹配长度来确定;
  • 正则表达式则按照定义顺序;

在 优先级上:

  • = 修饰符最高,^~ 次之,再者是正则,最后是前缀字符串匹配。

我们举几个简单的例子进行说明

请求URI如下:

/document

示例一:

配置:

server {
 location /doc {
 [ configuration A ] 
 }
 location /docu {
 [ configuration B ] 
 }
}

匹配结果:

configuration B

注:虽然 /doc 也能匹配到,但 在顺序上,前缀字符串顺序不重要,按照匹配长度来确定。

示例二:

server {
 location ~ ^/doc {
 [ configuration A ] 
 }
 location ~ ^/docu {
 [ configuration B ] 
 }
}

匹配结果:

configuration A

注:虽然 ~ ^/docu 也能匹配到,但 正则表达式则按照定义顺序。

示例三:

server {
 location ^~ /doc {
 [ configuration A ] 
 }
 location ~ ^/docu {
 [ configuration B ] 
 }
}

匹配结果:

configuration A

注:虽然 ~ ^/docu 也能匹配到,但 ^~优先级更高

示例四:

server {
 location /document {
 [ configuration A ] 
 }
 location ~ ^/docu {
 [ configuration B ] 
 }
}

匹配结果:

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

四、server 和 location 中的 root

server 和 location 中都可以使用 root,举个例子:

server {
 listen 80;
 server_name 10.0.7.115;
 root /data/app/;
 location / {
 root /data/web/;
 index index.html;
 }
}

如果两者都出现,是怎样的优先级呢?

简单的来说,就是 就近原则,如果 location 中能匹配到,就是用 location 中的 root 配置,忽略 server 中的 root,当 location 中匹配不到的时候,则使用 server 中的 root 配置。

总结

作者:蹲街式等待原文地址:https://blog.csdn.net/wangzhongshun/article/details/126434539

%s 个评论

要回复文章请先登录注册