nginx匹配规则说明以及匹配的优先级

location 匹配规则

语法规则

location [=|~|~*|^~] /uri/ { … }

模式含义
location = /uri= 表示精确匹配,只有完全匹配上才能生效
location ^~ /uri^~ 开头对URL路径进行前缀匹配,并且在正则之前。
location ~ pattern开头表示区分大小写的正则匹配
location ~* pattern开头表示不区分大小写的正则匹配
location /uri不带任何修饰符,也表示前缀匹配,但是在正则匹配之后
location /通用匹配,任何未匹配到其它location的请求都会匹配到,相当于switch中的default

前缀匹配时,Nginx 不对 url 做编码,因此请求为 /static/20%/aa,可以被规则 ^~ /static/ /aa 匹配到(注意是空格)

多个 location 配置的情况下匹配顺序为(参考资料而来,还未实际验证,试试就知道了,不必拘泥,仅供参考):

  • 首先精确匹配 =
  • 其次前缀匹配 ^~
  • 其次是按文件中顺序的正则匹配
  • 然后匹配不带任何修饰的前缀匹配。
  • 最后是交给 / 通用匹配
  • 当有匹配成功时候,停止匹配,按当前匹配规则处理请求

注意:前缀匹配,如果有包含关系时,按最大匹配原则进行匹配。比如在前缀匹配:location /dir01 与location /dir01/dir02,如有请求 http://localhost/dir01/dir02/file 将最终匹配到 location /dir01/dir02

例子,有如下匹配规则:

location = / {
   echo "规则A";
}
location = /login {
   echo "规则B";
}
location ^~ /static/ {
   echo "规则C";
}
location ^~ /static/files {
    echo "规则X";
}
location ~ \.(gif|jpg|png|js|css)$ {
   echo "规则D";
}
location ~* \.png$ {
   echo "规则E";
}
location /img {
    echo "规则Y";
}
location / {
   echo "规则F";
}

那么产生的效果如下:

  • 访问根目录 /,比如 http://localhost/ 将匹配 规则A
  • 访问 http://localhost/login 将匹配 规则Bhttp://localhost/register 则匹配 规则F
  • 访问 http://localhost/static/a.html 将匹配 规则C
  • 访问 http://localhost/static/files/a.exe 将匹配 规则X,虽然 规则C 也能匹配到,但因为最大匹配原则,最终选中了 规则X。你可以测试下,去掉规则 X ,则当前 URL 会匹配上 规则C
  • 访问 http://localhost/a.gifhttp://localhost/b.jpg 将匹配 规则D 和 规则 E ,但是 规则 D 顺序优先,规则 E 不起作用,而 http://localhost/static/c.png 则优先匹配到 规则 C
  • 访问 http://localhost/a.PNG 则匹配 规则 E ,而不会匹配 规则 D ,因为 规则 E 不区分大小写。
  • 访问 http://localhost/img/a.gif 会匹配上 规则D,虽然 规则Y 也可以匹配上,但是因为正则匹配优先,而忽略了 规则Y
  • 访问 http://localhost/img/a.tiff 会匹配上 规则Y

访问 http://localhost/category/id/1111 则最终匹配到规则 F ,因为以上规则都不匹配,这个时候应该是 Nginx 转发请求给后端应用服务器,比如 FastCGI(php),tomcat(jsp),Nginx 作为反向代理服务器存在。

所以实际使用中,笔者觉得至少有三个匹配规则定义,如下:

# 直接匹配网站根,通过域名访问网站首页比较频繁,使用这个会加速处理,官网如是说。
# 这里是直接转发给后端应用服务器了,也可以是一个静态首页
# 第一个必选规则
location = / {
    proxy_pass http://tomcat:8080/index
}

# 第二个必选规则是处理静态文件请求,这是 nginx 作为 http 服务器的强项
# 有两种配置模式,目录匹配或后缀匹配,任选其一或搭配使用
location ^~ /static/ {
    root /webroot/static/;
}
location ~* \.(gif|jpg|jpeg|png|css|js|ico)$ {
    root /webroot/res/;
}

# 第三个规则就是通用规则,用来转发动态请求到后端应用服务器
# 非静态文件请求就默认是动态请求,自己根据实际把握
# 毕竟目前的一些框架的流行,带.php、.jsp后缀的情况很少了
location / {
    proxy_pass http://tomcat:8080/
}
rewrite 语法
  • last – 基本上都用这个 Flag
  • break – 中止 Rewirte,不再继续匹配
  • redirect – 返回临时重定向的 HTTP 状态 302
  • permanent – 返回永久重定向的 HTTP 状态 301

1、下面是可以用来判断的表达式:

-f 和 !-f 用来判断是否存在文件
-d 和 !-d 用来判断是否存在目录
-e 和 !-e 用来判断是否存在文件或目录
-x 和 !-x 用来判断文件是否可执行

2、下面是可以用作判断的全局变量

例:http://localhost:88/test1/test2/test.php?k=v
$host:localhost
$server_port:88
$request_uri:/test1/test2/test.php?k=v
$document_uri:/test1/test2/test.php
$document_root:D:\nginx/html
$request_filename:D:\nginx/html/test1/test2/test.php
redirect 语法
server {
    listen 80;
    server_name start.igrow.cn;
    index index.html index.php;
    root html;
    if ($http_host !~ "^star\.igrow\.cn$") {
        rewrite ^(.*) http://star.igrow.cn$1 redirect;
    }
}
防盗链
location ~* \.(gif|jpg|swf)$ {
    valid_referers none blocked start.igrow.cn sta.igrow.cn;
    if ($invalid_referer) {
       rewrite ^/ http://$host/logo.png;
    }
}
根据文件类型设置过期时间
location ~* \.(js|css|jpg|jpeg|gif|png|swf)$ {
    if (-f $request_filename) {
        expires 1h;
        break;
    }
}
禁止访问某个目录
location ~* \.(txt|doc)${
    root /data/www/wwwroot/linuxtone/test;
    deny all;
}
<think>好的,我现在需要详细回答用户关于Nginx中location匹配优先级的问题。根据用户提供的引用资料,我需要整理出一个清晰的结构,确保覆盖所有相关规则,并正确引用来源。 首先,用户引用了三篇资料,其中提到了不同的匹配符及其优先级顺序。我需要将这些信息整合成一个优先级列表,从高到低排列。比如,精准匹配(=)优先级最高,其次是前缀匹配(^~),然后是正则匹配(区分大小写的~和不区分的~*),最后是通用匹配(/)。同时要注意,多个正则匹配时按配置顺序生效,而通用匹配作为默认处理。 接下来,我需要解释每个匹配符的具体用法和例子,确保用户能够理解不同情况下的匹配过程。例如,精准匹配只适用于完全相同的URI,而前缀匹配则会检查以指定字符串开头的URI。对于正则表达式匹配,需要强调区分大小写和不区分大小写的区别,以及它们在配置中的顺序重要性。 然后,我需要提供配置示例来说明优先级如何实际应用。比如,当同时存在多个location块时,Nginx如何根据URI选择正确的匹配项。这里可以引用用户提供的示例,说明不同请求路径如何被不同的location块处理,并指出每个结果的依据。 此外,用户可能容易混淆的地方需要特别说明,比如前缀匹配和正则匹配优先级关系,以及正则匹配之间的顺序影响。这有助于避免常见的配置错误。 最后,按照用户的要求生成相关问题,这些问题应该涵盖配置优化、常见错误和应用场景,帮助用户进一步理解和应用所学知识。 整个过程中,需要确保使用正确的中文表达,遵循LaTeX格式要求,正确引用每个知识点对应的来源,并在末尾添加相关问题。同时,保持回答结构清晰,分点说明,让用户能够逐步理解location的优先级规则。</think>### Nginx Location匹配优先级规则详解 Nginx的`location`指令用于定义请求URI的匹配规则,其优先级规则直接影响请求路由的准确性。以下是具体优先级顺序和匹配逻辑: --- #### 一、优先级等级(从高到低) 1. **精准匹配 `=`** 优先级最高,仅当请求URI**完全等于**指定字符串时生效。 示例: ```nginx location = /test { ... } # 仅匹配URI为/test的请求 ``` 2. **前缀匹配 `^~`** 匹配以**指定字符串开头**的URI。若匹配成功,**停止后续正则匹配**,直接执行此规则[^1]。 示例: ```nginx location ^~ /static { ... } # 匹配/static、/static/img等 ``` 3. **正则匹配 `~`(区分大小写)** 按配置文件中的**书写顺序**匹配正则表达式,先匹配到的规则生效[^2]。 示例: ```nginx location ~ \.php$ { ... } # 匹配以.php结尾的URI(区分大小写) ``` 4. **正则匹配 `~*`(不区分大小写)** 同上,但忽略大小写。与`~`同级别,按配置顺序判断优先级。 示例: ```nginx location ~* \.jpg$ { ... } # 匹配.jpg、.JPG等 ``` 5. **通用匹配 `/`** 最低优先级,作为默认规则处理未匹配的请求,类似于`switch-case`的`default`分支[^3]。 示例: ```nginx location / { ... } # 匹配所有请求 ``` --- #### 二、匹配逻辑流程图 ```plaintext 请求URI → 检查精准匹配 → 命中则执行 ↓ 未命中 检查前缀匹配 → 命中则停止搜索 ↓ 未命中 按顺序检查正则匹配 → 命中则执行 ↓ 未命中 执行通用匹配 ``` --- #### 三、配置示例与验证 ```nginx server { listen 80; server_name example.com; # 规则1: 精准匹配 location = /login { return 200 "精准匹配生效"; } # 规则2: 前缀匹配 location ^~ /static { return 200 "前缀匹配生效"; } # 规则3: 正则匹配(区分大小写) location ~ \.php$ { return 200 "正则匹配生效(区分大小写)"; } # 规则4: 通用匹配 location / { return 200 "通用匹配生效"; } } ``` **验证结果:** - 请求 `/login` → 返回“精准匹配生效”(规则1)。 - 请求 `/static/logo.png` → 返回“前缀匹配生效”(规则2)。 - 请求 `/index.php` → 返回“正则匹配生效”(规则3)。 - 请求 `/about` → 返回“通用匹配生效”(规则4)。 --- #### 四、常见误区说明 1. **前缀匹配与正则匹配优先级** 即使正则表达式更具体(如`location ~ /static/img`),若已存在`location ^~ /static`,则优先执行前缀匹配[^1]。 2. **正则匹配的顺序敏感性** 若同时存在`location ~ \.png$`和`location ~ \.jpg$`,先定义的规则优先级更高。 --- 相关问题
评论 3
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

GoverChan

你的点滴的支持是我最大的动力!

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

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

余额充值