Nginx中location规则 与 URL重写(rewrite)详解

news2025/3/13 8:44:53

1.Nginx中location与rewrite

1.1 location与rewrite常用的正则表达式

符号作用
^匹配输入字符串的起始位置
匹配输入字符串的结束位置
*匹配前面的字符零次或多次。如“ol*”能匹配“o”及“ol”、“oll”
匹配前面的字符一次或多次。如“ol+”能匹配“ol”及“oll”、“olll”,但不能匹配“o”
?匹配前面的字符零次或一次,例如“do(es)?”能匹配“do”或者“does”,”?”等效于”{0,1}”
.匹配除“\n”之外的任何单个字符,若要匹配包括“\n”在内的任意字符,请使用诸如“[.\n]”之类的模式
\将后面接着的字符标记为一个特殊字符或一个原义字符或一个向后引用。如“\n”匹配一个换行符,而“\$”则匹配“$”
\d匹配纯数字[0-9]   \s :空白符    \w :任意单词字符包括下划线[A-Za-z0-9_]
{n}重复 n 次
{n,}重复 n 次或更多次
{n,m}重复 n 到 m 次
[ ]定义匹配的字符范围
[c]匹配单个字符 c
[a-z]匹配 a-z 小写字母的任意一个
[a-zA-Z0-9]匹配所有大小写字母或数字
()表达式的开始和结束位置
|或预算

1.2  location与rewrite的联系和区别 

rewrite :对访问的域名或者域名内的URL路径地址重写
location:对访问的路径做访问控制或者代理转发

从功能看 rewrite 和 location 似乎有点像,都能实现跳转,主要区别在于 rewrite 是在同一域名内更改获取资源的路径,而 location 是对一类路径做控制访问或反向代理,还可以proxy_pass 到其他机器

2.location的匹配规则 

 2.1 location的匹配分类与常用规则

location 大致可以分为三类:精准匹配" location = / {...} "   ,一般匹配" location / {...} "和正则匹配" location ~ / {...} "。在nginx.conf的配置文件中location默认使用的是通用匹配 "location /{.....}"

location的匹配规则规则作用
进行普通字符精确匹配,也就是完全匹配
^~表示普通字符匹配。使用前缀匹配。如果匹配成功,则不再匹配其它正则匹配的location。
区分大小写的正则匹配。
~*不区分大小写的正则匹配。
!~ 区分大小写的正则匹配取非。
!~* 不区分大小写的正则匹配取非。

2.2 location 示例说明与规则优先实验

示例一:精准匹配 

location = / {
root /var/www/html
 }

 =为精确匹配 / ,主机名后面不能带任何字符串,例如想访问该location制定的匹配网页时,只能访问该主机IP或域名下的"/"(网页也只能存放在/var/www/html/ 下),而像"/abc,/data,/test"这一类和location等于号后面路径有任何一点差别的,都不会被匹配到。该匹配方式优先级最高,一旦匹配成功则立即采用
 

示例二:通用匹配 


location / {
root /var/www/html
}

 因为所有的地址都以 / 开头,所以这条规则将匹配到所有请求.用户只要是能访问到该主机的IP或域名,即使不输入路径,也能匹配到相关的网页信息。(文件只要是存放在/var/www/html 中,或则更深的目录也能被匹配到。例如:/var/www/html/test/ 下存放网页,用户访问/test 也能够匹配访问到相关网页)该匹配方式为location匹配中优先级最低的方式,只有其他location匹配方式均为成功,才会采用该方式
 

示例三:一般匹配 


#匹配规则a:
location /documents/ {
root  /var/www/html
index index.html
}
 
#匹配规则b:
location /documents/abc {
root  /aaa/bbb/ccc
index index.html
}

 

网页准备

 访问结果

 

结论:一般匹配时,location后面跟着的路径长度越长 ,则匹配的优先级越高

示例四: 正则匹配与前缀^~匹配

在 /var/www/html/images   下存放了一张 jpg格式的图片

#前缀^~匹配
location ^~ /images/ {
root /var/www/html
 
}
 
#正则匹配
location ~* \.(gif|jpg|jpeg)$ {
 /var/www/html
}

location ^~ /images/ {}匹配任何以 /images/ 开头的地址,匹配符合以后,停止往下搜索正则,采用这一条 

匹配所有以 gif、jpg或jpeg 结尾的请求。然而,所有请求 /images/ 下的图片会被 location ^~ /images/ 处理,因为 ^~ 的优先级更高,所以到达不了这一条正则 

总结:^~ 前缀匹配是一种针对正则匹配的特殊的一般匹配方式 。前缀^~匹配在上面时:当访问的与前缀^~匹配相关时,就会停止正则匹配,采用该前缀匹配。正则匹配在上面时:当正则匹配匹配到请求时,还会继续查看其他的正则匹配。当遇到前缀^~匹配则会采用前缀匹配,而放弃该正则匹配。此外同是正则匹配的规则,看上下顺序决定优先级顺序

示例五:正则匹配与一般匹配 

正则匹配
location ~ /images/abc {
root /var/www/html
}
 
#location后面路径更长的一般匹配
location /images/abc/1.html {
root /aaa/bbb/ccc

 匹配/images/abc/1.html 文件,location /images/abc/1.html 和正则location  ~ /images/abc 相比,正则优先级更高。匹配的网页是正则中的网页

示例六:前缀^~匹配与一般匹配 


location ^~ /images/abc {
root /var/www/html
 
}
 
location /images/abc/1.html {
root /aaa/bbb/ccc

 因为前缀^~匹配时一般匹配的一种特殊存在,但是与一般匹配比较时,依旧遵循一般匹配的路径长度决定优先级的原则。 匹配/images/abc/1.html 文件,访问页面是下面的长路径一般匹配规则中设置的网页

2.3 location匹配规则顺序总结 

在所有条件相同的条件下(location后面路径长度相同)优先级比较:  (location = 完整路径) > (location ^~ 路径) > (location ~,~* 正则顺序) > (location 部分起始路径) > (location /)

location匹配规则优先通用的总结 :

  (1) 存在精准匹配时,直接采用

(2)在没有精准匹配的情况下,先看前缀匹配的长度,然后根据最长的前缀匹配的优先级去确定是否再去看其它正则匹配location。
 

(3)如果最长的前缀匹配带有 ^~ 则不再看其它正则匹配location,如果最长的前缀匹配是没有修饰符的一般匹配则会再看其它正则匹配location

(4)   前缀匹配看长度,最长的优先匹配
正则匹配看上下顺序,由上往下依次匹配,当有匹配成功时候,停止匹配,按当前匹配规则处理请求

(5)只有在精准、前缀、正则、一般 都没有匹配到的时候才会看通用匹配

2.4 location的运用拓展 

 实际网站使用中,至少有三个匹配规则定义:

 #第一个必选规则
直接匹配网站根目录首页,通过域名访问网站首页比较频繁,使用这个会加速处理,比如说官网。
可以是一个静态首页,也可以直接转发给后端应用服务器


location = /index.html {
    root   html;
	index  index.html index.htm;
}

 #第二个必选规则是处理静态文件请求,这是nginx作为http服务器的强项
有两种配置模式,目录匹配或后缀匹配,任选其一或搭配使用


location ^~ /static/ {
    root /webroot/;
}
 
location ~* \.(gif|jpg|jpeg|png|css|js|ico)$ {
    root /webroot/res/;
}

#第三个规则就是通用规则,比如用来转发带.php、.jsp后缀的动态请求到后端应用服务器
非静态文件请求就默认是动态请求 

location / {
    proxy_pass http://tomcat_server;
}

3.rewrite 重写 

3.1 rewrite 的功能介绍 


rewrite功能就是,使用nginx提供的全局变量或自己设置的变量,结合正则表达式和标记位实现URL重写以及重定向。
比如:更换域名后需要保持旧的域名能跳转到新的域名上、某网页发生改变需要跳转到新的页面、网站防盗链等等需求。

rewrite只能放在server{},location{},if{}中,并且默认只能对域名后边的除去传递的参数外的字符串起作用,
例如 http://www.yang.com/abc/bbs/index.php?a=1&b=2 只对/abc/bbs/index.php重写。

 3.2  rewrite的跳转实现与执行顺序

rewrite跳转实现:
Nginx:通过ngx_http_rewrite_module 模块支持URL重写、支持if条件判断,但不支持else
跳转:从一个 location跳转到另一个location,循环最多可以执行10次,超过后nginx将返回500错误
PCRE支持:perl兼容正则表达式的语法规则匹配
重写模块 set 指令:创建新的变量并设其值

 

rewrite 执行顺序如下:
(1) 执行 server 块里面的 rewrite 指令。
(2) 执行 location 匹配。
(3) 执行选定的 location 中的 rewrite 指令

3.3 rewrite在nginx.conf 中的语法格式

语法格式:rewrite <regex> <replacement> [flag];

regex :表示正则匹配规则。
replacement :表示跳转后的内容。
flag :表示 rewrite 支持的 flag 标记。

 ###flag标记说明###
last :本条规则匹配完成后,不终止重写后的url匹配,一般用在 server 和 if 中。
break :本条规则匹配完成即终止,终止重写后的url匹配,一般使用在 location 中。
redirect :返回302临时重定向,浏览器地址会显示跳转后的URL地址。
permanent :返回301永久重定向,浏览器地址栏会显示跳转后的URL地址。

3.4 rewrite运用示例 

示例一:基于域名的跳转 

需求:某公司旧域名www.yang.com有业务需求变更,需要使用新域名www.wang.com代替,但是旧域名不能废除,需要跳转到新域名上,而且后面的参数保持不变。

配置设置:


vim /usr/local/nginx/conf/nginx.conf
server {
	listen       80;
	server_name  www.kgc.com;		#域名修改	
	charset utf-8;
	access_log  /var/log/nginx/www.yang.com-access.log;		#日志修改
	location / {
	#添加域名重定向
        if ($host = 'www.yang.com'){						#$host为rewrite全局变量,代表请求主机头字段或主机名
			rewrite ^/(.*)$ http://www.wang.com/$1 permanent;	#$1为正则匹配的内容,即“域名/”之后的字符串
        }
        root   html;
        index  index.html index.htm;
    }
}

其他操作步骤: 

echo "192.168.73.105  www.yang.com www.wang.com" >> /etc/hosts
systemctl restart nginx
浏览器输入模拟访问 http://www.yang.com/test/1.html(虽然这个请求内容是不存在的)
 

实验结果:

会跳转到www.wang.com/test/1.html,查看元素可以看到返回301,实现了永久重定向跳转,而且域名后的参数也正常跳转。

示例二:基于客户端 IP 访问跳转

需求:某公司业务新版本上线,要求所有 IP 访问任何内容都显示一个固定维护页面,只有公司 IP :192.168.73.105(指定的IP)访问正常。

配置设置 :

vim /usr/local/nginx/conf/nginx.conf
server {
	listen       80;
	server_name  www.kgc.com;		#域名修改	
	charset utf-8;
	access_log  /var/log/nginx/www.yang.com-access.log;		#日志修改
 
	#设置是否合法的IP标记
    set $rewrite true;							#设置变量$rewrite,变量值为boole值true
    #判断是否为合法IP
	if ($remote_addr = "192.168.73.105"){		#当客户端IP为192.168.73.105时,将变量值设为false,不进行重写
        set $rewrite false;
    }
	#除了合法IP,其它都是非法IP,进行重写跳转维护页面
    if ($rewrite = true){						#当变量值为true时,进行重写
        rewrite (.+) /weihu.html;				#将域名后边的路径重写成/weihu.html后转发,例如www.kgc.com/weihu.html
    }
    location = /weihu.html {
        root /var/www/html;						#网页返回/var/www/html/weihu.html的内容
    }
	
	location / {
        root   html;
        index  index.html index.htm;
    }
}

其他操作步骤:


mkdir -p /var/www/html/  #创建维护网页目录
echo "<h1>We are maintaining now!</h1>" > /var/www/html/weihu.html  #添加维护网页内容 
systemctl restart nginx    #重启nginx服务
 

访问测试结果:

 只有 IP 为 192.168.73.105 能正常访问,其它地址都是维护页面

注意:如果rewrite (.+) /weihu.html; 换成rewrite (.+) /weihu.html permanent; 的话,若不是 192.168.73.105 的主机访问会使浏览器修改请求访问的 URL 成 http://www.yang.com/weihu.html 再请求访问,这样就会进入一直在 rewrite 的死循环,访问请求会一直被重写成 http://www.yang.com/weihu.html 再请求访问 
 

 示例三:基于旧域名跳转到新域名后面加目录

需求:现在访问的是 http://yang.wang.com/post/,现在需要将这个域名下面的访问都跳转到http://www.yang.com/bbs/post/ 


vim /usr/local/nginx/conf/nginx.conf
server {
	listen       80;
	server_name  yang.wang.com www.yang.com;		#域名修改	
	charset utf-8;
	access_log  /var/log/nginx/www.yang.com-access.log;
	#添加
	location /post {
        rewrite (.+) http://www.yang.com/bbs$1 permanent;		#这里的$1为位置变量,代表/post
    }
	
	location / {
        root   html;
        index  index.html index.htm;
    }
}

其它设置

mkdir -p /usr/local/nginx/html/bbs/post
echo "this is 1.html"  >> /usr/local/nginx/html/bbs/post/1.html
echo "192.168.73.105 yang.wang.com"  >> /etc/hosts
systemctl restart nginx
 

访问结果:

使用浏览器访问 http://yang.wang.com/post/1.html 跳转到http://www.yang.com/bbs/post/1.html 

示例四:基于参数匹配的跳转

 需求:现在访问http://www.yang.com/100-(100|200)-100.html 跳转到http://www.yang.com页面

vim /usr/local/nginx/conf/nginx.conf
server {
	listen       80;
	server_name  www.yang.com;		#域名修改	
	charset utf-8;
	access_log  /var/log/nginx/www.yang.com-access.log;
	
	if ($request_uri ~ ^/100-(100|200)-(\d+).html$) {
        rewrite (.+) http://www.yang.com permanent;
    }
 
	location / {
        root   html;
        index  index.html index.htm;
    }
}

变量说明:
$request_uri:包含请求参数的原始URI,不包含主机名,如:http://www.yang.com/abc/bbs/index.html?a=1&b=2 中的 /abc/bbs/index.php?a=1&b=2
$uri:这个变量指当前的请求URI,不包括任何参数,如:/abc/bbs/index.html
$document_uri:与$uri相同,这个变量指当前的请求URI,不包括任何传递参数,如:/abc/bbs/index.html

 重启nginx服务,访问结果:

使用浏览器访问 http://www.yang.com/100-200-100.html 或 http://www.kgc.com/100-100-100.html 跳转到http://www.yang.com页面。

示例五:基于目录下所有 php 结尾的文件跳转 

需求:要求访问 http://www.yang.com/upload/123.php 跳转到首页。

vim /usr/local/nginx/conf/nginx.conf
server {
	listen       80;
	server_name  www.yang.com;		#域名修改	
	charset utf-8;
	access_log  /var/log/nginx/www.yang.com-access.log;
	
	location ~* /upload/.*\.php$ {
        rewrite (.+) http://www.yang.com permanent;
    }
 
	location / {
        root   html;
        index  index.html index.htm;
    }
}
 
 
systemctl restart nginx

访问结果:

浏览器访问 http://www.yang.com/upload/123.php 跳转到http://www.yang.com页面。

示例六:基于最普通一条 url 请求的跳转 

 需求:要求访问一个具体的页面如 http://www.yang.com/abc/123.html 跳转到首页

vim /usr/local/nginx/conf/nginx.conf
server {
	listen       80;
	server_name  www.yang.com;		#域名修改	
	charset utf-8;
	access_log  /var/log/nginx/www.yang.com-access.log;
	
    location ~* ^/abc/123.html {
        rewrite (.+) http://www.yang.com permanent;
    }
 
	location / {
        root   html;
        index  index.html index.htm;
    }
}
 
 
systemctl restart nginx

访问结果:

浏览器访问 http://www.yang.com/abc/123.html 跳转到http://www.yang.com页面。

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.coloradmin.cn/o/433182.html

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈,一经查实,立即删除!

相关文章

微信为什么使用 SQLite 保存聊天记录

SQLite “只是”一个库&#xff0c;它不是传统意义上的服务器。因此&#xff0c;在某些场合下&#xff0c;它确实不合适。但是&#xff0c;在相当多的其他场合&#xff0c;它却是最合适的选择。SQLite 号称是部署和使用最广泛的数据库引擎。我认为这很有可能&#xff0c;因为 S…

《PyTorch 深度学习实践》第10讲 卷积神经网络(基础篇)

文章目录1 卷积层1.1 torch.nn.Conv2d相关参数1.2 填充&#xff1a;padding1.3 步长&#xff1a;stride2 最大池化层3 手写数字识别该专栏内容为对该视频的学习记录&#xff1a;【《PyTorch深度学习实践》完结合集】 专栏的全部代码、数据集和课件全放在个人GitHub了&#xff…

SpringCloud之OpenFeign介绍案例+相关面试题

概述 OpenFeign是一个声明式的WEB服务客户端&#xff0c;它使WEB服务客户端变得更加容易。具有可插拔的注解支持&#xff0c;SpringCloud中添加了SpringMVC注解的支持。SpringCloud中集成了Ribbon和Eureka&#xff0c;以及SpringCloud LoadBalance&#xff0c;以便在使用Feign时…

C++数据结构:树

树 树是一种数据结构&#xff0c;它是n(n>0)个节点的有限集。n0时称为空树。n>0时&#xff0c;有限集的元素构成一个具有层次感的数据结构。 根 有且仅有一个结点的非空树&#xff0c;那个结点就是根。 A就是上面树的根节点 子树 在一棵非空树中&#xff0c;除根外&a…

由浅入深,一文彻底搞懂Mybatis+面试题分享

mybatis常见面试题链接&#xff1a;2023年-Mybatis常见面试题_是Smoky呢的博客-CSDN博客 MVC架构模式和三层架构 在说Mybatis之前&#xff0c;需要知道MVC架构模式和三层架构的这种思想 MVC架构模式 M&#xff1a;Model&#xff0c;数据层。都是和数据相关&#xff0c;比如实体…

MongoDB实现---事务机制

事务机制 原子性是MongoDB实现事务的难点&#xff0c;隔离性和持久性则是MongoDB事务机制的亮点 ACID支持&#xff1a;由于前面说过MongoDB是基于大数据、提供高度可扩展和高可用&#xff1b;所以其事务机制不仅仅是一般ACID还是结合了BASE理论下的ACID 原子性&#xff1a;保…

键盘录入及标识符

键盘录入 键盘录入介绍&#xff1a; ●为什么要有键盘录入? 目的&#xff1a;为了让我们操作的数据,变得更加灵活 举例&#xff1a;int a10; 这里a虽然是个变量&#xff0c;但记录的值&#xff0c;却是手动写死的。 提问&#xff1a;能不能让a变量记录的值&#xff0c;灵活…

Elasticsearch-mapping

1.Mapping基本概念 Mapping 也称之为映射&#xff0c;定义了 ES 的索引结构、字段类型、分词器等属性&#xff0c;是索引必不可少的组成部分。 ES 中的 mapping 有点类似与RDB中“表结构”的概念&#xff0c;在 MySQL 中&#xff0c;表结构里包含了字段名称&#xff0c;字段的…

# IMAGE - Image Perimeters

# IMAGE - Image Perimeters ## 题面翻译 ### 描述 给出一张由"x"和"."组成的矩阵。每个"x"可以向上下左右及两个斜对角进行连通&#xff0c;请问由某个点开始的"x"&#xff0c;它所连通的图形的周长为多少。 ### 输入 整个测试有多…

SpringBoot 整合ChatGPT API项目实战

准备工作 &#xff08;1&#xff09;已成功注册 OpenAI 的账号。 &#xff08;2&#xff09;创建 API KEY&#xff0c;这个 API KEY 是用于 HTTP 请求身份验证的&#xff0c;可以创建多个。 注意这个创建之后需要马上复制好保存&#xff0c;关闭弹框之后就看不到了。 &#xf…

excel的导入导出的两种方案 (1 EasyExcel 2 Hutool工具类)

文章目录 前言1 EasyExcel的导入导出导出1 导入依赖2 项目中的CourseEntity实体类3 CoureseVo VO类 (对CourseEntity进行EasyExcel导入导出操作)4 导出代码的编写 并最终测试导出效果5 (前端内容 可选)通过vue按钮点击 导出 导入1 导入依赖 跟导出相同2 创建回调监听器3 编写导…

1、Typescript基础入门与环境搭建

1、开发工具安装与基本配置 1.1、软件下载安装 如果你还没有使用过VSCode&#xff0c;当然先要去官网下载了。下载完成后双击安装&#xff0c;一直下一步即可。 1.2、编辑器汉化 如果你英语不是很好&#xff0c;配置中文版界面是很有必要的&#xff0c;安装个插件就可以了。打…

虚化背景 - 基于镜头模糊滤镜的深度映射

镜头模糊 Lens Blur等滤镜可以使用深度映射 Depth Map来设置像素在视觉上的前后关系。因此&#xff0c;常利用深度映射来创建真实感虚化效果&#xff0c;或者进行超越镜头的任意虚化处理。 ◆ ◆ ◆ 基于 Alpha 通道的深度映射关系 一般可通过建立 Alpha 通道或图层蒙版来创建…

【算法基础】DP第三弹 —— 竞赛篇

一、计数问题 (一)Question 1. 问题描述 2. Input 输入包含多组测试数据。每组测试数据占一行,包含两个整数 a 和 b。当读入一行为 0 0 时,表示输入终止,且该行不作处理。(0 < a, b < 100000000) 3. Output 每组数据输出一个结果,每个结果占一行。每个结果包…

MIPI D-PHYv2.5笔记(21) -- Forward High-Speed Data Transmission Timing

声明&#xff1a;作者是做嵌入式软件开发的&#xff0c;并非专业的硬件设计人员&#xff0c;笔记内容根据自己的经验和对协议的理解输出&#xff0c;肯定存在有些理解和翻译不到位的地方&#xff0c;有疑问请参考原始规范看 DDR时钟差分信号和Data差分信号的时序关系如下图所示…

计及调度经济性的光热电站储热容量配置方法【IEEE30节点】(Matlab代码实现)

&#x1f4a5; &#x1f4a5; &#x1f49e; &#x1f49e; 欢迎来到本博客 ❤️ ❤️ &#x1f4a5; &#x1f4a5; &#x1f3c6; 博主优势&#xff1a; &#x1f31e; &#x1f31e; &#x1f31e;博客内容尽量做到思维缜密&#xff0c;逻辑清晰&#xff0c;为了方便读者。 …

计算机网络简史

ARPANET的发展 互联网最早的雏形 1931-ARPANET设计 互联网名人堂 1965-packet switching(分包交换) 1969 第一个RFC(Request for Comments)(开始通过APPANET发布)第一个接口信息处理单元&#xff08;Interface Message Processor&#xff09;&#xff08;下图&#xff0c;节…

ChatGPT时代:我们可能站到了自然语言编程的大门口

ChatGPT大火&#xff0c;我现在有种感觉&#xff1a;我们可能站到了自然语言编程的门口&#xff0c;一脚下去&#xff0c;也许能把门踹开。 当然&#xff0c;也可能会踢到一块铁板。 回顾我们的编程之路&#xff0c;基本上就是一个编程门槛不断降低的历史。 最早的一批前辈们…

wireshark抓包工具的使用

前言 ①wireshark是非常流行的网络封包分析软件&#xff0c;功能十分强大。可以截取各种网络封包&#xff0c;显示网络封包的详细信息。 ②使用wireshark的人必须了解网络协议&#xff0c;否则就看不懂wireshark。 ③为了安全考虑&#xff0c;wireshark只能查看封包&#xff…

【Linux】进程通信之管道通信详解

&#x1f34e;作者&#xff1a;阿润菜菜 &#x1f4d6;专栏&#xff1a;Linux系统编程 一、什么是管道通信 1. 管道通信是一种在进程间传递数据的方法 其实管道通信是Unix中最古老的进程间通信的形式了&#xff1a; 管道通信是一种进程间通信的方式&#xff0c;它可以让一个进…