Nginx重写功能

一.Nginx常见模块

• http

  http块是Nginx服务器配置中的重要部分，代理、缓存和日志定义等绝大多数的功能和第三方模块的配置都可以放在这模块中。作用包括：文件引入、MIME-Type定义、日志自定义、是否使用sendfile传输文件、连接超时时间、单连接请求数上限等。

• server

  server块，虚拟主机（虚拟服务器）。作用：使得Nginx服务器可以在同一台服务器上只要运行一组Nginx进程，就可以运行多个网站。

• location

  location块是server块的一个指令。作用：基于Nginx服务器接收到的请求字符串，虚拟主机名称（ip，域名）、url匹配，对特定请求进行处理。

二.location

2.1、location常用正则表达式

常用的正则表达式

字符	含义
.	匹配任意单个字符，可以是一个汉字
^	行首锚定, 用于模式的最左侧
$	行尾锚定，用于模式的最右侧
*	匹配前面字符任意次(包括0次)
?	0或1次
+	1次或多次（1次或以上）
\	转义符
\d	只匹配数字
{n}	重复n次
{n,}	至少n次（n次货以上）
{n,m}	n到m次
[ ]	定义匹配字符的范围，只匹配一次
[c]	单个字符
[a-z]	匹配任意小写字母
[a-zA-Z0-9]	匹配任意字母和数字
（）	表达式的开始和结束位置
|	或运算符a|b

从功能看 rewrite 和 location 似乎有点像，都能实现跳转，主要区别在于 rewrite 是在同
一域名内更改获取资源的路径，而 location 是对一类路径做控制访问或反向代理，还可以
proxy_pass 到其他机器。

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

2.2、location 常用的匹配规则

规则表达式	规则含义
=	进行普通字符精确匹配。也就是完全匹配
^~	表示普通字符匹配。使用前缀匹配。如果匹配成功，则不再匹配其他 location
~	表示执行一个正则匹配，区分大小写
~*	表示执行一个正则匹配，不区分大小写
!~	表示执行一个正则匹配，区分大小写不匹配
!~*	表示执行一个正则匹配，不区分大小写不匹配

2.3、 location优先级排列说明

1. 等号类型（=）的优先级最高。一旦匹配成功，则不再查找其他匹配项。
2. ^~类型表达式。一旦匹配成功，则不再查找其他匹配项。
3. 正则表达式类型（_和*）的优先级次之。常规字符串匹配类型（不带任何修饰符的匹配），按前缀匹配。/test
4. 通用匹配（/），如果没有其它匹配，任何请求都会匹配到。

location = / {
    [ configuration A ]
}

location / {
    [ configuration B ]
}

location /documents/ {
    [ configuration C ]
}

location ^~ /images/ {
    [ configuration D ]
}

location ~* \.(gif|jpg|jpeg)$ {
    [ configuration E ]
}

2.4、location 示例

（1）精确匹配

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

（2）一般匹配/通用匹配

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

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

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

(3)正则匹配

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


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

（4）location 优先级总结：
如果是匹配某个具体文件：(location = 完整路径) > (location ^~ 完整路径) > (location ~ 完整路径) >(location ~ 完整路径) > (location /)通用匹配*

三.REWRITE模块

现在 Nginx 已经成为很多公司作为前端反向代理服务器的首选，在实际工作中往往会
遇到很多跳转（重写 URL）的需求。比如更换域名后需要保持旧的域名能跳转到新的域名上、某网页发生改变需要跳转到新的页面、网站防盗链等等需求。如果在后端使用的 Apache服务器，虽然也能做跳转，规则库也很强大，但是用 Nginx 跳转效率会更高。

3.1、rewrite功能

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

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

3.2、Rewrite 跳转场景

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

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

3.3、Rewrite 跳转实现

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

5.4Rewrite 执行顺序如下

rewrite执行顺序如下:

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

3.5语法格式

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。