Nginx模块之rewrite模块

一、rewrite模块的基本介绍

1、rewrite功能

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

rewrite只能放在server{},location{},if{}中，并且默认只能对域名后边的除去传递的参数外的字符串起作用。

2、跳转的场景

①可以调整用户浏览的url，看起来更规范，合乎开发及产品人员的需求。

②为了让搜索引擎网站内容及用户体验更好，企业会将动态url地址伪装成静态地址提供服务。

③网址换新域名后，让旧的访问跳转到新的域名上。

④根据特殊变量，目录，客户端的信息进行url调整等。

3、跳转实现

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

4、执行顺序

首先执行server块里面的rewrite指令

其次执行location匹配

最后执行选定的location中的rewritre指令

5、语法格式

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

flag标记说明

①last：本条规则匹配完成后，不中止重写后的url匹配，一般用在server和if中。

②break：本条规则匹配完成即终止，终止重写后的url匹配，一般使用在location中。

③redirect：返回302临时重定向，浏览器地址会显示跳转后的url地址。

④permanent：返回301永久重定向，浏览器地址栏会显示跳转后的url地址。

二、rewrite模块的使用实例

1、基于域名的跳转

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

①第一步先修改主配置文件

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

第二步：创建所需要目录与文件

#创建日志文件夹，检查语法
mkdir -p /var/log/nginx
nginx -t
 
#创建网页test目录与文件1.html
mkdir -p /usr/local/nginx/html/test
vim /usr/local/nginx/html/test/1.html
------------------------------------------
<h1 font color=red>
Here is the content of test
<img src="1.jpg"/>
</h1
-------------------------------------------
 
#上传1.jpg图片文件
cd /usr/local/nginx/html/test
rz -E

第三步：添加域名与ip地址映射关系

#添加映射关系
echo "192.168.79.210 www.jiu.com www.xin.com" >> /etc/hosts
 
#重启服务
systemctl restart nginx                    

第四步：网页验证

#打开浏览器输入
www.jiu.com/test/1.html
 
 
会发现重定向到www.xin.com/test/1.html

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

公司业务更新版本，使得所有ip访问内容都显示固定维护页面，只有192.168.170.113访问正常。

vim /apps/nginx/conf/nginx.conf
--------------------------------------------------------------
server {
    listen       80;
    server_name  www.jiu.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.170.113"){        #当客户端IP为192.168.170.113时，将变量值设为false，不进行重写
        set $rewrite false;
    }
    #除了合法IP，其它都是非法IP，进行重写跳转维护页面
    if ($rewrite = true){                        #当变量值为true时，进行重写
        rewrite (.+) /weihu.html;                #重写在访问IP后边插入/weihu.html，例如192.168.80.11/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/
vim /var/www/html/weihu.html
-----------------------------------
<h1>
Sorry!
We are busy now!
See you tomorrow!
</h1>
-----------------------------------
 
systemctl restart nginx

第三步：网页验证

#本机网页浏览器输入
www.jiu.com
访问应正常
 
#在其他设备浏览器访问测试首先修改映射文件
echo "192.168.79.210 www.jiu.com" >>/etc/hosts
 
#浏览器测试
www.jiu.com

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

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

第一步：修改主配置文件

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

第二步：添加临时域名和ip的映射关系

vim /etc/hosts
--------------
192.168.79.210 www.jiu.com mail.jiu.com

第三步：创建准备的网页文件

mkdir -p /apps/nginx/html/mail/post
vim /usr/local/nginx/html/mail/post/1.html
-------------------------------------------
<h1>
hi
</h1>
---------------------------------------------
nginx -t
systemctl restart nginx

第四步：浏览器验证

输入mail.jiu.com/post/1.html
显示为www.jiu.com/mail/post/1.html

4、基于参数匹配的跳转

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

第一步：修改主配置文件

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

第二步：检查语法并重启服务

nginx -t
systemctl restart nginx

第三步：网页验证

#在浏览器输入
www.jiu.com/100-200-100.html

第四步：输入错误地址范围

#在浏览器输入错误范围
www.jiu.com/100-500-100.html

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

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

第一步：修改主配置文件

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

第二步：检查语法并重启服务

nginx -t
systemctl restart nginx

第三步：网页验证

#在浏览器输入
www.jiu.com/upload/123.php

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

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

第一步：修改主配置文件

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

第二部：检查配置文件并且重启服务

第三步：浏览器中访问测试

#在浏览器输入
www.jiu.com/abc/123.html