Nginx Location配置详解

一、Location语法结构

1、语法结构说明

在Nginx官方文档中定义的location语法结构为：

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

其中uri变量是待匹配的请求字符串，可以是不包含有正则表达式的字符串，称之为标准uri，也可以是包含正则表达式的字符串，称之为正则uri。方括号里的部分为可选项，我们称之为匹配标识。

当不添加匹配标识时，Nginx服务器首先在server块的各个location块中搜索是否有标准uri和请求字符串匹配，如果有多个可以匹配，就记录匹配度最高的一个。

然后，服务器再用location块中的正则uri和请求字符串匹配，如果第一个正则uri匹配成功，结束搜索，并使用该location块处理请求。如果所有正则匹配全部失败，则用标准uri匹配到的匹配度最高的location块进行处理。

2、各个标识的含义和优先级

• = 表示精确匹配,这个优先级也是最高的。
• ^~ 表示 uri 以某个常规字符串开头，理解为匹配 url 路径即可。nginx 不对 url 做编码，因此请求为
  /static/20%/aa，可以被规则^~ /static/ /aa 匹配到（注意是空格）。
• ~ 表示区分大小写的正则匹配。
• ~* 表示不区分大小写的正则匹配。
• !~和!~*分别为区分大小写不匹配及不区分大小写不匹配的正则匹配。
• / 通用匹配，任何请求都会匹配到，默认匹配。

优先级：精确匹配 > 正则匹配 > 通用匹配。

---

3、配置请求的根目录

Web服务器接收到网络请求后，首先要在服务器端指定目录中寻找请求资源。在Nginx服务器中，root用来配置资源的根目录，如下：

location /images {
	root /nginx/images;
}

备注：当访问/images/1.jpg时，Nginx会在服务器上寻找路径为/nginx/images/images/1.jpeg的文件。

4、替换请求的uri

通过root指令我们可以指定资源访问的根目录，但是我们会发现访问的uri会附加到指定的文件目录下。通过alias指定，我们可以在访问服务器上资源时不保留访问前缀，如下：

location /images {
	alias /nginx/images;
}

备注：当访问/images/1.jpg时，Nginx会在服务器上寻找路径为/nginx/images/1.jpeg的文件。

---

二、Location具体示例

1、精确匹配

location = /50x.html {
	root /nginx/html;
}

备注：当访问/50x.html时，Nginx会在服务器上寻找路径为/nginx/html/50x.html的文件。

2、正则匹配

location ~* ^/images/(.+\.(png|jpg|jpeg|gif))$ {
   alias  /nginx/images/$1;
}

备注：当访问/images/1.JPEG时，Nginx会在服务器上寻找路径为/nginx/images/1.jpeg的文件，并且访问路径不区分大小写。

3、常规字符串匹配

location ~^ /static//(.+\.(html|htm)){
	alias /nginx/html/$1
}

备注：当访问/static/%20/index.html时，Nginx会在服务器上寻找路径为/nginx/html/1.html的文件。

---

三、调试Location的小技巧

一般如果文件访问失败，在错误日志里能看到错误日志提示，如下：

2024/05/11 15:15:28 [error] 16746#0: *125484 open() "/nginx/images/jpeg" failed (2: No such file or directory), client: 113.116.81.20, server: xxx.com, request: "GET /images/1.jpeg HTTP/1.1", host: "xxx.com"

错误日志的默认配置为：error_log logs/error.log error，也就是在logs/error.log文件中能看到相关错误提示，通过提示我们再进行配置的调整。