Nginx中Location配置超详细讲解

目录一、语法二、匹配顺序三、root 与 alias 的区别四、server 和 location 中的 root总结

一、语法

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 配置。

总结