Nginx Rewrite介绍

Rewrite 跳转场景

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

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

◆ 网址换新域名后，让旧的访问跳转到新的域名上。例如，访问京东的 360buy.com 会跳转到

jd.com。

◆ 服务端某些业务调整，比如根据特殊变量、目录、客户端的信息进行 URL 调整等

Rewrite 跳转实现

◆ 跳转实现都是通过ngx_http_rewrite_module模块来进行的。

◆ Nginx：是通过 ngx_http_rewrite_module 模块支持 url 重写、支持 if 条件判断，但不支持 else，

支持if单分支，但是不支持双分支判断 。

◆ PCRE 支持：该模块需要PCRE 支持，应在编译 Nginx 时指定 PCRE 支持，默认已经安装。

◆ 跳转：根据相关变量重定向和选择不同的配置，从一个location跳转到另一个location，不过这样

的循环最多可以执行10次，超过后 Nginx 将返回500错误。

◆ 重写模块：包含 set 指令，来创建新的变量并设其值，这在有些情景下非常有用的，如记录条件

标识、传递参数到其他 location、记录做了什么等等。

注：rewrite功能就是，使用 Nginx 提供的全局变量或自己设置的变量，结合正则表达式和标志位实

现URL的重写以及重定向。

Nginx跳转需求的实现方式

◆ 使用rewrite进行匹配跳转

◆ 使用if匹配全局变量后跳转

◆ 使用location匹配再跳转

注：rewrite放在server{}，if{}，location{}段中，location只对域名后边的除去传递参数外的字符串

起作用。对域名或参数字符串匹配，使用if全局变量匹配；以及使用proxy_pass反向代理。

nginx rewrite中的正则表达式

常用的正则表达式元字符：

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

|:或运算符 rewrite命令语法 命令格式：rewrite <regex(正则)> <replacement(跳转后的内容)> [flag（rewrite支持的flag标记）]；

flag标记说明

标记	说明
last	本条规则匹配完成后，不终止重写后的url匹配，一般用在 server 和 if 中
break	本条规则匹配完成即终止，终止重写后的url匹配，一般使用在 location 中
redirect	返回302临时重定向，浏览器地址会显示跳转后的URL地址
permanent	返回301永久重定向，浏览器地址栏会显示跳转后的URL地址

lasr和break比较

last使用场景，一般写在server和if中；URL匹配不终止重写后的url匹配。

break使用场景，一般使用在location中；URL匹配终止重写后的url|匹配。

location简介

⑴、location 分类

精准匹配:location = / { ...}

示例:location = patt { } PS:精确匹配字符串

一般匹配:iocation / {...}

示例:location patt { } PS:只要包含patt的字符串即可

正则匹配: location ~ / {...}

示例:location ~ patt {...} PS:按照正则表达式的方式匹配

⑵、location常用的匹配规则

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

⑶、location优先级(越精确越优先)

相同类型的表达式，字符串长的会优先匹配

按优先级排列

首先精确匹配 =类型

其次前缀匹配 ^～类型表达式

其次是按文件中顺序的正则表达式(和*)类型

然后匹配不带任何修饰的常规字符串匹配类型，按前缀匹配

最后是交给通用匹配（/)，如果没有其它匹配，任何请求都会匹配到

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

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

（3）location /documents/ {}
匹配任何以 /documents/ 开头的地址，匹配符合以后，还要继续往下搜索其它 location
只有其它 location后面的前缀路径没有匹配到时，才会采用这一条

（4）location /documents/abc {}
匹配任何以 /documents/abc 开头的地址，匹配符合以后，还要继续往下搜索其它 location
只有其它 location后面的前缀路径没有匹配到时，才会采用这一条

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

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

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

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

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

⑷、rewrite和location比较

• 相同点：都能实现跳转。
• 不同点： rewrite是在同一域名内更改获取资源的路径。

location是对一类路径做控制访问或反向代理，还可以proxy_pass到其他机器。

rewrite会写在location里，执行顺序。执行server块里面的rewrite指令；执行location匹配；执行选定的location中的rewrite指令。

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

1、第一个必选规则

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

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

2、第二个必选规则

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

location ^~  /static/ {
root /webroot/ staticl ;
}
 
location ~* \. (html Igif ljpg ljpeglpnglcssljslico)$ {
root /webroot / res/ ;
}

3、第三个是通用规则

比如用来转发带.php、.jsp后缀的动态请求到后端应用服务器，非静态文件请求就默认是动态请求（跳转/反向代理）

upstreamtomcat_server {
192.168.100.128:80
192.168.100.132:80
}
 
location / {
    proxy_pass http://tomcat_server;
}

httpd服务

跑一些应用在HTTPD 服务中，以这类形式提供服务的话HTTPD就是做为应用服务器

如果HTTPD仅做为“处理动态请求”定位，则httpd就是做为web服务器

app对应的执行代码需要一个环境做支持/支撑环境，可以由应用服务器提供——HTTPD、tomcat

rewrite命令常用判断表达式

1、判断表达式

-f 和 !-f用来判断是否存在文件

-d 和 !-d用来判断是否存在目录

-e 和 !-e用来判断是否存在文件或目录

-x 和 !-x用来判断文件是否可执行

2、判断全局变量

$args #这个变量等于请求行中的参数。

$content_length # 请求头中的Content-length字段。

$content_type # 请求头中的Content-Type字段。

$document_root # 当前请求在root指令中指定的值。

$host # 请求主机头字段，否则为服务器名称。

$http_user_agent # 客户端agent信息

$http_cookie # 客户端cookie信息

$limit_rate # 这个变量可以限制连接速率。

$request_body_file # 客户端请求主体信息的临时文件名。

$request_method # 客户端请求的动作，通常为GET或POST。

$remote_addr # 客户端的IP地址。

$remote_port # 客户端的端口。

$remote_user # 已经经过Auth Basic Module验证的用户名。

$request_filename # 当前请求的文件路径，由root或alias指令与URI请求生成。

query_string # 与args相同。

$scheme #HTTP 方法（如http，https）。

$server_protocol # 请求使用的协议，通常是HTTP/1.0或HTTP/1.1。

$server_addr # 服务器地址，在完成一次系统调用后可以确定这个值。

$server_name # 服务器名称。

$server_port # 请求到达服务器的端口号。

$request_uri # 包含请求参数的原始URI，不包含主机名，如：”/foo/bar.php?arg=baz”。

uri # 不带请求参数的当前URI，uri不包含主机名，如”/foo/bar.html”。

document_uri # 与uri相同。

实际应用

1、基于域名的跳转

       这里我们将旧域名www.jlx.com变更，使用新域名www.can.com代替，但是不移除旧域名，并且登陆旧域名将跳转到新域名上，而且后面的参数保持不变。

[root@localhost ~]# vim /usr/local/nginx/conf/nginx.conf

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

[root@localhost ~]# echo "172.16.100.100 www.jlx.com www.can.com" >> /etc/hosts
[root@localhost ~]# systemctl restart nginx

浏览器输入模拟访问 www.jlx.com,会跳转到www.can.com

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

当访问的是 bbs.jlx.com/post/ 会自动跳转到 www.can.com/bbs/post/

[root@localhost ~]# vim /usr/local/nginx/conf/nginx.conf

 server {
        listen       80;
        server_name bbs.jlx.com www.jlx.com;       #域名修改	

        charset utf-8;

        access_log  logs/www.jlx.com-access.log;

        location / {
         location /post{
              rewrite ^/(.*)$ http://www.jlx.com/bbx$1 permanent;    #这里的$1为位置变量，代表/post
              }
            root   html;
            index  index.html index.htm;
        }

[root@localhost ~]# mkdir -p /usr/local/nginx/html/bbs/post
[root@localhost ~]# echo "this is 1.html"  >> /usr/local/nginx/html/bbs/post/1.html
[root@localhost ~]# echo "172.16.100.100 bbs.jlx.com"  >> /etc/hosts
[root@localhost ~]# systemctl restart nginx

使用浏览器访问 bbs.jlx.com/post/1.html 跳转到 www.jlx.com/bbs/post/1.…

基于客户端IP访问跳转

所有IP访问任何内容都显示一个固定维护页面，只有公司IP 172.16.100.100访问正常。

[root@localhost ~]# vim /usr/local/nginx/conf/nginx.conf

    server {
        listen       80;
        server_name  www.jlx.com;

        charset utf-8;

        access_log  logs/www.jlx.com-access.log;
        set $rewrite true;
           if ($remote_addr = "192.168.80.10"){
                  set $rewrite false;
              }
            if ($rewrite = true){
               rewrite (.+) /weihu.html;
           }
            location = /weihu.html {
           root /var/www/html;
          }
          location /{
            root   html;
            index  index.html index.htm;
        }

172.16.100.100访问

其他主机访问

4、基于参数匹配（多余的）的跳转

现在访问www.jlx.com/100-(100|20… 跳转到www.jlx.com页面。

[root@localhost ~]# vim /usr/local/nginx/conf/nginx.conf

    server {
        listen       80;
        server_name  www.jlx.com;         #域名修改

        charset utf-8;

        access_log  logs/www.jlx.com-access.log;
           if ($request_uri ~ ^/100-(100|200)-(\d+).html$) {
     rewrite (.+) http://www.jlx.com permanent;
}
          location /{
            root   html;
            index  index.html index.htm;
        }

[root@localhost ~]# systemctl restart nginx

这里当我们访问如www.jlx.com/100-100-10.… 的站点目录时都会跳转到 www.jlx.com

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

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

[root@localhost ~]# vim /usr/local/nginx/conf/nginx.conf

  server {
        listen       80;
        server_name  www.jlx.com;

        charset utf-8;

        access_log  logs/www.jlx.com-access.log;

      location ~* /upload/.*\.php$ {
     rewrite (.+) http://www.jlx.com permanent;
}
          location /{
            root   html;
            index  index.html index.htm;
        }

[root@localhost ~]# systemctl restart nginx

浏览器访问 www.jlx.com/upload/123.… 跳转到www.jlx.com 页面。

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

当访问一个具体的页面站点目录时，跳转至首页

[root@localhost ~]# vim /usr/local/nginx/conf/nginx.conf

    server {
        listen       80;
        server_name  www.jlx.com;

        charset utf-8;

        access_log  logs/www.jlx.com-access.log;

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

[root@localhost ~]# systemctl restart nginx

浏览器访问 www.kgc.com/abc/123.htm… 跳转到www.kgc.com页面