Nginx 配置之 location 配置

1、location 作用

location 用于匹配用户访问的URL,来适用哪一个目录中的资源

2、location 的常用匹配规则

字符 涵义
= 进行普通字符精确匹配,也就是完全匹配
^~ 表示普通字符匹配。使用前缀匹配。如果匹配成功,则不再匹配其它 location
~ 区分大小写的匹配
~* 不区分大小写的匹配
!~ 区分大小写的匹配取非
!~* 不区分大小写的匹配取非

3、location 的 优先级与匹配规则

  1. 首先是 精确匹配 =。匹配优先级最高。一旦匹配成功,则不再查找其他匹配项。
    eg: location = /test/ { }

  2. 其次是 前缀匹配 ^~。一旦匹配成功,则不再查找其他匹配项。
    eg: location ^~ /test/ { }

  3. 其次是按文件中顺序的正则匹配 ~(区分大小写) 或 ~*(忽略大小写)
    eg: location ~ /test/ { }

  4. 然后是一般匹配 ,后面不带 / 的匹配。遵循最长匹配原则。
    eg: locaton /test/ { }

  5. 最后是 交给 / 通用匹配
    eg: location / { }

  6. @ : 定义一个命名的 location,使用在内部定向时,例如 error_page
    eg:@error_page {}

匹配规则:

  1. 首先看匹配的优先级:精确匹配 > 前缀匹配 > 正则匹配 > 一般匹配 > 通用匹配
  2. 首先匹配精确匹配。
  3. 当没有精确匹配,只有前缀匹配或正则匹配时,同等级的优先级遵循匹配即停止原则。即当都是正则匹配时,哪个localtion 写在配置文件的上面,就匹配哪个。
  4. 一般匹配,则遵循最长匹配原则,当只有一般匹配符合时,哪个location 匹配的url 最长,则使用哪个。但是,如果有符合规则的精确匹配,前缀匹配,正则匹配,则使用优先级高的。

4、location 示例说明

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
location = / {}  
# 精确匹配,比如访问 / 和 /data,则 / 匹配,/data 不匹配,再比如 location = /abc,则只匹配/abc ,/abc/或 /abcd不匹配。

location / {}
# 一般匹配,因为所有的地址都以 / 开头,所以这条规则将匹配到所有请求,但若后面是正则表达式会和最长字符串优先匹配(最长匹配原则)

location /test/ {}
# 一般匹配,匹配任何以 /test/ 开头的地址,匹配符合以后,还要继续往下搜索其它 location。只有其它 location后面的正则表达式没有匹配到时,才会采用这一条

location /test/abc {}
# 一般匹配,匹配任何以 /test/abc 开头的地址,匹配符合以后,还要继续往下搜索其它 location。只有其它 location后面的正则表达式没有匹配到时,才会采用这一条

location ^~ /images/ {}
# 正则匹配,匹配任何以 /images/ 开头的地址,匹配符合以后,停止往下搜索正则,采用这一条(匹配即停止原则)

location ~\* .(gif|jpg|jpeg)$ {}
# 正则匹配,匹配所有以 gif、jpg或jpeg 结尾的请求
# 然而,所有请求 /images/ 下的图片会被 location ^~ /images/ 处理,因为 ^~ 的优先级更高,所以到达不了这一条正则

location /images/abc {}
# 一般匹配,最长字符匹配到 /images/abc ,如果只有一般匹配,则会使用它,但时由于有 正则匹配和前缀匹配,而一般匹配优先级最低,继续往下搜索其它 location,会发现 ^~ 和 ~ 存在

location ~ /images/abc {}
# 正则匹配,匹配以/images/abc 开头的,优先级次之,只有去掉 location ^~ /images/ 才会采用这一条

location /images/abc/1.html {}
# 一般匹配,匹配/images/abc/1.html 文件,如果和正则 ~ /images/abc/1.html 相比,正则优先级更高

5、location URI结尾带不带 /

  • 如果 URI 结构是 https://domain.com/ 的形式,尾部有没有 / 都不会造成重定向。因为浏览器在发起请求的时候,默认加上了 / 。虽然很多浏览器在地址栏里也不会显示 / 。这一点,可以访问百度验证一下。
  • 如果 URI 的结构是 https://domain.com/some-dir/。尾部如果缺少 / 将导致重定向。因为根据约定,URL 尾部的 / 表示目录,没有 / 表示文件。所以访问 /some-dir/ 时,服务器会自动去该目录下找对应的默认文件。如果访问 /some-dir 的话,服务器会先去找 some-dir 文件,找不到的话会将 some-dir 当成目录,重定向到 /some-dir/ ,去该目录下找默认文件

Nginx 配置之 location 配置
https://flepeng.github.io/040-Nginx-11-安装和配置-Nginx-配置之-location-配置/
作者
Lepeng
发布于
2016年1月1日
许可协议