Nginx Rewrite 规则

一、Rewrite概述

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

二、Rewrite使用场景

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

三、Rewrite配置语法

在Nginx中，Rewrite使用的是 ngx_http_rewrite_module 模块。

rewrite语法

Syntax:	rewrite regex replacement [flag];
Default:	—
Context:	server, location, if

一般用于切换维护场景

rewrite ^(.*)$ /page/404.html last;

四、Rewrite 的四种 flag

1.rewrite flag 作用

flag	作用
last	本条规则匹配完成后，停止匹配当前规则，开始匹配与更改后的URI相匹配的新位置；
break	本条规则匹配完成后，停止匹配，不再匹配后面的规则
redirect	返回302临时重定向，地址栏会显示跳转后的地址
permanent	返回301永久重定向，地址栏会显示跳转后的地址

2.last 和 break 的区别

2.1 配置 Nginx 测试

配置nginx

$ vim rewrite.conf
server {
        listen 80;
        server_name rw.test.com;
        root /code/rewrite;

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

重启nginx

$ systemctl restart nginx

访问页面测试

结合nginx日志和web页面分析结果

2.2 测试结论

break：只要匹配到规则，就回去本地路径目录中寻找请求的文件。
last：匹配到规则，跳转后没有内容，则带着跳转后的请求，重新的向server发起一次请求。

break 请求

1.请求rw.test.com/break；
2.首先，会去查找本地的/code/rewrite/test/index.html；
3.如果找到了，则返回/code/rewrite/test/index.html内容；
4.如果没有找到则返回404，找到目录却没有主页，则返回403；
last 请求

1.请求rw.test.com/last;
2.首先，会去查找本地的/code/rewrite/test/index.html；
3.如果找到了，则返回/code/rewrite/test/index.html内容；
4.如果没找到，会带着新跳转的URI再向server发起一次请求，请求rw.test.com/test;
5.如果匹配到新的location，则返回该location匹配的内容；
6.如果没有匹配到新的，则再返回404或403；

3.Redirect 和 Permanent 的区别

3.1 配置 Nginx 测试

$ cat rewrite.conf 
server {
        listen 80;
        server_name rw.test.com;
        root /code/rewrite;

        location /test {
                rewrite ^(.*)$ http://www.test.com redirect;
                #rewrite ^(.*)$ http://www.test.com permanent;
        }
}

配置两种跳转，关闭nginx测试，查看结果

3.2 测试结论

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

permanent: 请求一次后，会记录跳转的地址，以后不再询问，直接跳转，通过浏览器缓存记录

五、Rewrite 匹配规则

1.Rewrite匹配的优先级

先执行server模块的rewrite指令。
其次执行location匹配规则。
最后执行location里面的rewrite。

2.Rewrite全局变量

$server_name

当前用户请求的域名

server {
    listen 80;
    server_name rw.test.com;
    root /code;
	rewrite ^(.*)$ https://$server_name;
}

$request_filename

请求的文件路径和名字（带着网站站点目录的路径和文件 /code/images/1.jpg）

$request_uri

请求的文件路径和名字（不带网站站点目录的路径和文件 /images/1.jpg）

server {
    listen 80;
    server_name rw.test.com;
    root /code;
	rewrite ^(.*)$ https://$server_name$request_uri;
}

3.Rewrite可以开启日志

#NGINX主配置文件，错误日志级别改成notice
error_log  /var/log/nginx/error.log notice;

#http层开启rewrite日志
rewrite_log on;

六、Rewrite 规则匹配案例

1. 根据 request_uri 跳转

用户访问 /baidu 实际上访问的是 www.baidu.com。

server {
    listen 80;
    server_name rw.test.com;
    root /code/rewrite;

    location ~ /baidu {
        rewrite (.*) https://www.baidu.com redirect;
    }
}

2.将 HTTP 请求跳转到 HTTPS

server {
    listen	80;
    listen	443 ssl http2;
    server_name  www.test.com;
    index index.php index.html index.htm;
    root /code;

    #HTTP_TO_HTTPS_START
    if ($server_port !~ 443){
        rewrite ^(/.*)$ https://$host$1 permanent;
    }
    #HTTP_TO_HTTPS_END
    ssl_certificate /etc/nginx/ssl/nginx.crt;
    ssl_certificate_key /etc/nginx/ssl/nginx.key;
    ssl_protocols TLSv1 TLSv1.1 TLSv1.2 TLSv1.3;
    ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:HIGH:!aNULL:!MD5:!RC4:!DHE;
    ssl_prefer_server_ciphers on;
    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 10m;
    error_page 497  https://$host$request_uri;
}

3.Rewrite伪静态实例

此处以wordpress为例，为wordpress站点配置伪静态。

搭建wordpress站点（步鄹省略）
修改nginx配置文件，添加伪静态

location / {
	index index.php index.html;	
	if (-f $request_filename/index.html){
               rewrite (.*) $1/index.html break;
       }
       if (-f $request_filename/index.php){
               rewrite (.*) $1/index.php;
       }
       if (!-f $request_filename){
               rewrite (.*) /index.php;
       }
}

rewrite /wp-admin$ $scheme://$host$uri/ permanent;