Nginx location 匹配规则详细解说(六)

简介: Nginx 的 location 实现了对请求的细分处理,有些 URI 返回静态内容,有些分发到后端服务器等,今天来彻底弄懂它的匹配规则

Nginxlocation 实现了对请求的细分处理,有些 URI 返回静态内容,有些分发到后端服务器等,今天来彻底弄懂它的匹配规则


一个最简单的 location 的例子如下


server {
server_name website.com;
location /admin/ {
# The configuration you place here only applies to
# http://website.com/admin/
}

}
复制代码


location 支持的语法 location [=|~|~*|^~|@] pattern { ... },乍一看还挺复杂的,来逐个看一下。


location修饰符类型


「=」 修饰符:要求路径完全匹配


server {
server_name website.com;
location = /abcd {
[…]
}

}
复制代码



「~」修饰符:区分大小写的正则匹配


server {
server_name website.com;
location ~ ^/abcd$ {
[…]
}

}
复制代码


^/abcd$这个正则表达式表示字符串必须以/开始,以$结束,中间必须是abcd



「~*」不区分大小写的正则匹配


server {
server_name website.com;
location ~* ^/abcd$ {
[…]
}

}
复制代码



「^~」修饰符:前缀匹配 如果该 location 是最佳的匹配,那么对于匹配这个 location 的字符串, 该修饰符不再进行正则表达式检测。注意,这不是一个正则表达式匹配,它的目的是优先于正则表达式的匹配


查找的顺序及优先级


当有多条 location 规则时,nginx 有一套比较复杂的规则,优先级如下:


  • 精确匹配 =
  • 前缀匹配 ^~(立刻停止后续的正则搜索)
  • 按文件中顺序的正则匹配 ~~*
  • 匹配不带任何修饰的前缀匹配。

这个规则大体的思路是



先精确匹配,没有则查找带有 ^~的前缀匹配,没有则进行正则匹配,最后才返回前缀匹配的结果(如果有的话)


如果上述规则不好理解,可以看下面的伪代码(非常重要)



function match(uri):
rv = NULL

if uri in exact_match:

return exact_match[uri]

if uri in prefix_match:

if prefix_match[uri] is '^~':
  return prefix_match[uri]
else:
  rv = prefix_match[uri] // 注意这里没有 return,且这里是最长匹配

if uri in regex_match:

return regex_match[uri] // 按文件中顺序,找到即返回

return rv
复制代码


一个简化过的Node.js写的代码如下


function ngx_http_core_find_location(uri, static_locations, regex_locations, named_locations, track) {
let rc = null;
let l = ngx_http_find_static_location(uri, static_locations, track);
if (l) {
if (l.exact_match) {
  return l;
}
if (l.noregex) {
  return l;
}
rc = l;

}
if (regex_locations) {

for (let i = 0 ; i < regex_locations.length; i ++) {
  if (track) track(regex_locations[i].id);
  let n = null;
  if (regex_locations[i].rcaseless) {
    n = uri.match(new RegExp(regex_locations[i].name));
  } else {
    n = uri.match(new RegExp(regex_locations[i].name), "i");
  }
  if (n) {
    return regex_locations[i];
  }
}

}

return rc;
}
复制代码


案例分析


案例 1


server {
server_name website.com;
location /doc {
    return 701; # 用这样的方式,可以方便的知道请求到了哪里
}
location ~* ^/document$ {
    return 702; # 用这样的方式,可以方便的知道请求到了哪里

}

}

curl -I website.com:8080/document
HTTP/1.1 702
复制代码


按照上述的规则,第二个会有更高的优先级


案例2


server {
server_name website.com;
location /document {
    return 701;
}
location ~* ^/document$ {
    return 702;
}

}
curl -I website.com:8080/document

复制代码


第二个匹配了正则表达式,优先级高于第一个普通前缀匹配


案例 3


server {
server_name website.com;
location ^~ /doc {
    return 701;
}
location ~* ^/document$ {
    return 702;
}

}
curl http://website.com/document
HTTP/1.1 701
复制代码


第一个前缀匹配^~命中以后不会再搜寻正则匹配,所以会第一个命中


案例 4


server {
server_name website.com;
location /docu {
    return 701;
}
location /doc {
    return 702;
}

}
复制代码


curl -I website.com:8080/document 返回 HTTP/1.1 701


server {
server_name website.com;
location /doc {
    return 702;
}
location /docu {
    return 701;
}

}
复制代码


curl -I website.com:8080/document 依然返回 HTTP/1.1 701


前缀匹配下,返回最长匹配的 location,与 location 所在位置顺序无关


案例 5


server {
listen 8080;
server_name website.com;

location ~ ^/doc[a-z]+ {
    return 701;
}

location ~ ^/docu[a-z]+ {
    return 702;
}

}
复制代码


curl -I website.com:8080/document 返回 HTTP/1.1 701


把顺序换一下


server {
listen 8080;
server_name website.com;

location ~ ^/docu[a-z]+ {
    return 702;
}

location ~ ^/doc[a-z]+ {
    return 701;
}

}
复制代码


curl -I website.com:8080/document 返回 HTTP/1.1 702


正则匹配是使用文件中的顺序,找到返回


云服务器ECS地址:阿里云·云小站

相关文章
|
2月前
|
自然语言处理 前端开发 应用服务中间件
nginx的Location语法规则
nginx的Location语法规则
|
3月前
|
应用服务中间件 nginx
Nginx系列教程(07) - Location正则表达式
Nginx系列教程(07) - Location正则表达式
34 0
|
7月前
|
前端开发 应用服务中间件 API
Nginx 反向代理 去除 路径匹配规则url
Nginx 反向代理 去除 路径匹配规则url
|
3月前
|
应用服务中间件 程序员 Shell
后端程序员不得不会的 Nginx 转发匹配规则
后端程序员不得不会的 Nginx 转发匹配规则
|
1月前
|
数据采集 应用服务中间件 nginx
百度搜索:蓝易云【nginx一些常用user_agent的匹配规则】
这个规则将会根据user_agent中是否包含"Android"、"iPhone"或"iPad"等关键词,将根目录的访问重定向到/mobile/目录下。需要注意的是,使用if指令可能会导致性能下降,建议尽量使用map模块进行user_agent的匹配。在编写规则时,应该确保匹配规则的准确性,以免误判或产生意外的结果。
46 0
|
4月前
|
应用服务中间件 nginx 数据安全/隐私保护
安装Nginx报错:make: *** 没有规则可以创建“default”需要的目标“build”。 停止。
安装Nginx报错:make: *** 没有规则可以创建“default”需要的目标“build”。 停止。
123 0
|
4月前
|
应用服务中间件 nginx
【Nginx】记录 nginx 配置文件中 location下根据 ua (user-agent) 判断移动端和电脑端不同浏览器来源
【Nginx】记录 nginx 配置文件中 location下根据 ua (user-agent) 判断移动端和电脑端不同浏览器来源
63 0
|
4月前
|
运维 Java 应用服务中间件
【Nginx用法】nginx location正则表达式写法,详解Nginx location 匹配规则(很详细哦)
【Nginx用法】nginx location正则表达式写法,详解Nginx location 匹配规则(很详细哦)
60 0
|
6月前
|
运维 应用服务中间件 nginx
【运维知识进阶篇】Nginx Location语法优先级详解
【运维知识进阶篇】Nginx Location语法优先级详解
66 0
|
应用服务中间件 nginx
Nginx - Location 匹配规则
Nginx - Location 匹配规则
159 0

相关产品

  • 云迁移中心