Nginx 重写功能(location / rewrite)

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

2.2location的分类

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

2.3location 常用的匹配规则

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

2.4 location 优先级：

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

location = / {
    [ configuration A ]
}
 
location / {
    [ configuration B ]
}
 
location /documents/ {
    [ configuration C ]
}
 
location ^~ /images/ {
    [ configuration D ]
}
 
location ~* \.(gif|jpg|jpeg)$ {
    [ configuration E ]
}

2.5location 示例

精确匹配

location = / {}
=为精确匹配 / , 主机名后不能携带任何字符串，比如 / 和 /data ,则/匹配，/data不匹配

一般匹配/通用匹配

location / {}
代表以/开头，所以这条规则将匹配所有的请求


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


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

正则匹配

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


location ~* \.(gif|jpg|jpeg)$ {} 
匹配所有 gif jpg 或 jepg 结尾的请求
如果 有上面的location ^~ /images/ {}匹配  则会先匹配上一请求，所以到不了这一条。

2.6实际网站使用中，至少有三个匹配规则定义

第一个规则

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

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

第二个规则

是处理静态文件请求，这是nginx作为http服务器的强项有两种配置模式，目录匹配或后缀匹配,任选其一或搭配使用。

location ^~ /static/ {
       root /webroot/static/ ;
}      
 
location ~* \.(gif|jpg|jpeg)$ {
      root /webroot/static/ ;
}

第三个规则

就是通用规则，比如用来转发带.php、.jsp后缀的动态请求到后端应用服务器。

非静态文件请求就默认是动态请求

location / {
    proxy_pass http://tomcat_server;
}

2.7实例

location = / {} 与 location / {}

实例1：location = / {} 和 location / {} ，按道理应匹配前者，但实际确实匹配后者，匹配只写域名精确匹配不生效，接下来一个小例子说明一下

1. #在配置文件添加匹规则
vim  /usr/local/nginx/conf/nginx.conf
 
#添加的网页
        location = / {     
            root   /web/dog/;
        }
 
#默认网页
        location / {
            root   html;
            index  index.html index.htm;        }
 
2. #新建网页站点目录
mkdir -p /web/dog
 
3. #在站点目录下新建index.html
vim /web/dog/index.html
 
this is dog web
 
4. #检查语法并重启
nginx -t
systemctl restart nginx.service 
 
5. #在网页中测试
http://192.168.98.95/

location = /index.html {} 与 location / {} 在根后加上index.html 后生效

1. #修改一下配置文件
vim  /usr/local/nginx/conf/nginx.conf
 
        location = /index.html {  # 加上index.html 
            root   /web/dog/;
        }
        
        
2. #重启服务，并网页中测试
systemctl restart nginx.service

location = /1.jpg {} 和 location ~* .(gif|jpg|png|jpeg)$ {}比较

1. #修改一下配置文件
vim  /usr/local/nginx/conf/nginx.conf
 
        location = /1.jpg { 
            root   /web/dog/;   #小狗的网页
        }
 
        location ~* \.(jpg|gif|png) {
            root   /web/cat/;  #小猫的网页
        }
 
2. #在刚刚创建的dog的站点下添加图片
cd /web/dog/
拖入图片
 
3. #新建一个cat目录，添加图片
mkdir cat
cd cat
拖入图片
 
 
4. #检查语法，重启服务
nginx -t
nginx -s reload
 
5. #在网页中测试
http://192.168.98.95/1.jpg
结果可以看出=精确匹配

大小写问题

1. #修改配置文件
vim  /usr/local/nginx/conf/nginx.conf
 
location ~ /A.?\.jpg {
            root   /web/image;
            index  index.html index.htm;
        }
 
 
2. #新建站点目录并拖入图片
cd /web
mkdir image
cd image/
拖入图片，然后改名为A.jpg
mv a.webp A.jpg
 
3. #重启并在网页中测试
nginx -s reload

1 .#在Linux中将A.jpg拷贝一份命名为a.jpg
cd /web/image/
cp A.jpg a.jpg
 
2. #修改配置文件
vim  /usr/local/nginx/conf/nginx.conf
 
  location ~* /A.?\.jpg {
            root   /web/image;
            index  index.html index.htm;
        }
 
3. #重启服务并测试
nginx -s reload
http://192.168.98.95/a.jpg

2.8location 优先级总结

如果是匹配某个具体文件： (location = 完整路径) > (location ^~ 完整路径) > (location ~* 完整路径) >(location ~ 完整路径) > (location /)通用匹配

三、REWRITE模块

3.1rewrite功能

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

rewrite 只能在
server {}
location {}
if {}
中，并且默认只能对域名后边的除去传递的参数外的字符串起作用
例如：
http://www.yxp.com/abc/bbs/index.html?a=1&b=2 只针对/abc/bbs/index.html重写

3.2Rewrite 跳转场景

Rewrite 跳转场景主要包括以下几种

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

3.3Rewrite 跳转实现

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

3.4Rewrite 执行顺序

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

3.5Rewrite 语法格式

rewrite <regex> <replacement> [flag];
regex：表示正则匹配规则
replacement：表示跳转后的内容
flag：表示rewrite 支持的 flag 标记
 
flag 标记说明：
last：本条规则匹配完成后，继续向下匹配新的location URL规则，一般用在server和if中
 
break：本条规则匹配完成即终止，不再匹配后面的任何规则。一般用在location中
 
redirect：返回 302 临时重定向，浏览器地址会显示跳转后的 URL 地址，爬虫不会更新 url（因为是临时）。
 
permanent：返回 301 永久重定向，浏览器地址栏会显示跳转后的 URL 地址，爬虫更新 url。

3.6 Rewrite 实例

基于域名的跳转

1. #修改配置文件
vim  /usr/local/nginx/conf/nginx.conf
 
server {
        listen       80;
        server_name  www.xc.com; 
 
        charset utf-8;
 
        #access_log  logs/host.access.log  main;
 
        location / {
            root   html;
            index  index.html index.htm;
        }
 
        location /index.html {
            if ($host = 'www.xc.com') {
            rewrite ^/(.*)$ http://www.dhc.com/$1 permanent;
            }
  root   /web/test;
        }
 
2. #新建站点目录
mkdir /web/test
 
3. #新建文件
vim /web/test/index.html
this is test web!!!
 
4. #重启服务
nginx -s reload
 
 
5. #另外开一台虚拟机，修改/etc/hosts文件
vim /etc/hosts
192.168.98.95 www.xc.com www.dhc.com
 
6. #打开新开的虚拟机的浏览器网页测试
http://www.xc.comv

基于客户端IP 访问跳转

1. #修改配置文件
vim  /usr/local/nginx/conf/nginx.conf
 
 server {
        listen       80;
        server_name  www.xc.com;
 
        charset utf-8;
 
        #access_log  logs/host.access.log  main;
        set $rewrite true;
        if ($remote_addr = '192.168.91.103'){
        set $rewrite false;
        }
        if ($rewrite = true){
         rewrite (.+) /weihu.html;
        }
 
        location /weihu.html {
            root   /var/www/html;
        }
 
        location / {
            root   html;
           index  index.html index.htm;
        }
 
2. #新建站点目录及文件
mkdir -p /var/www/html
vim /var/www/html/weihu.html
 
we are busing now,please wait for a moment!
 
3. #重启服务                            nginx -s reload
 
4. #在网页测试
http://192.168.98.95/

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

例如现在访问的是 http://bbs.xc.com/post 现在需要将这个域名下面的发帖都跳转到 http://www.xc.com/bbs/post，注意保持域名跳转后的参数不变。

1. #修改配置文件
vim  /usr/local/nginx/conf/nginx.conf
server {
        listen       80;
        server_name  www.xc.com;
 
        charset utf-80;
 
        #access_log  logs/host.access.log  main;
        location /post {
         rewrite (.+) http://www.xc.com/bbs$1 permanent;
        }
 
        location / {
            root   html;
            index  index.html index.htm;
        }
 
2. #新建站点目录，并创建文件
mkdir -p /usr/local/nginx/html/bbs/post
vim /usr/local/nginx/html/bbs/post/index.html
 
this is the test!!
 
3. #开一台服务器，修改/etc/hosts文件
vim /etc/hosts
192.168.98.95 www.xc.com www.dhc.com bbs.xc.com
 
4. #重启服务并在浏览器中测试
nginx -s reload
 http://bbs.xc.com/post

基于参数匹配的跳转

1. #修改配置文件
vim  /usr/local/nginx/conf/nginx.conf
 
  server {
        listen       80;
        server_name  www.xc.com;
 
        charset utf-8;
 
    #access_log  logs/host.access.log  main;
      location ~ /100-(100|200)-(\d+).html$ {
          rewrite (.+) http://www.kgc.com permanent;
       }
 
      location / {
           root   html;
           index  index.html index.htm;
        }
 
       
2. #重启服务
nginx -s reload
 
3. #验证
http://www.xc.com/100-100-100

基于目录下所有的php文件

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

1. #修改配置文件
vim  /usr/local/nginx/conf/nginx.conf
 
 server {
        listen       80;
        server_name  www.xc.com;
 
        charset utf-8;
 
        #access_log  logs/host.access.log  main;
       location ~* /upload/.*\.php$ {
           rewrite (.+) http://www.xc.com permanent;
       }
 
        location / {
            root   html;
            index  index.html index.htm;
        }
 
2. #重启服务
systemctl restart nginx
 
3. #在网页测试
http://www.xc.com/upload/123.php

基于普通的一条url

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

1. #修改配置文件
 server {
        listen       80;
        server_name  www.xc.com;
 
        charset utf-8;
 
        #access_log  logs/host.access.log  main;
        location ~* ^/abc/123.html$ {
          rewrite (.+) http://www.xc.com permanent;
       }
 
        location / {
            root   html;
            index  index.html index.htm;
        }
 
2. #重启服务
systemctl restart nginx.service 
 
3. #在网页测试
http://www.yxc.com/abc/123.html