nginx rewrite 指令那些事

秒速五厘米 2023-02-20 07:28 16阅读 0赞

### rewrite模块（ngx\_http\_rewrite\_module） ###

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

<table> 
 <tbody> 
 <tr> 
 <td> 1 2 3 4 5 6 7 8 9 10 11 </td> 
 <td> .&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;:匹配除换行符以外的任意字符 ?&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;:重复0次或1次 +&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;:重复1次或更多次 *&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;:重复0次或更多次 \d&nbsp;&nbsp;&nbsp;&nbsp;:匹配数字 ^&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;:匹配字符串的开始字符 $&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;:匹配字符串的结束字符 {n}&nbsp;&nbsp;&nbsp;:重复n次 {n,}&nbsp;&nbsp;:重复n次或更多次 [c]&nbsp;&nbsp;&nbsp;:匹配单个字符c [a-z]&nbsp;:匹配a-z小写字母的任意一个 </td> 
 </tr> 
 </tbody> 
</table>

在rewrite中，如果使用小括号()，那么在小括号之间匹配的内容，可以在后面通过$1来引用，$2表示的是前面第二个()里的内容，后面会说到。

Rewrite模块指令

1）break

<table> 
 <tbody> 
 <tr> 
 <td> 1 2 3 </td> 
 <td> Syntax:&nbsp;break; Default:— Context:server,&nbsp;location,&nbsp;if </td> 
 </tr> 
 </tbody> 
</table>

此指令的意思是停止执行当前虚拟主机的后续rewrite指令集。使用示例如下：

<table> 
 <tbody> 
 <tr> 
 <td> 1 2 3 4 </td> 
 <td> if&nbsp;($slow)&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;limit_rate&nbsp;10k; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;break; } </td> 
 </tr> 
 </tbody> 
</table>

2）if

<table> 
 <tbody> 
 <tr> 
 <td> 1 2 3 </td> 
 <td> Syntax:&nbsp;if&nbsp;(condition)&nbsp;{&nbsp;...&nbsp;} Default:— Context:server,&nbsp;location </td> 
 </tr> 
 </tbody> 
</table>

对给定的条件（condition）进行判断，如果条件为真，大括号内的rewrite指令将被执行。

条件(conditon)可以是如下任何操作：

1. 当表达式只是一个变量时，如果值为空或任何以0开头的字符串都会当做false；

2. 使用“=”和“!=”比较一个变量和字符串；

3. 使用“~”做正则表达式匹配，“~\*”做不区分大小写的正则匹配，“!~”做区分大小写的正则不匹配；

4. 使用“-f”和“!-f” 检查一个文件是否存在；

5. 使用“-d”和“!-d”检查一个目录是否存在；

6. 使用“-e”和“!-e”检查一个文件、目录、符号链接是否存在；

7. 使用“-x”和“ !-x”检查一个文件是否可执行；

如下示例：

<table> 
 <tbody> 
 <tr> 
 <td> 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 </td> 
 <td> //如果UA包含"MSIE"，rewrite请求到/msid/目录下 if&nbsp;($http_user_agent&nbsp;~&nbsp;MSIE)&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;rewrite&nbsp;^(.*)$&nbsp;/msie/$1&nbsp;break; } &nbsp; //如果cookie匹配正则，设置变量$id等于正则引用部分 if&nbsp;($http_cookie&nbsp;~*&nbsp;"id=([^;]+)(?:;|$)")&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;set&nbsp;$id&nbsp;$1; } &nbsp; //给某个访问IP返回403 if&nbsp;(&nbsp;$remote_addr&nbsp;=&nbsp;"202\.38\.78\.85"&nbsp;){ &nbsp;&nbsp;&nbsp;&nbsp;return&nbsp;403; } &nbsp; //如果提交方法为POST，则返回状态405（Method&nbsp;not&nbsp;allowed）。return不能返回301,302 if&nbsp;($request_method&nbsp;=&nbsp;POST)&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;return&nbsp;405; } &nbsp; //如果$slow可以通过set指令设置，则进行限速处理 if&nbsp;($slow)&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;limit_rate&nbsp;10k; } &nbsp; //如果请求的文件名不存在，则反向代理到localhost&nbsp;。这里的break也是停止rewrite检查 if&nbsp;(!-f&nbsp;$request_filename){ &nbsp;&nbsp;&nbsp;&nbsp;break; &nbsp;&nbsp;&nbsp;&nbsp;proxy_pass&nbsp;http://127.0.0.1; } &nbsp; //如果query&nbsp;string中包含"post=140"，则永久重定向到example.com if&nbsp;($args&nbsp;~&nbsp;post=140){ &nbsp;&nbsp;&nbsp;&nbsp;rewrite&nbsp;^&nbsp;http://example.com/&nbsp;permanent; } &nbsp; //防盗链 location&nbsp;~*&nbsp;\.(gif|jpg|png|swf|flv)$&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;valid_referers&nbsp;none&nbsp;blocked&nbsp;www.baidu.com&nbsp;www.ywnds.com; &nbsp;&nbsp;&nbsp;&nbsp;if&nbsp;($invalid_referer)&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;return&nbsp;404; &nbsp;&nbsp;&nbsp;&nbsp;} } </td> 
 </tr> 
 </tbody> 
</table>

3）return

<table> 
 <tbody> 
 <tr> 
 <td> 1 2 3 4 5 </td> 
 <td> Syntax:&nbsp;return&nbsp;code&nbsp;[text]; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;return&nbsp;code&nbsp;URL; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;return&nbsp;URL; Default:— Context:server,&nbsp;location,&nbsp;if </td> 
 </tr> 
 </tbody> 
</table>

停止处理并为客户端返回状态码，非标准的444状态码将关闭连接，不发送任何响应头。可以使用的状态码有：204，400，402-406，408，410, 411, 413, 416与500-504。如果状态码附带文字段落，该文本将被放置在响应主体。相反，如果状态码后面是一个URL，该URL将成为location头部值。没有状态码的URL将被视为一个302状态码。

4）rewrite

<table> 
 <tbody> 
 <tr> 
 <td> 1 2 3 </td> 
 <td> Syntax:&nbsp;rewrite&nbsp;regex&nbsp;replacement&nbsp;[flag]; Default:— Context:server,&nbsp;location,&nbsp;if </td> 
 </tr> 
 </tbody> 
</table>

rewrite指令的功能就是，使用nginx提供的全局变量或自己设置的变量，然后结合正则表达式和标志位实现url重写以及重定向。rewrite指令只能放在server、location或if中，并且只能对域名后边的除去传递的参数外的字符串起作用，例如 http://ywnds.com/a/we/index.php?id=1&u=str，只对/a/we/index.php重写，语法如上面所示。

如果想对域名或参数字符串起作用，可以使用全局变量匹配，也可以使用proxy\_pass反向代理。

或许看rewrite和location功能有点像，都能实现跳转，主要区别在于rewrite是在同一域名内更改获取资源的路径，而location是对一类路径做控制访问或反向代理，可以proxy\_pass到其他机器。很多情况下rewrite也会写在location里，它们的执行顺序是：

1）处理在server级别中定义的模块指令；

2）为请求查找location；

3）处理在选中的location中定义的模块指令，如果指令改变了URI，按新的URI查找location。这个循环至多重复10次，之后nginx返回错误500 (Internal Server Error)；

如果一个URI匹配了rewrite指令指定的正则表达式（regex），则URI就按照replacement进行重写，而rewrite按配置文件中出现的顺序执行。其中flag标志可以停止继续处理。如果replacement以”http://”或”https://”开始，将不再继续处理，那么这个重定向将直接返回给客户端。

flag可以是如下参数：

*  last，完成该rewrite规则的执行后，停止处理后续rewrite指令集；然后查找匹配改变后URI的新location；
 *  break，完成该rewrite规则的执行后，停止处理后续rewrite指令集，并不再重新查找；但是当前location内剩余非rewrite语句和location外的的非rewrite语句可以执行；
 *  redirect，返回302临时重定向，地址栏会显示跳转后的地址；
 *  permanent，返回301永久重定向，地址栏会显示跳转后的地址；即表示如果客户端不清理浏览器缓存，那么返回的结果将永久保存在客户端浏览器中了。

因为301和302不能简单的只返回状态码，还必须有重定向的URL，这就是return指令无法返回301,302的原因了。这里last和break区别有点难以理解：

1）last一般写在server和if中，而break一般使用在location中；

2）last不终止重写后的url匹配，即新的url会再从server走一遍匹配流程，而break终止重写后的匹配；

3）break和last都能组织继续执行后面的rewrite指令。

示例：

<table> 
 <tbody> 
 <tr> 
 <td> 1 2 3 4 5 6 7 </td> 
 <td> server&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;... &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;rewrite&nbsp;^(/download/.*)/media/(.*)..*$&nbsp;$1/mp3/$2.mp3&nbsp;last; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;rewrite&nbsp;^(/download/.*)/audio/(.*)..*$&nbsp;$1/mp3/$2.ra&nbsp;last; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;return&nbsp;403; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;... } </td> 
 </tr> 
 </tbody> 
</table>

如果这些rewrite放到“/download/”路径，那么location如下所示，这时应使用break而不是last，使用last将循环10次匹配，然后返回500错误:

<table> 
 <tbody> 
 <tr> 
 <td> 1 2 3 4 5 </td> 
 <td> location&nbsp;/download/&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;rewrite&nbsp;^(/download/.*)/media/(.*)..*$&nbsp;$1/mp3/$2.mp3&nbsp;break; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;rewrite&nbsp;^(/download/.*)/audio/(.*)..*$&nbsp;$1/mp3/$2.ra&nbsp;break; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;return&nbsp;403; } </td> 
 </tr> 
 </tbody> 
</table>

对于重写后的URL（replacement）包含原请求的请求参数，原URL的?后的内容。如果不想带原请求的参数，可以在replacement后加一个问号。如下，我们加了一个自定义的参数user=$1,然后在结尾处放了一个问号?，把原请求的参数去掉。

<table> 
 <tbody> 
 <tr> 
 <td> 1 </td> 
 <td> rewrite&nbsp;^/users/(.*)$&nbsp;/show?user=$1?&nbsp;last; </td> 
 </tr> 
 </tbody> 
</table>

注: 对花括号“\}”或“;”来说，使用时需要用双引号或单引号包围。因为他们既能用在重定向的正则表达式里，也是用在配置文件里分割代码块, 为了避免冲突, 正则表达式里带花括号的话，应该用双引号（或者单引号）包围。比如，要将类似以下的URI：”/photos/123456″重定向到”/path/to/photos/12/1234/123456.png”可以用以下方法 (注意双引号):

<table> 
 <tbody> 
 <tr> 
 <td> 1 </td> 
 <td> rewrite&nbsp;"/photos/([0-9] {2})([0-9] {2})([0-9] {2})"&nbsp;/path/to/photos" </td> 
 </tr> 
 </tbody> 
</table>

5）set

<table> 
 <tbody> 
 <tr> 
 <td> 1 2 3 </td> 
 <td> Syntax:&nbsp;set&nbsp;$variable&nbsp;value; Default:— Context:server,&nbsp;location,&nbsp;if </td> 
 </tr> 
 </tbody> 
</table>

定义一个变量并赋值，值可以是文本，变量或者文本变量混合体。

6）rewrite\_log

<table> 
 <tbody> 
 <tr> 
 <td> 1 2 3 </td> 
 <td> Syntax:&nbsp;rewrite_log&nbsp;on&nbsp;|&nbsp;off; Default:rewrite_log&nbsp;off; Context:http,&nbsp;server,&nbsp;location,&nbsp;if </td> 
 </tr> 
 </tbody> 
</table>

开启或关闭以notice级别打印rewrite处理日志到error log文件。nginx打开rewrite log的例子如下：

<table> 
 <tbody> 
 <tr> 
 <td> 1 2 </td> 
 <td> rewrite_log&nbsp;on;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;//打开rewrite&nbsp;log error_log&nbsp;logs/xxx.error.log&nbsp;notice;&nbsp;&nbsp;&nbsp;//把error&nbsp;log的级别调整为notice </td> 
 </tr> 
 </tbody> 
</table>

7）uninitialized\_variable\_warn

<table> 
 <tbody> 
 <tr> 
 <td> 1 2 3 </td> 
 <td> Syntax:&nbsp;uninitialized_variable_warn&nbsp;on&nbsp;|&nbsp;off; Default:uninitialized_variable_warn&nbsp;on; Context:http,&nbsp;server,&nbsp;location,&nbsp;if </td> 
 </tr> 
 </tbody> 
</table>

控制是否输出为初始化的变量到日志。

### 重写规则组成部分 ###

第一部分：任何重写规则的第一部分都是一个正则表达式

正则表达式可以使用括号来捕获，后续可以根据位置来将其引用，位置变量值取决于捕获正则表达式中的顺序，$1引用第一个括号中的值，$2引用第二个括号中的值，以此类推。如：

<table> 
 <tbody> 
 <tr> 
 <td> 1 </td> 
 <td> ^/images/([a-z]{2})/([a-z0-9]{5})/(.*)\.(png|jpg|gif)$ </td> 
 </tr> 
 </tbody> 
</table>

$1是两个小写字母组成的字符串，$2是由小写字母和0到9的数字组成的5个字符的字符串，$3将是个文件名，$4是png、jpg、gif中的其中一个。

第二部分：重写规则的第二部分是URI

当重写规则第一部分被匹配到了之后，则请求被改写，那么该URI可能包含正则表达式中的捕获的位置参数或这个级别下的nginx任何配置变量。如：

如果这个URI不匹配nginx配置的任何location，那么将给客户端返回301(永久重定向)或302(临时重定向)的状态码来表示重定向类型。该状态码可以通过第三个参数来明确指定。

第三部分：重写规则的第三部分就是标记（flag）

第三部分也就是尾部的标记（flag）， last标记将导致重写后的URI搜索匹配nginx的其他location，最多可循环10次。如：

<table> 
 <tbody> 
 <tr> 
 <td> 1 </td> 
 <td> rewrite&nbsp;'^/images/([a-z]{2})/([a-z0-9]{5})/(.*)\.(png|jpg|gif)$'&nbsp;/data?file=$3.$4&nbsp;last; </td> 
 </tr> 
 </tbody> 
</table>

### 全局变量 ###

下面是可以用作if判断的全局变量

<table> 
 <tbody> 
 <tr> 
 <td> 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 </td> 
 <td> $args&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#这个变量等于请求行中的参数，同$query_string; $content_length&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#请求头中的Content-length字段; $content_type&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#请求头中的Content-Type字段; $document_root&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#当前请求在root指令中指定的值，如:root /var/www/html; $host&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#请求主机头字段，否则为服务器名称; $http_user_agent&nbsp;&nbsp;&nbsp;&nbsp;#客户端agent信息; $http_cookie&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#客户端cookie信息; $limit_rate&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#这个变量可以限制连接速率; $request_method&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#客户端请求的动作，通常为GET或POST; $remote_addr&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#客户端的IP地址; $remote_port&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#客户端的端口; $remote_user&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#已经经过Auth Basic Module验证的用户名; $request_filename&nbsp;&nbsp;&nbsp;#当前请求的文件路径，由root或alias指令与URI请求生成; $scheme&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#HTTP方法（如http，https）; $server_protocol&nbsp;&nbsp;&nbsp;&nbsp;#请求使用的协议，通常是HTTP/1.0或HTTP/1.1; $server_addr&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#服务器地址，在完成一次系统调用后可以确定这个值; $server_name&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#服务器名称; $server_port&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#请求到达服务器的端口号; $request_uri&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#包含请求参数的原始URI，不包含主机名，如：”/foo/bar.php?arg=baz”; $uri&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#不带请求参数的当前URI，$uri不包含主机名，如”/foo/bar.html”; $document_uri&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#与$uri相同,例：http://localhost:88/test1/test2/test.php; </td> 
 </tr> 
 </tbody> 
</table>

例如：http://localhost:88/test1/test2/test.php这个URL，其中：

<table> 
 <tbody> 
 <tr> 
 <td> 1 2 3 4 5 6 </td> 
 <td> $host：localhost $server_port：88 $request_uri：http://localhost:88/test1/test2/test.php $document_uri：/test1/test2/test.php $document_root：/var/www/html $request_filename：/var/www/html/test1/test2/test.php </td> 
 </tr> 
 </tbody> 
</table>

### Rewrite模块使用实例 ###

1）使用rewrite指令把访问80端口的请求重定向到443

对于HTTPS网站，一般最少需要定义两个虚拟主机，一个是使用80的虚拟主机，另一个就是使用443端口的虚拟主机了。比如在浏览器输入www.ywnds.com（http://www.ywnds.com）会自动跳转到https://www.ywnds.com。

<table> 
 <tbody> 
 <tr> 
 <td> 1 </td> 
 <td> rewrite&nbsp;^(.*)$&nbsp;https://www.ywnds.com$uri&nbsp;redirect; </td> 
 </tr> 
 </tbody> 
</table>

这种跳转就是302临时重定向跳转，如果把flag变成permanent就成了301永久重定向跳转了。

2）作为重写规则的一部分，传递新的查询字符串参数是使用重写规则的目标之一

<table> 
 <tbody> 
 <tr> 
 <td> 1 </td> 
 <td> rewrite&nbsp;^/images/(.*)_(\d+)x(\d+)\.(png|jpg|gif)$&nbsp;/resizer/$1.$4?width=$2&amp;height=$3?&nbsp;last; </td> 
 </tr> 
 </tbody> 
</table>

3）使用rewrite模块禁止用户代理

Nginx可以通过各种方式来限制访问，例如NGINX基本Http认证、allow/deny等等，这些都是前文提过的，下面来看看nginx如何通过用户代理来禁止访问。

user agent是什么?

简单来说告诉服务器你当前使用的是什么浏览器、工具等来访问我的。例如火狐、chrome、wget、curl等浏览器或工具。使用$http\_user\_agent变量就可以获取到用户代理，一般在定义日志格式时都会使用这个变量，把用户代理记录到日志中去。

如何禁止特定UA？

我们不希望被使用wget或者curl来下载我的文件，怎么做呢？这里就可以使用rewrite模块了，编辑nginx配置文件，以下内容放在http配置段，那么整个nginx都生效。如果放到server里，那么一个域名生效，你放哪，哪就有效！

<table> 
 <tbody> 
 <tr> 
 <td> 1 2 3 </td> 
 <td> if&nbsp;($http_user_agent&nbsp;~*&nbsp;(curl)&nbsp;)&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;return&nbsp;404; } </td> 
 </tr> 
 </tbody> 
</table>

禁止多个UA

<table> 
 <tbody> 
 <tr> 
 <td> 1 2 3 </td> 
 <td> if&nbsp;($http_user_agent&nbsp;~*&nbsp;(wget|curl)&nbsp;)&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;return&nbsp;404; } </td> 
 </tr> 
 </tbody> 
</table>

nginx重写规则说起来挺简单的，做起来就难，重点在于正则表达式，同时，还需要考虑到nginx执行顺序。