一文弄懂Nginx的location匹配

因为团队在进行先后端分离，前端接管了Nginx和node层，在平常的工做中，跟Nginx打交道的时候挺多的。以前对location的匹配规则是只知其一;不知其二的，为了搞明白location是如何匹配的，查了些资料总结此文。但愿能给你们带来帮助。

语法规则

location [ = | ~ | ~* | ^~ ] uri { ... }
location @name { ... }

语法规则很简单，一个location关键字，后面跟着可选的修饰符，后面是要匹配的字符，花括号中是要执行的操做。

修饰符

• = 表示精确匹配。只有请求的url路径与后面的字符串彻底相等时，才会命中。
• ~ 表示该规则是使用正则定义的，区分大小写。
• ~* 表示该规则是使用正则定义的，不区分大小写。
• ^~ 表示若是该符号后面的字符是最佳匹配，采用该规则，再也不进行后续的查找。

匹配过程

对请求的url序列化。例如，对%xx等字符进行解码，去除url中多个相连的/，解析url中的.，..等。这一步是匹配的前置工做。

location有两种表示形式，一种是使用前缀字符，一种是使用正则。若是是正则的话，前面有~或~*修饰符。

具体的匹配过程以下：

首先先检查使用前缀字符定义的location，选择最长匹配的项并记录下来。

若是找到了精确匹配的location，也就是使用了=修饰符的location，结束查找，使用它的配置。

而后按顺序查找使用正则定义的location，若是匹配则中止查找，使用它定义的配置。

若是没有匹配的正则location，则使用前面记录的最长匹配前缀字符location。

基于以上的匹配过程，咱们能够获得如下两点启示：

1. 使用正则定义的location在配置文件中出现的顺序很重要。由于找到第一个匹配的正则后，查找就中止了，后面定义的正则就是再匹配也没有机会了。
2. 使用精确匹配能够提升查找的速度。例如常常请求/的话，可使用=来定义location。

示例

接下来咱们以一个例子来具体说明一下匹配过程。

假如咱们有下面的一段配置文件：

location = / {
    [ configuration A ]
}

location / {
    [ configuration B ]
}

location /user/ {
    [ configuration C ]
}

location ^~ /images/ {
    [ configuration D ]
}

location ~* \.(gif|jpg|jpeg)$ {
    [ configuration E ]
}

请求/精准匹配A，再也不往下查找。

请求/index.html匹配B。首先查找匹配的前缀字符，找到最长匹配是配置B，接着又按照顺序查找匹配的正则。结果没有找到，所以使用先前标记的最长匹配，即配置B。

请求/user/index.html匹配C。首先找到最长匹配C，因为后面没有匹配的正则，因此使用最长匹配C。
请求/user/1.jpg匹配E。首先进行前缀字符的查找，找到最长匹配项C，继续进行正则查找，找到匹配项E。所以使用E。

请求/images/1.jpg匹配D。首先进行前缀字符的查找，找到最长匹配D。可是，特殊的是它使用了^~修饰符，再也不进行接下来的正则的匹配查找，所以使用D。这里，若是没有前面的修饰符，其实最终的匹配是E。你们能够想想为何。

请求/documents/about.html匹配B。由于B表示任何以/开头的URL都匹配。在上面的配置中，只有B能知足，因此匹配B。

location @name的用法

@用来定义一个命名location。主要用于内部重定向，不能用来处理正常的请求。其用法以下：

location / {
    try_files $uri $uri/ @custom
}
location @custom {
    # ...do something
}

上例中，当尝试访问url找不到对应的文件就重定向到咱们自定义的命名location（此处为custom）。

值得注意的是，命名location中不能再嵌套其它的命名location。

URL尾部的/需不须要

关于URL尾部的/有三点也须要说明一下。第一点与location配置有关，其余两点无关。

1. location中的字符有没有/都没有影响。也就是说/user/和/user是同样的。
2. 若是URL结构是https://domain.com/的形式，尾部有没有/都不会形成重定向。由于浏览器在发起请求的时候，默认加上了/。虽然不少浏览器在地址栏里也不会显示/。这一点，能够访问baidu验证一下。
3. 若是URL的结构是https://domain.com/some-dir/。尾部若是缺乏/将致使重定向。由于根据约定，URL尾部的/表示目录，没有/表示文件。因此访问/some-dir/时，服务器会自动去该目录下找对应的默认文件。若是访问/some-dir的话，服务器会先去找some-dir文件，找不到的话会将some-dir当成目录，重定向到/some-dir/，去该目录下找默认文件。能够去测试一下你的网站是否是这样的。

总结

location的配置有两种形式，前缀字符和正则。查找匹配的时候，先查找前缀字符，选择最长匹配项，再查找正则。正则的优先级高于前缀字符。

正则的查找是按照在配置文件中的顺序进行的。所以正则的顺序很重要，建议越精细的放的越靠前。

使用=精准匹配能够加快查找的顺序，若是根域名常常被访问的话建议使用=。