nginx中的路径匹配location规则详解

 更新时间:2025年04月07日 09:40:12   作者:huangSir-devops  
Nginx的匹配规则用location指令来实现,Nginx 的location指令用于匹配请求的 URI(请求路径),并根据匹配结果执行特定的处理指令,这篇文章主要介绍了nginx中的路径匹配规则详解(location规则),需要的朋友可以参考下

Nginx的路径匹配规则

Nginx的匹配规则用location指令来实现,Nginx 的location指令用于匹配请求的 URI(请求路径),并根据匹配结果执行特定的处理指令。location是实现动静分离、URL 重写、反向代理等功能的核心模块之一.

location匹配规则分类

location支持多种匹配模式,包括精确匹配、前缀匹配、正则匹配等

精确匹配(=)

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

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

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

最长前缀匹配(^~)

第二优先级。请求的URI以某个location后面的字符串开头,并且这个字符串是最长的(或者使用了^~修饰符),Nginx会选择这个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,因为最长前缀匹配原则;

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

第三优先级。正则表达式匹配允许定义更复杂的URI匹配模式。~表示区分大小写的正则匹配,而~*表示不区分大小写的正则匹配。
Nginx会按照配置文件中的顺序逐个检查正则表达式location块,直到找到第一个匹配的块。因此,正则表达式的顺序很重要。

示例:

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

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

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

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

   location /hello {
     return  601;
   }
   location /hellow {
     return  602;
   }

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

默认匹配(/)

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

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

总结

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

  • 精确匹配(=

  • 最长前缀匹配(^~),但会停止后续的正则匹配搜索

  • 正则表达式匹配(~~*),按配置顺序

  • 普通前缀匹配(无修饰符),也按配置顺序

  • 默认匹配(/

注意事项

  • 正则匹配与顺序:正则 location 的匹配顺序很重要,因为 Nginx 会按照配置文件中定义的顺序进行匹配。

  • proxy_pass 的路径替换:在配置 proxy_pass 时,需要注意 location 后面的 URI 是否包含斜杠(/),这会影响请求的转发路径。通常建议 location 和 proxy_pass 要么都加斜杠,要么都不加。

  • 性能优化:将精确匹配放在前面,可以减少不必要的正则匹配,提高 Nginx 的处理效率。

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

相关文章

  • 详解nginx服务器绑定域名和设置根目录的方法

    详解nginx服务器绑定域名和设置根目录的方法

    这篇文章主要介绍了详解nginx服务器绑定域名和设置根目录的方法,nginx服务器绑定域名以及设置根目录非常方便,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-06-06
  • Ansible批量部署Nginx的示例代码

    Ansible批量部署Nginx的示例代码

    这篇文章主要介绍了Ansible批量部署Nginx的示例代码,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-10-10
  • nginx利用lua语言实现软waf的示例代码

    nginx利用lua语言实现软waf的示例代码

    这篇文章主要介绍了nginx利用lua语言实现软waf,文中通过代码示例和图文结合的方式给大家讲解的非常详细,对大家的学习或工作有一定的帮助,需要的朋友可以参考下
    2024-03-03
  • Nginx服务器配置https安全协议的实现

    Nginx服务器配置https安全协议的实现

    HTTP是互联网中最常用的协议,用于从服务器传输超文本到浏览器,HTTPS是HTTP的安全版本,本文就来介绍一下Nginx服务器配置https安全协议的实现,感兴趣的可以了解一下
    2024-09-09
  • linux下Nginx+Tomcat负载均衡配置方法

    linux下Nginx+Tomcat负载均衡配置方法

    这篇文章主要介绍了linux下Nginx+Tomcat负载均衡配置方法,需要的朋友可以参考下
    2016-09-09
  • Nginx解决跨域访问的完整实例

    Nginx解决跨域访问的完整实例

    本文介绍了使用Nginx解决Web开发中的跨域问题,并通过一个实例说明了配置和测试过程,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2024-10-10
  • Nginx配置WebSocket代理的示例代码

    Nginx配置WebSocket代理的示例代码

    本文提供了关于Nginx的配置和日志记录的详细指南,介绍了如何使用whereis命令查找Nginx路径,并通过man命令查看手册,同时,详解了解Nginx访问日志的配置方法及参数含义,并分享了Nginx代理WebSocket的配置示例,感兴趣的可以了解一下
    2024-10-10
  • 利用nginx同一端口部署多个前端的办法(亲测有效版)

    利用nginx同一端口部署多个前端的办法(亲测有效版)

    在Nginx中配置同一个端口支持多个前端应用,通常可以通过不同的路径(location)来映射不同的前端项目,这篇文章主要介绍了利用nginx同一端口部署多个前端的相关资料,需要的朋友可以参考下
    2026-01-01
  • Ubuntu下Nginx1.28.0源码编译安装与systemd管理方式解读

    Ubuntu下Nginx1.28.0源码编译安装与systemd管理方式解读

    这篇文章主要介绍了Ubuntu下Nginx1.28.0源码编译安装与systemd管理方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2025-05-05
  • Nginx反向代理配置的全过程记录

    Nginx反向代理配置的全过程记录

    这篇文章主要给大家介绍了关于Nginx反向代理配置的相关资料,nginx作为web服务器一个重要的功能就是反向代理,当然你也可以使用nginx配置正向代理,需要的朋友可以参考下
    2021-06-06

最新评论