Nginx之八 URL重写（rewrite）配置

缺乏、安全感 2022-05-12 15:14 347阅读 0赞

## Nginx URL重写（rewrite）配置及信息详解 ##

**1）if判断指令**

> 语法为if(condition)\{…\}     \#对给定的条件condition进行判断。  
> 如果为真，大括号内的rewrite指令将被执行，if条件(conditon)可以是如下任何内容：  
>   
>   a:当表达式只是一个变量时，如果值为空或任何以0开头的字符串都会当做false，其他情况为true。  
>   b: 直接比较变量和内容时，使用 = 或!=  
>   c: 正则表达式匹配，\*不区分大小写的匹配，!和！\*反之。  
>   
> 注意：使用正则表达式字符串一般不需要加引号，但是如果含有右花括号“\}”或者分号“；”字符时，必须要给整个正则表达式加引号  
>   
> 其他指令：  
> \-f和!-f用来判断请求文件是否存在  
> \-d和!-d用来判断请求目录是否存在  
> \-e和!-e用来判断是请求的文件或者目录否存在  
> \-x和!-x用来判断请求的文件是否可执行  
>   
> 例子：if (-f $request\_filename)\{  
>         … \#判断请求的文件是否存在，存在就执行这里面的代码块  
>     \}

**2）break指令**

> 用于中断当前相同作用域中的Nginx配置，和Java中的break语法类似，可以在server块和location以及if块中使用。  
> 语法：break;

**3）if 可用的全局变量**  
还有$host\_host变量，和$host区别如下：  
$host不带端口，$http\_host带端口  
![在这里插入图片描述][70]

**4）return指令**

>  该指令用于完成对请求的处理，直接向客户端响应状态的代码。和Java中的return语法类似。可以再server块和location以及if块中使用。  
>   
>  语法：return code URL;  \#code表示状态码，URL表示返回给客户单的URL地址  
>  或者：return URL: \#当状态码是302或者307的时候，可以使用，返回的URL必须包含“http://”、“https://”或者直接使用“$scheme”变量(RequestScheme代表传输协议，  
> Nginx内置变量)  
>   或者 return \[text\]; \#为返回给客户端的响应体内容，支持变量的使用

**5）rewrite指令**

>  该指令通过正则表达式的使用来改变URI.可以同时存在一个或者多个指令，按照顺序一次对URL进行匹配和处理。该指令可以在server块后者location块中配置  
>   
>   语法： 　指令语法：rewrite regex replacement \[flag\];  
> 　  **rewrite**是实现URL重定向的重要指令， 　  
>    **regex**：用来匹配URI的正则表达式；  
> 　  **replacement**：匹配成功后用来替换URI中被截取内容的字符串，默认情况如果该字符串包含“http://”、"https://"开头，则不会继续向下对URI进行其他处理。直接返回重写的URI给客户端  
>     **flag**：用来设置rewrite对URI的处理行为,包含如下数据：
> 
> <table> 
>  <thead> 
>   <tr> 
>    <th>标记符号</th> 
>    <th align="left">说明</th> 
>   </tr> 
>  </thead> 
>  <tbody> 
>   <tr> 
>    <td>last</td> 
>    <td align="left">终止在本location块中处理接收到的URI，并将此处重写的URI作为新的URI使用其他location进行处理。（只是终止当前location的处理）</td> 
>   </tr> 
>   <tr> 
>    <td>break</td> 
>    <td align="left">将此处重写的URI作为一个新的URI在当前location中继续执行，并不会将新的URI转向其他location。</td> 
>   </tr> 
>   <tr> 
>    <td>redirect</td> 
>    <td align="left">将重写后的URI返回个客户端，状态码是302，表明临时重定向，主要用在replacement字符串不以“http://”，“ https://”或“ $scheme” 开头；</td> 
>   </tr> 
>   <tr> 
>    <td>permanent</td> 
>    <td align="left">将重写的URI返回客户端，状态码为301,指明是永久重定向；</td> 
>   </tr> 
>  </tbody> 
> </table>

**6）rewrite\_log指令**

> 该指令用于是否开启URL重写日志的输出，  
> 语法：  
>   rewrite\_log on | off  
>   默认是off，如果配置为on，URL重写的相关日志将以notice级别输出到error\_log指令配置的日志文件中

**7）set指令**

> 用来设置新的变量，  
>   语法: set variable value;  
>     variable,这个是变量的名称，这个符号的“$”必须作为变量第一个字符，并且不能和Nginx服务器预设的全局变量同名  
>     value,为变量的值。  
> 比如 set $id “3”; \#设置id为3

**8）uninitialized\_variable\_warn指令**

> 这个指令用来配置会用未初始化的变量时，是否记录警告日志，  
>  语法： unitialized\_variable\_warn on | off  
>   默认设置时on状态

**9）防盗链的例子**

语法：valid_referers none | blocked | server_name | string ...;

> 这里表示请求头部Referer域是否匹配上面值，如果匹配了$invalid\_referer 的值为0，没有相匹配就是1；
> 
> <table> 
>  <thead> 
>   <tr> 
>    <th>字符</th> 
>    <th align="left">说明</th> 
>   </tr> 
>  </thead> 
>  <tbody> 
>   <tr> 
>    <td>none</td> 
>    <td align="left">表示Referer头域不存在的情况</td> 
>   </tr> 
>   <tr> 
>    <td>blocked</td> 
>    <td align="left">检测Referer头域的值被防火墙或者代理服务器删除或者伪装的情况，这种情况，该头域的值不以“http://”或者“https://”开头</td> 
>   </tr> 
>   <tr> 
>    <td>server_name</td> 
>    <td align="left">设置一个或者多个URL，检测Referer头域的值是否是这些URL中的某个</td> 
>   </tr> 
>  </tbody> 
> </table>

**10）例子**

例子一（域名跳转）:
        server {
                listen 80;
                server_name   abc.com;
                rewrite   ^/(.*)     http://www.ab c.com/$1 permanent;  # 跳转到www.abc.com网址上
            }
    例子二：
      server {
                listen 80;
                server_name   www.myweb.com www.web.info
                if($host ~ myweb\.info){                        #"."需要使用“\”转义，这里是匹配到www.web.info时
                         rewrite ^(.*)  http://www.myweb.com/&1 permanent;   #永久重定向到http://www.myweb.com网址上&1是匹配的uri
                }
            }
    例子三(防盗链)：
    location ~* \.(gif|jpg|png|swf|flv)$ {
        valid_referers none blocked www.vison.com www.wsvison.com;  #这里表示Referer头域中的值是none或者blocked或者后面这些网址才会返回去正常的gif|jpg|png|swf|flv文件，否则执行下面if块代码
        if ($invalid_referer) {  #上面没有匹配成功，$invalid_referer值为1，否则为0
            return 404;
        } //防盗链
    }       
    其他例子：    
    if ($http_user_agent ~ MSIE) {
        rewrite ^(.*)$ /msie/$1 break;
    } //如果UA包含"MSIE"，rewrite请求到/msid/目录下
    
    if ($http_cookie ~* "id=([^;]+)(?:;|$)") {
        set $id $1;
     } //如果cookie匹配正则，设置变量$id等于正则引用部分
    
    if ($request_method = POST) {
        return 405;
    } //如果提交方法为POST，则返回状态405（Method not allowed）。return不能返回301,302
    
    if ($slow) {
        limit_rate 10k;
    } //限速，$slow可以通过 set 指令设置
    
    if (!-f $request_filename){
        break;
        proxy_pass  http://127.0.0.1; 
    } //如果请求的文件名不存在，则反向代理到localhost 。这里的break也是停止rewrite检查
    
    if ($args ~ post=140){
        rewrite ^ http://example.com/ permanent;
    } //如果query string中包含"post=140"，永久重定向到example.com

参考：https://segmentfault.com/a/1190000002797606\#articleHeader0

[70]: /images/20220504/27358c5a7a7c4abf8ef397d2f19dead2.png