Nginx中的location匹配与rewrite跳转

已于 2022-06-12 20:51:03 修改
阅读量710 收藏
点赞数
文章标签： nginx
于 2022-06-12 15:38:30 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/Z__Cheng/article/details/125235627
版权
本文详细解析了Nginx中location的匹配规则、优先级和实战应用，同时介绍了Rewrite模块的跳转场景、实现方式以及各种跳转示例，包括基于域名、IP、旧域名、参数匹配、PHP文件和普通URL的重定向策略。
摘要由CSDN通过智能技术生成

Nginx中的location匹配与rewrite跳转

一、常用的Nginx 正则表达式

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

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

二、Loacation解读

（一）、location 分类

精准匹配：location = / {}
一般匹配：location / {} 
正则匹配：location ~ / {}

（二）、location 常用的匹配规则

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

（三）、location 优先级

首先精确匹配 =
其次前缀匹配 ^~
其次是按文件中顺序的正则匹配 ~或~*
然后匹配不带任何修饰的前缀匹配
最后是交给 / 通用匹配

（四）、location 示例说明

（1）location = / {}
=为精确匹配 / ，主机名后面不能带任何字符串，比如访问 / 和 /data，则 / 匹配，/data 不匹配
再比如 location = /abc，则只匹配/abc ，/abc/或 /abcd不匹配。若 location  /abc，则即匹配/abc 、/abcd/ 同时也匹配 /abc/。

（2）location / {}
因为所有的地址都以 / 开头，所以这条规则将匹配到所有请求 比如访问 / 和 /data, 则 / 匹配， /data 也匹配，
但若后面是正则表达式会和最长字符串优先匹配（最长匹配）

（3）location /documents/ {}
匹配任何以 /documents/ 开头的地址，匹配符合以后，还要继续往下搜索其它 location
只有其它 location后面的正则表达式没有匹配到时，才会采用这一条

（4）location /documents/abc {}
匹配任何以 /documents/abc 开头的地址，匹配符合以后，还要继续往下搜索其它 location
只有其它 location后面的正则表达式没有匹配到时，才会采用这一条

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

（6）location ~* \.(gif|jpg|jpeg)$ {}
匹配所有以 gif、jpg或jpeg 结尾的请求
然而，所有请求 /images/ 下的图片会被 location ^~ /images/ 处理，因为 ^~ 的优先级更高，所以到达不了这一条正则

（7）location /images/abc {}
最长字符匹配到 /images/abc，优先级最低，继续往下搜索其它 location，会发现 ^~ 和 ~ 存在

（8）location ~ /images/abc {}
匹配以/images/abc 开头的，优先级次之，只有去掉 location ^~ /images/ 才会采用这一条

（9）location /images/abc/1.html {}
匹配/images/abc/1.html 文件，如果和正则 ~ /images/abc/1.html 相比，正则优先级更高

优先级总结：
(location =) > (location 完整路径) > (location ^~ 路径) > (location ~,~* 正则顺序) > (location 部分起始路径) > (location /)

（五）、实际网站使用中，至少有三个匹配规则定义

第一个必选规则

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

第二个必选规则

是处理静态文件请求，这是nginx作为http服务器的强项
有两种配置模式，目录匹配或后缀匹配,任选其一或搭配使用
location ^~ /static/ {
    root /webroot/static/;
}

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

第三个规则

就是通用规则，比如用来转发带.php、.jsp后缀的动态请求到后端应用服务器
非静态文件请求就默认是动态请求
location / {
    proxy_pass http://tomcat_server;

三、Rewrite概述

（一）、Rewrite跳转场景

调整用户浏览的 URL，看起来更规范，合乎开发及产品人员的需求。
为了让搜索引擎搜录网站内容及用户体验更好，企业会将动态URL地址伪装成静态地址提供服务。
网址换新域名后，让旧的访问跳转到新的域名上。例如，访问京东的 360buy.com 会跳转到 jd.com。
服务端某些业务调整，比如根据特殊变量、目录、客户端的信息进行 URL 调整等

（二）、Rewrite跳转实现

Nginx是通过ngx_http_rewrite_module模块支持url重写、支持if条件判断，但不支持else。另外该模块需要PCRE支持，应在编译Nginx时指定 PCRE支持，默认已经安装。根据相关变量重定向和选择不同的配置，从一个location跳转到另一个location，不过这样的循环最多可以执行10次，超过后Nginx将返回500错误。同时，重写模块包含set指令，来创建新的变量并设l其值，这在有些情景下非常有用的，如记录条件标识、传递参数到其他location、记录做了什么等等。rewrite功能就是，使用Nginx提供的全局变量或自己设置的变量，结合正则表达式和标志位实现url的重写以及重定向。

（三）、Rewrite实际场景

1、Nginx跳转需求的实现方式

使用rewrite进行匹配跳转
使用if匹配全局变量后跳转
使用location匹配再跳转

rewrite放在 server{}，if{}，location{} 段中
location只对域名后边的除去传递参数外的字符串起作用

对域名或参数字符串
使用if全局变量匹配
使用proxy_pass反向代理

四、rewrite 示例

rewrite功能就是，使用nginx提供的全局变量或自己设置的变量，结合正则表达式和标志位实现url重写以及重定向。
rewrite只能放在server{},location{},if{}中，并且默认只能对域名后边的除去传递的参数外的字符串起作用，
例如 http://www.zc.com/a/we/index.php?id=1&u=str 只对/a/we/index.php重写。

（一）、rewrite 执行顺序如下

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

语法rewrite <regex> <replacement> [flag];
regex ：表示正则匹配规则。
replacement ：表示跳转后的内容。
flag ：表示 rewrite 支持的 flag 标记

flag标记说明
last： 本条规则匹配完成后，继续向下匹配新的location URI规则，一般用在 server 和 if 中。
break ： 本条规则匹配完成即终止，不再匹配后面的任何规则，一般使用在 location 中。
redirect ： 返回302临时重定向，浏览器地址会显示跳转后的URL地址。
permanent ： 返回301永久重定向，浏览器地址栏会显示跳转后的URL地址。

（二）、rewrite 示例

1、基于域名的跳转

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

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

echo "192.168.140.70 www.zc.com www.zsy.com" >> /etc/hosts
systemctl restart nginx

在这里插入图片描述

浏览器输入模拟访问 http://www.zc.com
会跳转到www.zsy.com，查看元素可以看到返回301，实现了永久重定向跳转，而且域名后的参数也正常跳转。

在这里插入图片描述
在这里插入图片描述

2、基于客户端 IP 访问跳转

公司业务新版本上线，要求所有 IP 访问任何内容都显示一个固定维护页面，只有公司 IP ：192.168.140.70的访主机访问正常可以访问正常。

vim /usr/local/nginx/conf/nginx.conf
server {
	listen       80;
	server_name  www.zc.com;		#域名修改	
	charset utf-8;
	#access_log  /var/log/nginx/zc.com-access.log ;		#日志修改

	#设置是否合法的IP标记
	set $rewrite true;							#设置变量$rewrite，变量值为boole值true
	#判断是否为合法IP
	if ($remote_addr = "192.168.140.70"){		#当客户端IP为192.168.140.70时，将变量值设为false，不进行重写
	    set $rewrite false;
	}
	#除了合法IP，其它都是非法IP，进行重写跳转维护页面
	if ($rewrite = true){						#当变量值为true时，进行重写
	    rewrite (.+) /weihu.html;				#重写在访问IP后边插入/weihu.html，例如192.168.140.70/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/
cd /var/www/html
vim weihu.html
echo <h1>''正在维护</h1>'' > /var/www/html/weihu.html
systemctl restart nginx

只有 IP 为 192.168.140.70的能主机能正常访能正常访问，其它地址主机访问都是维护页面
在这里插入图片描述
在这里插入图片描述

在这里插入图片描述

3、基于旧域名跳转到新域名后面加目录

现在访问的是 http://zc.com，现在需要将这个域名下面的访问都跳转到http://www.zc.com/bbs


```bash
vim /usr/local/nginx/conf/nginx.conf
server {
	listen       80;
	server_name  zc.com;		#域名修改	
	charset utf-8;
	access_log  /var/log/nginx/zc-access.log ;
	#添加
	location /post {
        rewrite (.+) http://www.zc.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.140.70 www.zc.com"  >> /etc/hosts
systemctl restart nginx

在这里插入图片描述
在这里插入图片描述
在这里插入图片描述

4、基于参数匹配的跳转

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

vim /usr/local/nginx/conf/nginx.conf
server {
	listen       80;
	server_name  www.zc.com;		#域名修改	
	charset utf-8;
	access_log  /var/log/nginx/www.zc.com-access.log ;
	

	if ($request_uri ~ ^/100-(100|200)-(\d+).html$) {
	    rewrite (.*) http://www.zc.com permanent;
	}
	
	location / {
	    root   html;
	    index  index.html index.htm;
	}
}

systemctl restart nginx

在这里插入图片描述
使用浏览器访问 http://www.zc.com/100-200-100.html 或 http://www.zc.com/100-100-100.html 跳转到http://www.zc.com页面。
在这里插入图片描述
在这里插入图片描述

5、基于目录下所有 php 结尾的文件跳转

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

vim /usr/local/nginx/conf/nginx.conf
server {
	listen       80;
	server_name  www.zc.com;		#域名修改	
	charset utf-8;
	access_log  /var/log/nginx/www.zc.com-access.log ;
	

	location ~* /upload/.*\.php$ {
	    rewrite (.+) http://www.zc.com permanent;
	}
	
	location / {
	    root   html;
	    index  index.html index.htm;
	}
}

systemctl restart nginx

在这里插入图片描述
浏览器访问 http://www.zc.com/upload/666.php 跳转到http://www.zc.com页面。
在这里插入图片描述
在这里插入图片描述

6、基于最普通一条 url 请求的跳转

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

vim /usr/local/nginx/conf/nginx.conf
server {
	listen       80;
	server_name  www.zc.com;		#域名修改	
	charset utf-8;
	access_log  /var/log/nginx/www.zc.com-access.log ;
	

    location ~* ^/abc/666.html {
        rewrite (.+) http://www.zc.com permanent;
    }
    
    location / {
        root   html;
        index  index.html index.htm;
    }
}

systemctl restart nginx

在这里插入图片描述
在这里插入图片描述
在这里插入图片描述

Z__Cheng
关注
Nginx 的 location 匹配 与 rewrite 重写跳转
段小宝的博客
06-09 1029
目录前言一、Nginx中的 正则表达式二、location 匹配2.1 location常用的匹配规则2.2 location 优先级2.3 location 示例说明2.4 必选规则三、rewrite 转发3.1 Rewrite 介绍3.2 Rewrite 实现3.3 rewrite 执行顺序3.4 rewrite 语法格式3.5 flag 标记说明3.6 rewrite 示例3.6.1 基于域名的跳转3.6.2 基于客户端 IP 访问跳转 前言 一、Nginx中的 正则表达式 ^ ：匹配输入字符串的起
Nginx中的location匹配与rewrite重写跳转
HB199753的博客
10-14 417
一、常见的Nginx正则表达式 ^ ：匹配输入字符串的起始位置 $ ：匹配输入字符串的结束位置 * ：匹配前面的字符零次或多次。如“ol*”能匹配“o”及“ol”、“oll” + ：匹配前面的字符一次或多次。如“ol+”能匹配“ol”及“oll”、“olll”，但不能匹配“o” ? ：匹配前面的字符零次或一次，例如“do(es)?”能匹配“do”或者“does”，”?”等效于”{0,1}” . ：匹配除“\n”之外的任何单个字符，若要匹配包括“\n”在内的任意字符，请使用诸如“[.\n]”之类的模式 \
Nginx根据URL跳转到不同的页面.txt
05-15
Nginx判断来路http://aaaa.com查询语句是否包含有Q=**，重写到https://xxxx.com/?Q=**
Nginx之 location匹配与rewrite重写跳转
weixin_53567573的博客
04-02 774
Nginx之正则表达和location匹配与rewrite重写跳转一、常见的Nginx正则表达式二、location（一）location大致可以分为三类（二）location常用的匹配规则：（三）location 优先级：（四）location 示例说明：（五）实际网站使用中，至少有三个匹配规则定义三、rewrite(一）rewrite 跳转实现（二）rewrite执行顺序(三）rewrite语法格式（四）flag标记说明四、rewrite 示例（一）基于域名的跳转(二）基于客户端 IP 访问跳转（三）基
nginx路由跳转前后端设置请求路径转发的区别
最新发布
dszushiye的博客
09-03 163
此配置适用于后端增加api路径，也就是controller里配置的前端请求路径用/api。此配置使用于前端增加api路由转发，也就是Vue里配置的路由跳转用/api/# 配置nginx上传文件大小限制。# 环境Liunx、Vue #
nginx--location、Rewrite
weixin_55609951的博客
06-10 393
一、常用的Nginx 正则表达式 ^ ：匹配输入字符串的起始位置 $ ：匹配输入字符串的结束位置 * ：匹配前面的字符零次或多次。如“ol*”能匹配“o”及“ol”、“oll” + ：匹配前面的字符一次或多次。如“ol+”能匹配“ol”及“oll”、“olll”，但不能匹配“o” ? ：匹配前面的字符零次或一次，例如“do(es)?”能匹配“do”或者“does”，”?”等效于”{0,1}” . ：匹配除“\n”之外的任何单个字符，若要匹配包括“\n”在内的任意字符，请使用诸如“[.\n]”之类的模式 \
Nginx跳转模块之location
rmh0713的博客
02-22 3586
location模块是server块的一个指令。作用：基于nginx服务器收到的请求字符串，虚拟主机名称（ip，域名）、url匹配，对特定请求进行处理。
Nginx跳转模块之location与rewrite
ZHUZIH6的博客
03-15 2905
详细介绍Nginx跳转模块之location与rewrite模块以及使用实例
Nginx中的location匹配与rewrite重写跳转（带图文案例）
愿你成为自己喜欢的模样，不抱怨，不将就，有自由，有光芒！
01-14 903
文章目录常见的Nginx正则表达式rewrite 常见的Nginx正则表达式 ^ ：匹配输入字符串的起始位置 $ ：匹配输入字符串的结束位置 * ：匹配前面的字符零次或多次。如“ol*”能匹配“o”及“ol”、“oll” + ：匹配前面的字符一次或多次。如“ol+”能匹配“ol”及“oll”、“olll”，但不能匹配“o” ? ：匹配前面的字符零次或一次，例如“do(es)?”能匹配“do”或者“does”，”?”等效于”{0,1}” . ：匹配除“\n”之外的任何单个字符，若要匹配包括“\n”在内的任意字
web服务之Nginx中的location匹配与rewrite重写跳转
shengmodizu的博客
04-06 1240
文章目录常见的Nginx正则表达式locationlocation分为三类location常用的匹配规则location 优先级location 示例说明三个匹配规则定义rewriterewrite 跳转实现rewrite执行顺序rewrite语法格式flag标记说明rewrite 示例基于域名的跳转基于客户端IP的访问跳转 常见的Nginx正则表达式 ^ ：匹配输入字符串的起始位置 $ ：匹配输入字符串的结束位置 * ：匹配前面的字符零次或多次。如“ol*”能匹配“o”及“ol”、“oll” + ：匹配前
Nginx学习之路---反向代理配置实战2.0(根据请求路径跳转不同端口)
LeslieLau的博客
09-05 1113
上一篇博客记录了Nginx的反向代理配置实战，我们可以通过Nginx代理服务器，完成请求的转发。 那这一篇博客的意义呢？是涉及到负载均衡吗？也不是，还没到负载均衡的地步。先往下看看 文章目录实现效果请求路径包含/edu/：请求路径包含/vod/：剖析准备工作准备Nginx服务器准备好两台Tomcat服务器，并修改端口准备页面配置域名映射开放防火墙端口测试 实现效果 浏览器向www.mylinux.cn(我虚拟机配置的域名，你的随意)的9001端口发送请求，根据请求路径不同从而跳转到不同的端口中去，拿一个
Nginx--------location匹配和Rewrite重写跳转
m0_57554344的博客
06-27 2396
(location =) > (location 完整路径) > (location ^~ 路径) > (location ,* 正则顺序) > (location 部分起始路径) > (location /)第一个必选规则直接匹配网站根，通过域名访问网站首页比较频繁，使用这个会加速处理，比如说官网。这里是直接转发给后端应用服务器了，也可以是一个静态首页root html;第二个必选规则是处理静态文件请求，这是nginx作为http服务器的强项。
nginx location 误区
足球带我奔跑
06-08 5113
有些童鞋的误区1、 location 的匹配顺序是“先匹配正则，再匹配普通”。 矫正： location 的匹配顺序其实是“先匹配普通，再匹配正则”。我这么说，大家一定会反驳我，因为按“先匹配普通，再匹配正则”解释不了大家平时习惯的按“先匹配正则，再匹配普通”的实践经验。这里我只能暂时解释下，造成这种误解的原因是：正则匹配会覆盖普通匹配（实际的规则，比这复杂，后面会详细解释）。 2、 locati...
nginx 之location
fake_hydra的博客
10-08 596
语法规则： location [=||*|^~] /uri/ { … } = 开头表示精确匹配 ^~ 开头表示uri以某个常规字符串开头，理解为匹配 url路径即可。nginx不对url做编码，因此请求为/static/20%/aa，可以被规则^~ /static/ /aa匹配到（注意是空格）。 ~ 开头表示区分大小写的正则匹配 ~* 开头表示不区分大小写的正则匹配 !~和!~*分别为区分大小写...
nginx指定访问路径跳转至指定路径
如需咨询可联系我，V：chen2318341674
09-29 7499
nginx指定访问路径跳转至指定路径
Nginx 服务之location及rewrite
kid00013的博客
05-07 2175
1.location和rewrite的区别 从功能看 rewrite 和 location 似乎有点像，都能实现跳转，主要区别在于 rewrite 是在同一域名内更改获取资源的路径，而 location 是对一类路径做控制访问或反向代理，还可以proxy_pass 到其他机器。 rewrite 对访问的域名或者域名内的URL路径地址重写 location 对访问的路径做访问控制或者代理转发 2.location 2.1 location分类 location 大致可以分为三类： 精准匹配：loc
nginx 根据不同的路径进行跳转 反向代理
面朝大海，春暖花开
10-20 1427
nginx根据条件跳转 跳转规则
wuling129的专栏
02-22 1076
nginx根据条件跳转+跳转规则 好的参考博文： nginx rewrite规则 自己写的时候参考这两个 Nginx 伪静态Rewrite,重定向Location配置总结(转) nginx rewrite规则语法 一、输入子目录跳转 location /templets { proxy_pass http://testServer/templets/; ...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值