Nginx location匹配模式与规则详解
更新时间：2025年04月23日 15:02:50 作者：自由de单车
这篇文章主要介绍了Nginx location匹配模式与规则,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
一、环境
Nginx 1.19
二、匹配模式
在 Nginx 的location指令里，常用的匹配模式有：
- 精准模式(
=) - 前缀模式，不继续匹配正则(
^~)， - 前缀模式，继续匹配正则，
- 正则模式，大小写敏感(
~) - 正则模式，大小写不敏感(
~*)
1. 精准模式
location = /path {
default_type text/html;
return 200 'hello';
}2. 前缀模式（不继续匹配正则）
location ^~ /path {
default_type text/html;
return 200 'hello';
}3. 前缀模式（继续匹配正则）
location /path {
default_type text/html;
return 200 'hello';
}4. 正则模式（大小写敏感）
location ~ /path {
default_type text/html;
return 200 'hello';
}5. 正则模式（大小写不敏感）
location ~* /path {
default_type text/html;
return 200 'hello';
}Nginx会按照 精准模式 -> 前缀模式 -> 正则模式 的顺序来匹配。
精准模式优先级最高，匹配到后就不再继续匹配其它模式。而前缀模式匹配到后，还要视乎指令的配置情况，来决定要不要继续匹配正则模式。
三、需要注意的地方
1. 命中多个正则模式时的优先级
看例子：
# 正则模式（大小写敏感）
location ~ /a {
default_type text/html;
return 200 '111';
}
# 正则模式（大小写敏感）
location ~ /a/b {
default_type text/html;
return 200 '222';
}如果访问http://localhost/a/b，会命中哪个location？答案是第一个。
因为两个location都是正则模式（无论是否大小写敏感），从上之下，哪个先匹配到就哪个负责处理。
2. 命中多个前缀模式时的优先级
# 前缀模式（继续匹配正则）
location /a {
default_type text/html;
return 200 '111';
}
# 前缀模式（继续匹配正则）
location /a/b {
default_type text/html;
return 200 '222';
}- 访问
http://localhost/a，命中第一个； - 访问
http://localhost/a/b，命中第二个； - 访问
http://localhost/a/b/c，命中第二个；
简单来说，哪个location匹配到的字符串最长，就由哪个来处理，比如http://localhost/a/b/c能匹配到的最长字符串是/a/b，所以由第二个location来处理。
前缀模式（不继续匹配正则）也是同样的匹配规则。
3. 命中多个不同模式时的优先级
# 前缀模式（不继续匹配正则）
location ^~ /a {
default_type text/html;
return 200 '111';
}
# 前缀模式（继续匹配正则）
location /a/b {
default_type text/html;
return 200 '333';
}
# 正则模式（大小写敏感）
location ~ /a/b {
default_type text/html;
return 200 '222';
}访问http://localhost/a/b，会命中第三个location。
前面两个location都是前缀模式，由匹配字符串最长的处理（即第二个）。第二个location没有阻止继续匹配正则，于是又继续匹配第三个location（正则模式），所以最后是由第三个location处理。
4. 两种前缀模式不能同时存在
看例子：
# 前缀模式（不继续匹配正则）
location ^~ /a {
default_type text/html;
return 200 '333';
}
# 前缀模式（继续匹配正则）
location /a {
default_type text/html;
return 200 '444';
}上面这段配置 Nginx 会报错，因为在路径相同的情况下，这两种模式不能共存。
总结
以上为个人经验，希望能给大家一个参考，也希望大家多多支持脚本之家。
相关文章
这篇文章主要介绍了Nginx正确的404配置方法,本文根据实际案例总结而来,可以说是一个等号引发的血案！需要的朋友可以参考下2014-08-08
这篇文章主要介绍了Nginx Location指令URI匹配规则详解小结，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧2019-04-04
这篇文章主要给大家介绍了关于nginx https反向代理tomcat的2种实现方法，第一种方法是nginx配置https，tomcat也配置https，第二种方法是nginx采用https，tomcat采用http，文中通过示例代码介绍的非常详细，需要的朋友可以参考下。2017-12-12
本文主要给大家介绍了如何解决Nginx访问php文件直接下载,这种情况通常是因为nginx没有将PHP文件交给PHP解释器处理,文中通过代码示例给大家介绍的非常详细,需要的朋友可以参考下2023-12-12
这篇文章主要介绍了Nginx proxy_set_header配置方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教2024-06-06
会话保持是指在会话持续或会话完成一个任务或一个事务的时间段内,将客户端请求引导至同一个后端Web服务器或应用服务器,本文主要介绍了Nginx会话保持的具体实现,感兴趣的可以了解一下2024-07-07
这篇文章主要介绍了Nginx 域名转发的实现,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧2019-08-08
在Nginx配置中,有时rewrite规则无法满足复杂逻辑判断需求,这时需要使用if语法,if可以根据文件是否存在、路径特定条件等进行判断,本文就来介绍一下if判断的使用2024-10-10
这篇文章主要给大家介绍了关于利用SSL配置Nginx反向代理的简单步骤，文中通过示例代码介绍的非常详细，对大家学习或者使用Nginx具有一定的参考学习价值，需要的朋友们下面来一起学习学习吧2019-05-05
这篇文章主要介绍了Nginx搭建图片视频服务器的部署步骤,本文给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下2022-07-07
最新评论