Nginx Rewrite

匹配符	表示含义
^	匹配输入字符串的起始位置
$	匹配输入字符串的结束位置
*	匹配前面的字符零次或多次。如“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]	匹配所有大小写字母或数字
()	表达式的开始和结束位置
\|	或运算符

三、location

3.1、location的分类

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

3.2、location 常用的匹配规则

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

3.3、location优先级排列说明

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

匹配某个具体文件

(location=完整路径) > (location 完整路径) > (location *完整路径) >(location~完整路径) > (location完整路径) > (location /)
用目录做匹配访问某个文件
(location=目录) > (location ^ 目录/) > (location 目录 ) > (location~*目录) > (location目录)

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

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

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

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

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

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

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

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

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

3.4、实际网站，至少要有三个匹配规则定义

第一个必选规则

直接匹配网站根，通过域名访问网站首页比较频繁，使用这个会加速处理，比如说官网。

可以是一个静态首页，也可以直接转发给后端应用服务器

location = / {

    root   html;

    index  index.html index.htm;

}

第二个必选规则

处理静态文件请求，这是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

4.1、功能概述

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

4.2、rewrite跳转实现

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

4.3、 rewrite实际场景

1.Nginx跳转需求得实现方式

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

2.rewrite放在 server{}， if{}， location{} 段中

location只对域名后边得除去传递参数外的字符串起作用
例如 http://www.kgc.com/abc/bbs/index.php?a=1&b=2 只对/abc/bbs/index.php重写。

3.对域名或参数字符串

使用if全局变量匹配
使用proxy_pass反向代理

4.4、命令的执行顺序

执行server块里面的rewrite指令
执行location匹配
执行选定的location中的rewrite指令

4.5、语法格式

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

flag标记说明：

标记	说明
last	相当于Apache的【L】标记，表示完成rewrite
break	本条规则匹配完成即终止，不在匹配后面的任何规则
redirect	返回302临时重定向，浏览器地址栏会显示跳转后的URL地址，爬虫不会更新url
permanent	返回301永久重定向，浏览器地址栏会显示跳转后的URL地址，爬虫更新url
set	标记表示当前规则匹配成功设置一个变量并把变量传入下一条规则

last和break比较：

	last	break
使用场景	一般写在server和if中	一般使用在location中
URL匹配	不终止重些后得url匹配	终止重写后得url匹配

4.6、比较rewrite和location

相同点：

都能实现跳转

不同点：

rewrite是在同一域名内更改获取资源的路径
location是对一类路径做控制访问或反向代理，还可以proxy_pass到其他机器

执行顺序:

执行server块里面的rewrite指令——》执行location匹配——》执行选定location中的rewrite指令
rewrite改写访问的URL路径（被访问的HTML、htm、css文件）
location 对一类地址进行权限控制（认证控制）跳转（跨服务器进行一个URL跳转）

五、rewrite实列

5.1、基于域名的跳转

现在公司旧域名www.kgc.com有业务需求变更，需要使用新域名www.benet.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.kgc.com-access.log;       #日志修改
   location / {
   #添加域名重定向
if ($host = 'www.kgc.com'){                       #$host为rewrite全局变量，代表请求主机头字段或主机名
           rewrite ^/(.*)$ http://www.benet.com/$1 permanent;   #$1为正则匹配的内容，即“域名/”之后的字符串
}
root html;
index index.html index.htm;
}
}

echo "192.168.10.19 www.kgc.com www.benet.com" >> /etc/hosts
systemctl restart nginx

浏览器输入模拟访问 http://www.kgc.com/test/1.html(虽然这个请求内容是不存在的)
会跳转到www.benet.com/test/1.html，查看元素可以看到返回301，实现了永久重定向跳转，而且域名后的参数也正常跳转。

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

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

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

   #设置是否合法的IP标记
set $rewrite true;                           #设置变量$rewrite，变量值为boole值true
#判断是否为合法IP
   if ($remote_addr = "192.168.10.19"){       #当客户端IP为192.168.10.19时，将变量值设为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

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

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

5.3、基于旧域名跳转到新域名后面家目录

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

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

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

5.4、基于参数匹配的跳转

现在访问http://www.kgc.com/100-(100|200)-100.html 跳转到http://www.kgc.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.kgc.com-access.log;

   if ($request_uri ~ ^/100-(100|200)-(\d+).html$) {
rewrite (.+) http://www.kgc.com permanent;
}

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

$request_uri：包含请求参数的原始URI，不包含主机名，如：http://www.kgc.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

systemctl restart nginx

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

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

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

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

   location ~* /upload/.*\.php$ {
rewrite (.+) http://www.kgc.com permanent;
}

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

systemctl restart nginx

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

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

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

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

location ~* ^/abc/123.html {
rewrite (.+) http://www.kgc.com permanent;
}

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

systemctl restart nginx

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

六、本章总结

Nginx Rewrite 概述

Nginx Rewrite基本操作

基于域名的跳转
基于客户端 IP 访问跳转
基于旧域名跳转到新域名后面加目录
基于参数匹配的跳转
基于目录下所有 php 结尾的文件跳转
基于最普通一条 url 请求的跳转

location的匹配

精确匹配、一般匹配、正则匹配

Mak1r522

关注

0
点赞
踩
0

收藏

觉得还不错? 一键收藏
0
评论
Nginx Rewrite

直接匹配网站根，通过域名访问网站首页比较频繁，使用这个会加速处理，比如说官网。可以是一个静态首页，也可以直接转发给后端应用服务器root html;Rewrite功能就是，使用nginx提供的全局变量或自己设置的变量，结合正则表达式和标记位实现URL重写以及重定向。更换域名后需要保持旧的域名能跳转到新的域名上、某网页发生改变需要跳转到新的页面、网站防盗链等等需求。基于域名的跳转基于客户端 IP 访问跳转基于旧域名跳转到新域名后面加目录基于参数匹配的跳转。
复制链接

扫一扫