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 Location 指令简明指南

    Nginx Location 指令简明指南

    这篇文章主要介绍了Nginx Location 指令简明指南,本文讲解了它的基本语法、匹配过程、配置实例和全局变量,需要的朋友可以参考下
    2015-04-04
  • Nginx实现分端口部署两个或多个项目的教程

    Nginx实现分端口部署两个或多个项目的教程

    这篇文章主要为大家详细介绍了Nginx实现分端口部署两个或多个项目的相关教程,其中包含了反向代理配置,感兴趣的小伙伴可以跟随小编一起学习一下
    2023-10-10
  • Nexus使用nginx代理实现支持HTTPS协议

    Nexus使用nginx代理实现支持HTTPS协议

    这篇文章主要介绍了Nexus使用nginx代理实现支持HTTPS协议,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2020-05-05
  • Nginx could not build the server_names_hash 错误的解决办法

    Nginx could not build the server_names_hash 错误的解决办法

    这篇文章主要介绍了Nginx could not build the server_names_hash 错误的解决办法,需要的朋友可以参考下
    2014-03-03
  • 解决Nginx配置静态资源文件404 Not Found问题

    解决Nginx配置静态资源文件404 Not Found问题

    在使用Nginx作为静态资源服务器时,如果配置了根目录root导致404错误,而使用前缀URL配置alias则需要正确处理目录路径,使用alias时要确保目录名后加‘/’,并且在需要时使用root和alias配置,本文介绍Nginx配置静态资源文件404 Not Found问题解决方法,感兴趣的朋友一起看看吧
    2025-03-03
  • nginx.conf配置文件结构小结

    nginx.conf配置文件结构小结

    本文主要介绍了nginx.conf配置文件结构小结,nginx.conf主要由events、http、server、location、upstream等块配置项和一些行配置项组成,文中通过示例代码介绍的非常详细,需要的朋友们下面随着小编来一起学习学习吧
    2022-04-04
  • 详解Nginx + Tomcat 反向代理 如何在高效的在一台服务器部署多个站点

    详解Nginx + Tomcat 反向代理 如何在高效的在一台服务器部署多个站点

    本篇文章主要介绍了详解Nginx + Tomcat 反向代理 如何在高效的在一台服务器部署多个站点,具有一定的参考价值,有兴趣的可以了解一下。
    2016-12-12
  • Nginx中日志模块的应用和配置应用示例

    Nginx中日志模块的应用和配置应用示例

    Nginx是一款高性能的HTTP和反向代理服务器,广泛应用于互联网领域,这篇文章主要介绍了Nginx中日志模块的应用和配置,下面通过一个简单的实例来演示Nginx日志模块的应用和配置,需要的朋友可以参考下
    2024-02-02
  • 利用Nginx实现URL重定向的简单方法

    利用Nginx实现URL重定向的简单方法

    使用Nginx的重定向功能时,除了可以重定向到新域名,还可以将请求重定向到特定的协议上,下面这篇文章主要给大家介绍了关于如何利用Nginx实现URL重定向的简单方法,需要的朋友可以参考下
    2022-04-04
  • nginx如何开启Gzip压缩

    nginx如何开启Gzip压缩

    Gzip压缩能显著减小网站静态资源如css、js、html的体积,大幅提升加载速度,它通过服务器端压缩,浏览器端解压,适用于大多数现代浏览器,但应避免对已压缩的图片或大文件进行Gzip压缩,以免无效增加CPU负担,配置Gzip压缩需在nginx的http块内设置并重启nginx
    2024-09-09

最新评论