nginx rewrite规则详解

Nginx Rewrite

Rewrite

Rewrite介绍

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

Rewrite跳转场景

（1）URL看起来更规范、合理
（2）企业会将动态URL地址伪装成静态地址提供服务
（3）网址换新域名后，让旧的访问跳转到新的域名上
（4）服务端默写业务的调整

Rewrite跳转的实现

ngx_http_rewrite_module

（1）Nginx：支持URL重写、支持if条件判断，但不支持else
（2）跳转：循环最多可执行10次，超过后Nginx将返回500错误
（3）PCRE支持、重写模块set指令：rewrite使用Nginx全局变量或自己设置的变量，结合正则表达式和标志位实现URL重写以及重定向

Rewrite实现场景

Nginx跳转需求的实现方式

（1）使用rewrire进行匹配
（2）使用if匹配全局变量后跳转
（3）使用location匹配再跳转

rewrite放在server{}，if{}，location{}段中

对域名或参数字符串

（1）使用if全局变量匹配
（2）使用proxy_pass反向代理

Nginx正则表达式

常用的正则表达式元字符

字符	说明
^	匹配输入字符串的起始位置
$	匹配输入字符串的结束位置
*	匹配前面的字符零次或多次
+	匹配前面的字符一次或多次
？	匹配前面的字符零次或一次
.	匹配除了“\n”之外的任何单个字符，使用诸如“[.\n]”之类的模式 ，可匹配包括“\n”在内的任意字符
\	将后面接着的字符标记为一个特殊字符或一个原义字符或一个向后引用
\d	匹配纯数字
{n}	重复n次
{n,}	重复n次或多次
[c]	匹配单个字符c
[a-z]	匹配a-z小写字母的任意一个
[a-zA-Z]	匹配a-z小写字母或A-Z大写字母的任意一个

Rewrite命令

语法

rewrite    <regex> （正则）  <replacement>（跳转后的内容)     [flag];(rewrite支持的flag标记)

flag标记的说明

标记	说明
last	相当于Apache的[L]标记，表示完成rewrite
break	本条规则匹配完成即终止，不再匹配后边的任何规则
redirect	返回302临时重定向，浏览器地址会显示跳转后的URL地址，爬虫不会更新url
permanent	返回301永久重定向，浏览器地址栏会显示跳转后的URL地址，爬虫更新url

last和break比较

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

location

location分类

分类

location = patt {}   [精准匹配]

location patt {}  [一般匹配]

location ~ patt {}  [正则匹配]

正则匹配的常用表达式

标记	说明
~	执行一个正则匹配，区分大小写
~*	执行一个正则匹配，不区分大小写
!~	执行一个正则匹配，区分大小写 不匹配
!~*	执行一个正则匹配，不区分大小写不匹配
^~	普通字符匹配；使用前缀匹配。如果匹配成功，则不再匹配其他location
=	普通字符精确匹配。也就是完全匹配
@	定义一个命名的location，使用在内部定向时

location的优先级

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

按优先级排列

• =类型
• ^~ 类型表达式
• 正则表达式（_和*）类型
• 常规字符串匹配类型，按前缀匹配
• 通用匹配（/），如果没有其他匹配，任何请求都会匹配到

比较rewrite和location

相同点

• 都能实现跳转

不同点

• rewrite是在同一域名内更改获取资源的路径
• location是对一类路径做控制访问或反向代理，还可以proxy_pass到其他机器

rewrite会写在location里，执行顺序

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

location优先级示例

location = /{
[configuration A]             //精确匹配/，主机后面不能带任何字符串
}

location /{
[configuration B]             //所有的地址都以/开头，这条规则将匹配到所有请求，但正则和最长字符串会优先匹配
}

location /documents/{
[configuration C]       //匹配任何以/decuments/开头的地址，当后面的正则表达式没有匹配到时，才起作用
}

location ~/documents/abc{
[configuration D]  //匹配到任何以/decuments/abc/开头的地址，当后面的正则表达式没有匹配到时，才会起作用
}

location优先级示例2

location ^~/images/{
[configuration E]    //以/image/开头的地址，匹配符合后，停止往下匹配
}

location ~*\.(gif|jpg|jpeg)${
[configuration F]      //匹配所有以gif，jpg或jpeg结尾的请求，/images/下的图片会被[configuration E]处理，因为^~的优先级更高
}

location /images/abc{
[configuration G]    //最长字符匹配到/image/abc，优先级最低
}

location ~/images/abc{
[configuration H]   //以/image/abc开头的，优先级次之
}

location  /images/abc/1.html{
[configuration I]     //如果和正则~/images/abc/1.html相比，正则优先级更高
}

location优先级规则

匹配某个具体文件

• （location = 完整路径）> （location ^~ 完整路径）>（location ~* 完整路径）> （location ~ 完整路径）>（location 完整路径） >（location /）

用目录做匹配访问某个文件

• （location = 目录）> （location ^~ 目录）> （location ~ 目录）> （location ~* 目录）> （location 目录）>（location /）