NGINX location 在配置中的优先级

本文详细解释了Nginx中location指令的不同匹配方式及其优先级,包括等号匹配、前缀匹配、正则匹配等,并通过具体示例展示了不同匹配方式的应用场景。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

location表达式类型

~ 表示执行一个正则匹配,区分大小写
~* 表示执行一个正则匹配,不区分大小写
^~ 表示普通字符匹配。使用前缀匹配。如果匹配成功,则不再匹配其他location。
= 进行普通字符精确匹配。也就是完全匹配。
@ 它定义一个命名的 location,使用在内部定向时,例如 error_page, try_files

location优先级说明

在nginx的location和配置中location的顺序没有太大关系。正location表达式的类型有关。相同类型的表达式,字符串长的会优先匹配。

以下是按优先级排列说明:

  • 第一优先级:等号类型(=)的优先级最高。一旦匹配成功,则不再查找其他匹配项。
  • 第二优先级:^~类型表达式。一旦匹配成功,则不再查找其他匹配项。
  • 第三优先级:正则表达式类型(~ ~*)的优先级次之。如果有多个location的正则能匹配的话,则使用正则表达式最长的那个。
  • 第四优先级:常规字符串匹配类型。按前缀匹配。(如果有更长的同类型的表达式,则选择更长的表达式)

location优先级示例

配置项如下:
location = / {
# 仅仅匹配请求 /
[ configuration A ]
}
location / {
# 匹配所有以 / 开头的请求。但是如果有更长的同类型的表达式,则选择更长的表达式。如果有正则表达式可以匹配,则
# 优先匹配正则表达式。
[ configuration B ]
}
location /documents/ {
# 匹配所有以 /documents/ 开头的请求。但是如果有更长的同类型的表达式,则选择更长的表达式。
#如果有正则表达式可以匹配,则优先匹配正则表达式。
[ configuration C ]
}
location ^~ /images/ {
# 匹配所有以 /images/ 开头的表达式,如果匹配成功,则停止匹配查找。所以,即便有符合的正则表达式location,也
# 不会被使用
[ configuration D ]
}
location ~* .(gif|jpg|jpeg)$ {
# 匹配所有以 gif jpg jpeg结尾的请求。但是 以 /images/开头的请求,将使用 Configuration D
[ configuration E ]
}

请求匹配示例
/ -> configuration A
/index.html -> configuration B
/documents/document.html -> configuration C
/images/1.gif -> configuration D
/documents/1.jpg -> configuration E

注意,以上的匹配和在配置文件中定义的顺序无关。

转载来源:
http://www.bo56.com/nginx-location%E5%9C%A8%E9%85%8D%E7%BD%AE%E4%B8%AD%E7%9A%84%E4%BC%98%E5%85%88%E7%BA%A7/

### ### Nginx `location` 模块匹配优先级详解 Nginx 的 `location` 模块用于对请求的 URI 进行匹配,并决定如何处理该请求。其匹配规则具有明确的优先级顺序,决定了不同类型的 `location` 块在匹配过程中的执行顺序。 #### #### 匹配类型及其优先级顺序 Nginx 中 `location` 的匹配类型按照优先级从高到低依次为: 1. **精确匹配**(`location = /path`) 仅当请求的 URI 完全匹配指定路径时才生效。例如,请求 `/logo.png` 会命中 `location = /logo.png`[^2]。 2. **优先前缀匹配**(`location ^~ /prefix`) 若匹配成功,则不再进行后续的正则表达式匹配。例如,请求 `/static/css/style.css` 会命中 `location ^~ /static/`。 3. **区分大小写的正则匹配**(`location ~ /regex/`) 使用 POSIX 正则表达式进行匹配,匹配结果受大小写影响。例如,请求 `/user/123` 会命中 `location ~ /user/\d+`。 4. **不区分大小写的正则匹配**(`location ~* /regex/`) 同样使用正则表达式,但忽略大小写。例如,请求 `/IMAGE.JPG` 会命中 `location ~* \.(js|css)$`[^2]。 5. **普通前缀匹配**(`location /path`) 最基本的前缀匹配方式,若没有更高优先级的匹配项,则匹配此类型。例如,请求 `/about` 会命中 `location /`[^2]。 #### #### 匹配流程解析 Nginx 在处理请求时,首先检查所有精确匹配项,若有匹配则立即使用该 `location` 块;否则继续查找最长前缀匹配。如果存在 `^~` 类型的匹配项且匹配成功,则跳过正则匹配阶段。如果没有匹配成功的前缀匹配项,则依次测试正则表达式匹配,一旦匹配成功即采用对应的 `location` 配置。若都没有匹配成功,则使用默认的 `/` 匹配项[^2]。 #### #### 示例配置与行为分析 以下是一个典型的 `server` 块配置示例: ```nginx server { listen 80; server_name example.com; # 精确匹配 location = /logo.png { root /var/www/exact; } # 优先前缀匹配 location ^~ /static/ { root /var/www/static; } # 区分大小写的正则匹配 location ~ /user/\d+ { proxy_pass http://user_backend; } # 不区分大小写的正则匹配 location ~* \.(js|css)$ { root /var/www/assets; } # 普通前缀匹配 location / { root /var/www/default; } } ``` 在此配置中: - 请求 `/logo.png` 会命中第一个 `location = /logo.png`。 - 请求 `/static/css/style.css` 会命中 `location ^~ /static/`。 - 请求 `/user/123` 会命中 `location ~ /user/\d+`。 - 请求 `/IMAGE.JPG` 会命中 `location ~* \.(js|css)$`。 - 请求 `/about` 会命中 `location /`[^2]。 #### #### 调试与验证技巧 为了确保配置按预期工作,可以使用以下方法进行调试: - 使用命令 `nginx -T` 查看当前加载的所有配置内容,确认 `location` 规则是否正确应用。 - 启用调试日志:`error_log logs/error.log debug;` 可以输出详细的请求匹配信息。 - 利用在线工具如 [Nginx Location Tester](https://nginx.vision/location/) 来模拟和测试不同的 URI 匹配情况。 ---
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值