Nginx Location匹配规则的具体使用

 更新时间:2024年11月06日 08:31:12   作者:为什么要做囚徒  
Nginx location指令用于配置请求的处理方式,包括精确匹配、最长前缀匹配、正则表达式匹配等,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧

1. 语法基础

Nginx 的 location 指令的基本语法如下:

location [=|~|~*|^~|@] uri { ... }
  • = 表示精确匹配。
  • ~ 表示区分大小写的正则匹配。
  • ~* 表示不区分大小写的正则匹配。
  • ^~ 表示非正则匹配,如果该选项匹配,则不再进行正则匹配。( ^ 表示“非”,~ 表示“正则”,字符意思是:不会继续匹配正则)
  • @ 定义一个命名的 location,通常用于内部重定向。

2. 匹配规则

Nginx 对多个 location 的匹配遵循一定的规则和优先级。当 Nginx 收到一个请求时,它会按照以下顺序进行匹配

2.1 精确匹配(=)

优先级最高。当请求的URI与location后面的字符串完全相同时,Nginx会选择这个location块进行处理。(这个好理解,就是路径完全匹配,一模一样,优先级最高)

示例:

location = /favicon.ico {
    # 处理/favicon.ico的请求
}

只有当请求URI严格为/favicon.ico时,上述location块才会被使用。

2.2. 最长前缀匹配(^~)

以^~开头的location表示最长前缀匹配。如果请求的URI以某个location后面的字符串开头,并且这个字符串是最长的(或者使用了^~修饰符),Nginx会选择这个location块。但请注意,^~修饰符实际上会停止后续的正则匹配搜索。(最长前缀匹配,意思就是以location后面的字符开始的且最长匹配,有的地方叫做非正则匹配,意思是满足了最长前缀匹配,就不会再匹配正则匹配了,也可以理解为即满足最长前缀匹配,也满足正则匹配,就匹配最长前缀匹配,也就是所说的最长前缀匹配优先级高于正则匹配,所谓的优先级是两者或多着都匹配的情况下,才会显现优先级)

示例:

   location ^~ /hello {
     return  601;
   }

    location ^~ /hellow {
     return  602;
   }

   location ^~ /hello/world {
     return  603;
   }

    location ~ /hello {
     return  604;
   }

对于请求/hello,满足 601和 604,实际返回601,就是因为^~优先级高于正则匹配;
对于请求/hellow,满足 601和 602,实际返回602,因为最长前缀匹配原则;

2.3. 正则表达式匹配(~和~*)

正则表达式匹配允许定义更复杂的URI匹配模式。~表示区分大小写的正则匹配,而~*表示不区分大小写的正则匹配。

Nginx会按照配置文件中的顺序逐个检查正则表达式location块,直到找到第一个匹配的块。因此,正则表达式的顺序很重要。

示例:

location ~ \.(gif|jpg|png)$ {
    # 处理以.gif、.jpg或.png结尾的请求(区分大小写)
}
location ~* \.(GIF|JPG|PNG)$ {
    # 处理以.GIF、.JPG或.PNG结尾的请求(不区分大小写)
}

对于请求/images/photo.jpg,第一个location块将被匹配(如果请求是区分大小写的)。

2.4. 普通前缀匹配(无修饰符)

普通前缀匹配也按照配置文件中出现的先后顺序进行匹配,先出现的location指令优先匹配。

示例:

   location /hello {
     return  601;
   }

   location /hellow {
     return  602;
   }

对于请求/hellow,满足 601和 602,实际返回602,证明满足长前缀匹配原则

再增加一项配置
```
  location ~ /hello[a-z] {
          return  603;
  }
```

对于请求/hellow,满足 601、 602和603,实际返回603,证明正则匹配优先级高于普通匹配

2.5. 默认匹配(/)

如果请求的URI与任何特定的location块都不匹配,Nginx将使用默认的location块(如果有的话)。通常,默认的location块是一个不带任何修饰符的location /块。

示例:

location / {
    # 处理所有其他请求
}

综上所述

Nginx的location匹配规则优先级可以总结为:

  • 精确匹配(=)
  • 最长前缀匹配(^~),但会停止后续的正则匹配搜索
  • 正则表达式匹配(~和~*),按配置顺序
  • 普通前缀匹配(无修饰符),也按配置顺序
  • 默认匹配(/)

3. 注意事项

  • 正则匹配与顺序:正则 location 的匹配顺序很重要,因为 Nginx 会按照配置文件中定义的顺序进行匹配。
  • proxy_pass 的路径替换:在配置 proxy_pass 时,需要注意 location 后面的 URI 是否包含斜杠(/),这会影响请求的转发路径。通常建议 location 和 proxy_pass 要么都加斜杠,要么都不加。
  • 性能优化:将精确匹配放在前面,可以减少不必要的正则匹配,提高 Nginx 的处理效率。

4. 常见的正则符号

符号描述示例
^匹配字符串的开始位置^http 匹配以"http"开头的字符串
$匹配字符串的结束位置\.com$ 匹配以".com"结尾的字符串
.匹配除换行符以外的任意单个字符a.c 匹配"abc"、"a1c"等
*匹配前面的子表达式零次或多次ab*c 匹配"ac"、“abc”、"abbc"等
+匹配前面的子表达式一次或多次ab+c 匹配"abc"、“abbc”、“abbbc"等,但不匹配"ac”
?匹配前面的子表达式零次或一次ab?c 匹配"ac"、“abc”
|或匹配模式,匹配左边的表达式或右边的表达式(jpg|gif|png) 匹配"jpg"、“gif"或"png”
\转义字符,用于匹配特殊字符\. 匹配"."字符本身
[ ]字符集合,匹配集合中的任意单个字符[a-z] 匹配任意小写字母
[^ ]反向字符集合,匹配不在集合中的任意单个字符[^a-z] 匹配任意非小写字母
{n}n 是一个非负整数,匹配确定的 n 次o{2} 匹配"oo"
{n,}n 是一个非负整数,至少匹配 n 次o{2,} 匹配"oo"、“ooo”、"oooo"等
{n,m}n 和 m 均为非负整数,其中n <= m,匹配至少 n 次,但不超过 m 次o{2,4} 匹配"oo"、“ooo”、“oooo”

到此这篇关于Nginx Location匹配规则的文章就介绍到这了,更多相关Nginx Location匹配规则内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家! 

相关文章

  • Nginx负载均衡/SSL配置的实现

    Nginx负载均衡/SSL配置的实现

    这篇文章主要介绍了Nginx负载均衡/SSL配置的实现,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2019-10-10
  • 服务器报错nginx 502 Bad Gateway的原因及如何解决详解

    服务器报错nginx 502 Bad Gateway的原因及如何解决详解

    项目启动时莫名其妙网站访问不了,502 Bad Gateway,下面这篇文章主要给大家介绍了关于服务器报错nginx 502 Bad Gateway的原因及如何解决的相关资料,文中通过实例代码介绍的非常详细,需要的朋友可以参考下
    2023-06-06
  • Nginx设置连接超时并进行测试的方法步骤

    Nginx设置连接超时并进行测试的方法步骤

    在高并发场景下,如果客户端与服务器的连接长时间未响应,会占用大量的系统资源,影响其他正常请求的处理效率,为了解决这个问题,可以通过设置 Nginx 的连接超时时间来优化资源管理,提高服务器的稳定性,以下是具体的配置方法和测试步骤,希望对你有所帮助
    2025-02-02
  • 使用Nginx和内网穿透实现多个本地Web站点的公网访问过程

    使用Nginx和内网穿透实现多个本地Web站点的公网访问过程

    本文介绍了如何通过Nginx配置文件的修改结合内网穿透技术,实现将多个本地Web站点暴露到公网,具体步骤包括安装和配置Nginx,选择内网穿透工具,配置Nginx服务器块以及启动Nginx服务
    2026-01-01
  • Windows安装nginx服务全过程

    Windows安装nginx服务全过程

    本文详细介绍了在Windows系统系统上系统下安装Nginx并将其设置为服务的过程,包括下载安装、解压配置、创建服务文件、安装服务、修改配置文件、重启服务等步骤,最后还总结了如何检查配置和查看服务状态的方法
    2026-04-04
  • Nginx反向代理重写URL的实现方案

    Nginx反向代理重写URL的实现方案

    nginx服务器代理前端项目,并且反代后端服务器,开发时使用没有什么问题,部署后存在同样请求根地址的情况,但是去调用后端接口就会出现报错,最后通过重写url解决问题,所以本文给大家介绍了Nginx反向代理重写URL的实现方案,需要的朋友可以参考下
    2025-04-04
  • 图文详解nginx日志切割的实现

    图文详解nginx日志切割的实现

    这篇文章主要给大家介绍了关于nginx日志切割实现的相关资料,文中通过实例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2022-01-01
  • Nginx实现负载均衡的项目实践

    Nginx实现负载均衡的项目实践

    在我们实际生产中,一台服务器的处理能力、存储空间是有限的,这时候就需要负载均衡,本文详细的介绍了Nginx实现负载均衡的项目实践,具有一定的参考价值,感兴趣的可以了解一下
    2022-03-03
  • nginx 反向代理负载均衡策略配置SSL访问匹配规则优先级

    nginx 反向代理负载均衡策略配置SSL访问匹配规则优先级

    本文主要包含1.Nginx配置文件详解2.Nginx实现负载均衡3.Nginx前端项目部署4.Nginx配置SSL访问5.nginx匹配规则说明以及匹配的优先级的内容详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-06-06
  • nginx的服务配置及重定向问题

    nginx的服务配置及重定向问题

    这篇文章主要介绍了nginx的服务配置及重定向问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2024-06-06

最新评论