第八章·Nginx实现Rewrite重写

DriverZeng

发布于 2022-09-26 14:29:41

5480

发布于 2022-09-26 14:29:41

-曾老湿, 江湖人称曾老大。

-多年互联网运维工作经验，曾负责过大规模集群架构自动化运维管理工作。 -擅长Web集群架构与自动化运维，曾负责国内某大型金融公司运维工作。 -devops项目经理兼DBA。 -开发过一套自动化运维平台（功能如下）： 1)整合了各个公有云API，自主创建云主机。 2)ELK自动化收集日志功能。 3)Saltstack自动化运维统一配置管理工具。 4)Git、Jenkins自动化代码上线及自动化测试平台。 5)堡垒机，连接Linux、Windows平台及日志审计。 6)SQL执行及审批流程。 7)慢查询日志分析web界面。

Rewrite基本概述

什么是rewrite

Rewrite主要实现url地址重写，以及重定向，就是把传入web的请求重定向到其他url的过程。

Rewrite使用场景

1、地址跳转，用户访问www.drz.com这个URL是，将其定向至一个新的域名mobile.drz.com 2、协议跳转，用户通过http协议请求网站时，将其重新跳转至https协议方式 3、伪静态，将动态页面显示为静态页面方式的一种技术，便于搜索引擎的录入，同时建上动态URL地址对外暴露过多的参数，提升更高的安全性。 4、搜索引擎，SEO优化依赖于url路径，好记的url便于智齿搜索引擎录入

Rewrite配置示例

句法：Syntax:  rewrite regex replacement [flag]
默认：Default: --
语境：Context: server,location,if

#用于切换维护页面场景
#rewrite ^(.*)$ /page/maintain.html break;

Rewrite标记Flag

rewrite指令根据表达式来重定向URL，或者修改字符串，可以应用于server，location，if环境下，每行rewrite指令最后跟一个flag标记，支持的flag标记有如下表格所示：

flag	作用
last	本条规则匹配完成后，停止匹配，不再匹配后面的规则
break	本条规则匹配完成后，停止匹配，不再匹配后面的规则
redirect	返回302临时重定向，地址栏会显示跳转后的地址
permanent	返回301永久重定向，地址栏会显示跳转后的地址

last与break区别对比示例

[root@web01 conf.d]# cat rewrite.conf 
server {
        listen 80;
        server_name rewrite.drz.com;
        root /code;

        location ~ ^/break {
                rewrite ^/break /test/ break;
        }
        location ~ ^/last {
                rewrite ^/last /test/ last;
        }
        location /test/ {
                default_type application/json;
                return 200 "ok";
        }
}

#重启nginx服务
[root@web01 conf.d]# nginx -t 
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful
[root@web01 conf.d]# nginx -s reload

如果懂shell脚本的，这两个就类似于脚本中的，break和continue

浏览器访问break

浏览器访问last

last与break区别

break 只要匹配到规则，则会去本地配置路径的目录中寻找请求的文件；而last只要匹配到规则，会对其所在的server(...)标签重新发起请求。

break请求：
1、请求rewrite.drz.com/break
2、首先：会去查找本地的/code/test/index.html;
3、如果找到了，则返回/code/test/index.html的内容；
4、如果没找到该目录则报错404，如果找到该目录没找到对应的文件则403

last请求:
1、请求rewrite.drz.com/last
2、首先：会去查找本地的/code/test/index.html;
3、如果找到了，则返回/code/test/index.html的内容；
4、如果没找到，会对当前server重新的发起一次请求，rewrite.drz.com/test/
5、如果有location匹配上，则直接返回该location的内容。
4、如果也没有location匹配，再返回404;

所以，在访问/break和/last请求时，虽然对应的请求目录/test都是不存在的，理论上都应该返回404，但是实际上请求/last的时候，是会有后面location所匹配到的结果返回的，原因在于此。

redirect与permanent区别对比示例

[root@web01 conf.d]# cat rewrite.conf 
server {
        listen 80;
        server_name rewrite.drz.com;
        root /code;

        location /test {
                rewrite ^(.*)$  https://blog.driverzeng.com redirect;
                #rewrite ^(.*)$  https://blog.driverzeng.com permanent;
                #return 301 https://blog.driverzeng.com;
                #return 302 https://blog.driverzeng.com;
        }
}

redirect与permanent区别（实现https）

redirect: 每次请求都会询问服务器，如果当服务器不可用时，则会跳转失败。

permanent: 第一次请求会询问，浏览器会记录跳转的地址，第二次则不再询问服务器，直接通过浏览器缓存的地址跳转。

Rewrite规则实践

在写rewrite规则之前，我们需要开启rewrite日志对规则的匹配进行调试。

[root@web01 code]# vim /etc/nginx/nginx.conf
/var/log/nginx/error.log notice;

http{
    rewrite_log on;
}

案例一

用户访问/abc/1.html实际上真实访问的是/ccc/bbb/2.html

#http://www.drz.com/abc/1.html  ==>  http://www.drz.com/ccc/bbb/2.html

#1.准备真实访问路径
[root@web03 ~]# mkdir /code/ccc/bbb -p
[root@web03 ~]# echo "ccc_bbb_2" > /code/ccc/bbb/2.html

#2.Nginx跳转配置
[root@web03 ~]# cd /etc/nginx/conf.d/
[root@web03 conf.d]# cat ccbb.conf 
server {
        listen 80;

        location / {
                root /code;
                index index.html;
        }
        location /abc {
                rewrite (.*) /ccc/bbb/2.html redirect;
                #return 302 /ccc/bbb/2.html;
        }
}

#3.重启Nginx服务
[root@web03 conf.d]# nginx -t
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful
[root@web03 conf.d]# nginx -s reload

案例二

用户访问/2018/ccc/2.html实际上真实访问的是/2014/ccc/bbb/2.html

##http://www.drz.com/2018/ccc/2.html  ==>  http://www.drz.com/2014/ccc/bbb/2.html

#1.准备真是的访问路径
[root@web03 conf.c]# mkdir /code/2014/ccc/bbb -p 
[root@web03 conf.c]# echo "2014_ccc_bbb_2" > /code/2014/ccc/bbb/2.html

#2.Nginx跳转配置
[root@web03 conf.d]# cat ccbb.conf 
server {
        listen 80;

        location / {
                root /code;
                index index.html;
        }
        location /2018 {
                rewrite ^/2018/(.*)$ /2014/$1 redirect;
        }
}

#3.重启nginx服务
[root@web03 conf.d]# nginx -t
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful
[root@web03 conf.d]# nginx -s reload

案例三

用户访问/test实际上真实访问的是https://blog.driverzeng.com

#1.Nginx跳转配置
[root@web03 conf.d]# cat test.conf 
server {
        listen 80;

        location /test {
                rewrite (.*) https://blog.driverzeng.com redirect;
        }
}

#2.重启nginx服务
[root@web03 conf.d]# nginx -s reload

案例四

用户访问couese-11-22-33.html实际上真实访问的是/course/11/22/33/course_33.html

#http://www.drz.com/couese-11-22-33.html  ==>  http://www.drz.com/course/11/22/33/course_33.html

#1.准备真是的访问路径
[root@web03 ~]# mkdir /code/course/11/22/33 -p
[root@web03 ~]# echo "curl docs.etiantian.org" > /code/course/11/22/33/course_33.html

#2.Nginx跳转配置
[root@web03 conf.d]# cat test.conf 
server {
        listen 80;
        root /code;
        index index.html;
        location / {
                #灵活配法
                rewrite ^/course-(.*)-(.*)-(.*).html$ /course/$1/$2/$3/course_$3.html redirect;
                #固定配法
                #rewrite ^/course-(.*) /course/11/22/33/course_33.html redirect;
        }
}

#3.重启nginx服务
[root@web03 conf.d]# nginx -s reload

案例五

将http请求跳转到https

#Nginx跳转配置
server {
        listen 80;
        server_name www.dirverzeng.com;
        rewrite ^(.*) https://$server_name$1 redirect;
        #return 302 https://$server_name$request_uri;
}       

server {
        listen 443;
        server_name blog.driverzeng.com;
        ssl on;
}

Rewrite场景示例

#部署discuz论坛
[root@web01 conf.d]# vim discuz.drz.com.conf
server {
        listen 80;
        server_name discuz.drz.com;

        location / {
                root /code/discuz;
                index index.php index.html;
        }

        location ~ \.php$ {
                root /code/discuz;
                fastcgi_pass 127.0.0.1:9000;
                fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
                include fastcgi_params;
        }
}

#创建站点目录部署代码
[root@web01 ~]# mkdir /code/discuz
[root@web01 ~]# rz Discuz_X3.3_SC_GBK.zip
[root@web01 ~]# unzip Discuz_X3.3_SC_GBK.zip -d /code/discuz/

#授权站点目录
[root@web01 discuz]# chown www.www -R /code/

#创建数据库
MariaDB [(none)]> create database discuz;
Query OK, 1 row affected (0.00 sec)

MariaDB [(none)]> grant all on discuz.* to discuz@'%' identified by '123';
Query OK, 0 rows affected (0.00 sec)

server {
        listen 80;
        server_name discuz.drz.com;

        location / {
                root /code/discuz/upload;
                index index.php index.html;
                rewrite ^([^\.]*)/topic-(.+)\.html$ $1/portal.php?mod=topic&topic=$2 last;
                rewrite ^([^\.]*)/article-([0-9]+)-([0-9]+)\.html$ $1/portal.php?mod=view&aid=$2&page=$3 last;
                rewrite ^([^\.]*)/forum-(\w+)-([0-9]+)\.html$ $1/forum.php?mod=forumdisplay&fid=$2&page=$3 last;
                rewrite ^([^\.]*)/thread-([0-9]+)-([0-9]+)-([0-9]+)\.html$ $1/forum.php?mod=viewthread&tid=$2&extra=page%3D$4&page=$3 last;
                rewrite ^([^\.]*)/group-([0-9]+)-([0-9]+)\.html$ $1/forum.php?mod=group&fid=$2&page=$3 last;
                rewrite ^([^\.]*)/space-(username|uid)-(.+)\.html$ $1/home.php?mod=space&$2=$3 last;
                rewrite ^([^\.]*)/blog-([0-9]+)-([0-9]+)\.html$ $1/home.php?mod=space&uid=$2&do=blog&id=$3 last;
                rewrite ^([^\.]*)/(fid|tid)-([0-9]+)\.html$ $1/archiver/index.php?action=$2&value=$3 last;
                if (!-e $request_filename) {
                    return 404;
                }
        }

        location ~ \.php$ {
                root /code/discuz/upload;
                fastcgi_pass 127.0.0.1:9000;
                fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
                include fastcgi_params;
        }
}

Rewrite规则补充

Rewrite匹配优先级

1.先执行server块的rewrite指令 2.其次执行location匹配规则 3.最后执行location中的rewrite

Rewrite与Nginx全局变量

Rewrite在匹配过程中，会用到一些Nginx全局变量

$server_name    #当前用户请求的域名

server {
        listen 80;
        server_name test.drz.com;
        rewrite ^(.*)$ https://$server_name$1;
}

$request_filename 请求的文件路径名（带网站的主目录/code/images/test.jpg）
$request_uri 当前请求的文件路径（不带网站的主目录/inages/test.jpg）

#大多数用于http协议转gttps协议
server {
        listen 80;
        server_name php.drz.com;
        return 302 https://$server_name$request_uri;
}

$scheme 用的协议，比如http或者https

如何更加规范的书写Rewrite规则

server {
        listen 80;
        server_name www.drz.com drz.com;
        if ($http_host = drz.com){
            rewrite (.*) http://www.drz.com$1;
        }
}

#推荐书写格式
server {
        listen 80;
        server_name drz.com;
        rewrite ^ http://www.drz.com$request_uri;
}
server {
        listen 80;
        server_name www.drz.com;
}

本文参与腾讯云自媒体同步曝光计划，分享自作者个人站点/博客。

原始发表：2019-04-29，如有侵权请联系 cloudcommunity@tencent.com 删除

运维