详解Nginx location 匹配规则
发布时间 - 2026-01-11 00:55:11 点击率:次语法规则

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将匹配 规则B ,http://localhost/register则匹配 规则F - 访问
http://localhost/static/a.html将匹配 规则C - 访问
http://localhost/static/files/a.exe将匹配 规则X ,虽然 规则C 也能匹配到,但因为最大匹配原则,最终选中了 规则X 。你可以测试下,去掉规则 X ,则当前 URL 会匹配上 规则C 。 - 访问
http://localhost/a.gif,http://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;
}
}
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。
# nginx
# location
# 匹配
# 匹配规则
# Nginx反向代理location和proxy_pass配置规则详细总结
# Nginx的location的常见规则优先级问题
# nginx 配置location匹配规则实例讲解
# Nginx Location指令URI匹配规则详解小结
# Nginx location匹配规则的方法示例
# nginx配置location总结location正则写法及rewrite规则写法
# 详解nginx配置location总结及rewrite规则写法
# Nginx服务器的location指令匹配规则详解
# nginx中的路径匹配location规则详解
# 配上
# 判断是否
# 后端
# 首页
# 重定向
# 是一个
# 这是
# 不带任何
# 都不
# 你可以
# 第一个
# 多个
# 如有
# 也能
# 而来
# 第二个
# 还未
# 这个时候
# 如是说
# 有两种
相关栏目:
【
网站优化151355 】
【
网络推广146373 】
【
网络技术251813 】
【
AI营销90571 】
相关推荐:
Laravel用户认证怎么做_Laravel Breeze脚手架快速实现登录注册功能
大连企业网站制作公司,大连2025企业社保缴费网上缴费流程?
网站制作大概要多少钱一个,做一个平台网站大概多少钱?
Laravel怎么做缓存_Laravel Cache系统提升应用速度的策略与技巧
厦门模型网站设计制作公司,厦门航空飞机模型掉色怎么办?
浅述节点的创建及常见功能的实现
瓜子二手车官方网站在线入口 瓜子二手车网页版官网通道入口
Win11搜索栏无法输入_解决Win11开始菜单搜索没反应问题【技巧】
在线ppt制作网站有哪些软件,如何把网页的内容做成ppt?
作用域操作符会触发自动加载吗_php类自动加载机制与::调用【教程】
如何快速登录WAP自助建站平台?
Laravel的路由模型绑定怎么用_Laravel Route Model Binding简化控制器逻辑
免费的流程图制作网站有哪些,2025年教师初级职称申报网上流程?
如何制作一个表白网站视频,关于勇敢表白的小标题?
php做exe能调用系统命令吗_执行cmd指令实现方式【详解】
ai格式如何转html_将AI设计稿转换为HTML页面流程【页面】
JS中使用new Date(str)创建时间对象不兼容firefox和ie的解决方法(两种)
Laravel如何创建自定义中间件?(Middleware代码示例)
Laravel DB事务怎么使用_Laravel数据库事务回滚操作
Laravel如何使用Eloquent ORM进行数据库操作?(CRUD示例)
大连网站制作公司哪家好一点,大连买房网站哪个好?
如何快速搭建高效WAP手机网站?
Laravel怎么使用Intervention Image库处理图片上传和缩放
怎么用AI帮你为初创公司进行市场定位分析?
网站制作免费,什么网站能看正片电影?
Laravel怎么实现模型属性转换Casting_Laravel自动将JSON字段转为数组【技巧】
微信h5制作网站有哪些,免费微信H5页面制作工具?
北京企业网站设计制作公司,北京铁路集团官方网站?
Laravel Pest测试框架怎么用_从PHPUnit转向Pest的Laravel测试教程
如何将凡科建站内容保存为本地文件?
Laravel如何处理和验证JSON类型的数据库字段
googleplay官方入口在哪里_Google Play官方商店快速入口指南
Laravel如何处理异常和错误?(Handler示例)
西安专业网站制作公司有哪些,陕西省建行官方网站?
Laravel如何配置.env文件管理环境变量_Laravel环境变量使用与安全管理
利用python获取某年中每个月的第一天和最后一天
Laravel如何使用Seeder填充数据_Laravel模型工厂Factory批量生成测试数据【方法】
手机软键盘弹出时影响布局的解决方法
Laravel Docker环境搭建教程_Laravel Sail使用指南
购物网站制作费用多少,开办网上购物网站,需要办理哪些手续?
如何用ChatGPT准备面试 模拟面试问答与职场话术练习教程
Laravel distinct去重查询_Laravel Eloquent去重方法
制作网站软件推荐手机版,如何制作属于自己的手机网站app应用?
EditPlus中的正则表达式 实战(4)
大同网页,大同瑞慈医院官网?
Gemini怎么用新功能实时问答_Gemini实时问答使用【步骤】
如何快速搭建自助建站会员专属系统?
绝密ChatGPT指令:手把手教你生成HR无法拒绝的求职信
Laravel如何与Docker(Sail)协同开发?(环境搭建教程)
猪八戒网站制作视频,开发一个猪八戒网站,大约需要多少?或者自己请程序员,需要什么程序员,多少程序员能完成?

