nginx location顺序

pillar04

已于 2022-10-13 22:01:05 修改

阅读量1.6k

点赞数 1

文章标签： nginx 运维

于 2022-10-12 16:44:04 首次发布

本文链接：https://blog.csdn.net/pillar04/article/details/127285613

版权

对location用法和顺序一直很懵逼，参考以下这两篇文章才豁然开朗。

匹配符号种类：

`=` 开头表示精确匹配 ,如 A 中只匹配根目录结尾的请求，后面不能带任何字符串。
`^~` 开头表示uri以某个常规字符串开头，不是正则匹配
`~` 开头表示区分大小写的正则匹配;
`~*` 开头表示不区分大小写的正则匹配
`/` 通用匹配, 如果没有其它匹配,任何请求都会匹配到

location优先级：

(location `=` ) > (location `完整路径` ) > (location `^~` 路径) > (location `~`,`~*` 从上向下正则顺序，匹配在最后一条终止) > (location 部分起始路径) > (`/`)

以下面为例：

location  = / {
  # 精确匹配 / ，主机名后面不能带任何字符串
  [ configuration A ] 
}

location  / {
  # 因为所有的地址都以 / 开头，所以这条规则将匹配到所有请求
  # 但是正则和最长字符串会优先匹配
  [ configuration B ] 
}

location /documents/ {
  # 匹配任何以 /documents/ 开头的地址，匹配符合以后，还要继续往下搜索
  # 只有后面的正则表达式没有匹配到时，这一条才会采用这一条
  [ configuration C ] 
}

location ~ /documents/Abc {
  # 匹配任何以 /documents/ 开头的地址，匹配符合以后，还要继续往下搜索
  # 只有后面的正则表达式没有匹配到时，这一条才会采用这一条
  [ configuration CC ] 
}

location ^~ /images/ {
  # 匹配任何以 /images/ 开头的地址，匹配符合以后，停止往下搜索正则，采用这一条。
  [ configuration D ] 
}

location ~* \.(gif|jpg|jpeg)$ {
  # 匹配所有以 gif,jpg或jpeg 结尾的请求
  # 然而，所有请求 /images/ 下的图片会被 config D 处理，因为 ^~ 到达不了这一条正则
  [ configuration E ] 
}

location /images/ {
  # 字符匹配到 /images/，继续往下，会发现 ^~ 存在
  [ configuration F ] 
}

location /images/abc {
  # 最长字符匹配到 /images/abc，继续往下，会发现 ^~ 存在
  # F与G的放置顺序是没有关系的
  [ configuration G ] 
}

location ~ /images/abc/ {
  # 只有去掉 config D 才有效：先最长匹配 config G 开头的地址，继续往下搜索，匹配到这一条正则，采用
    [ configuration H ] 
}

location ~* /js/.*/\.js

/ -> config A
精确完全匹配，即使/index.html也匹配不了

/downloads/download.html -> config B
匹配B以后，往下没有任何匹配，采用B

/images/1.gif -> configuration D
匹配到F，往下匹配到D，停止往下

/images/abc/def -> config D
最长匹配到G，往下匹配D，停止往下
你可以看到 任何以/images/开头的都会匹配到D并停止，FG写在这里是没有任何意义的，H是永远轮不到的，这里只是为了说明匹配顺序

/documents/document.html -> config C
匹配到C，往下没有任何匹配，采用C

/documents/1.jpg -> configuration E
匹配到C，往下正则匹配到E

/documents/Abc.jpg -> config CC
最长匹配到C，往下正则顺序匹配到CC，不会往下到E

普通匹配和正则匹配区别：

正则location和普通location

正则location  “~”和“~*”：“~”表示区分大小写；“~*”表示不区分大小写

普通location:  除了上面其余全是(包括没有前缀) “=”，“^~”，“@”

“^~”中的“^”表示非，“~”表示正则，意思为不要继续匹配正则

“=”也表示阻止正则location，和“^~”的区别为：“^~”依然遵守“最大前缀”匹配；而“=”必须是严格匹配。

“@ ”是用来定义“Named Location ”的（可以理解为独立于“普通location”和“正则location”之外的第三种类型），这种“Named Location ”不是用来处理普通的HTTP 请求的，它

是专门用来处理“内部重定向（internally redirected ）”请求的。

注意：这里说的“内部重定向（internally redirected ）”是不需要跟浏览器交互的，纯粹是服务端的一个转发行为。

坑坑坑：

这里有个坑，就是`index index.html` 如果请求的是目录，那么最终是访问的是目录下的文件，所以使用 index 会 发起内部重定向，

location = / {
    root /var/www/mobile;
    index index.html;
    # [config A]
}

location / {
    root /var/www/pc;
    index index.html;
    # [config B]
}

// 目的：想使用 http://127.0.0.1 直接匹配 [config A] 并停止
// 实际：
// 1. 被使用的 location 是 [config A]，因为 `= /` 为精准匹配，会被优先使用。
// 2. 但此时是个目录所以会，配合 `index index.html` 找  `/index.html`。
      此时相当于访问地址发生了变化会重新发生一次请求。
// 3. 再次请求时规则只能匹配上 [config B]


// 与上面发生重定向的场景类似
// 请求 http://127.0.0.1/pm （注意：最后不带 / ）时
// 因为找不到/pm这个文件，所以好像即使没有使用 try_files 和 rewrite 
// nginx 发现存在 pm 这个目录，所以会自动进行 301 跳转到 http://127.0.0.1/pm/
location /pm {
    root /var/www;
    index index.html;
}

// 请求地址 http://127.0.0.1/pm 请求后 nginx 中的 $uri = /pm/
// 请求地址 http://127.0.0.1/pm/    请求后 nginx 中的 $uri = /pm/
// 请求地址 http://127.0.0.1/pm     请求后 nginx 中的 $uri = /pm
// 可见nginx 自动将url末尾的多个 / 变成 1个 /

注意:在nginx中如果使用非80端口重定向时会出现301丢失端口问题，有待研究。

rewrite中的flag

// break 不会发生内部请求
// last  会发生内部请求，但新请求的地址不会出现在地址栏。
// redirect 302 临时跳转，新请求会出现在地址栏。
// permanent 301 永久跳转，新请求会出现在地址栏。

try_files

try_files /a /b @c; 

// 资料上说只有最后一个参数会发生重新请求（内部重定向）。
// 但测试下来，非最后一个参数也会发生内部重定向，不知道原因，有大神知道请指点。

总结：

1.匹配的顺序是先匹配普通字符串，然后再匹配正则表达式。

另外普通字符串匹配顺序是根据配置中字符长度从长到短，也就是说使用普通字符串配置的location顺序是无关紧要的，反正最后nginx会根据配置的长短来进行匹配。

但是需要注意的是正则表达式按照配置文件里的顺序测试。找到第一个匹配的正则表达式将停止搜索。

2.一般情况下，匹配成功了普通字符串location后还会进行正则表达式location匹配。有两种方法改变这种行为，其一就是使用“=”前缀，这时执行的是严格匹配，并且匹配成功后立即停止其他匹配，同时处理这个请求；另外一种就是使用“^~”前缀，如果把这个前缀用于一个常规字符串那么告诉nginx 如果路径匹配那么不测试正则表达式。

参考文章：

https://www.jianshu.com/p/38810b49bc29