Nginx详解（六）

系统管理员 2022-02-09 09:13 252阅读 0赞

## 7. Nginx rewrite 配置（二） ##

nginx的rewrite配置是nginx配置中比较核心的部分，rewrite可以实现域名跳转（重定向）、URL重写（伪静态）、动静分离（跳转域名，并接入CDN实现加速）。rewrite依赖pcre库，用到的模块是ngx\_http\_rewrite\_module。

--------------------

### rewrite规则 ###

格式：rewrite regex replacement [flag]
    
    * rewrite配置可以在server、location以及if配置段内生效
    
    * regex是用于匹配的正则表达式，其不会匹配到$host（域名）
    
    * replacement是目标跳转的uri，可以以http://或https://开头，也可以省略掉$host，直接写$request_uri部分（即请求链接）
    
    * flag，用来设置rewrite对uri的处理行为，其中有break、last、redirect、permanent。redirect和permanent的区别在于，redirect是临时重定向（302），而permanent是永久重定向（301）。
      对于用户访问来说，两者效果一致；但对于搜索引擎爬虫来说，使用301更利于SEO。所以，建议replacement是以http://或https://开头的，flag使用permanent

*  示例1：

location / { 
        rewrite /(.*) http://www.123.com/$1 permanent;
    }

说明：.\* 为正则表达式，用()括起来，在后面的URL中可以调用它，第一次出现的()用$1调用，第二次出现的()用$2调用，依次类推。

*  示例2：

location / { 
        rewrite /.* http://www.123.com$request_uri permanent;
    }

说明：在replacement中，支持变量，这里的$request\_uri就是客户端请求的链接。

*  示例3：

server { 
        listen 80;
        service_name www.123.com;
        root /tmp/123.com;
        index index.html;
        rewrite /(.*) /abc/$1 redirect;
    }

说明：本例中的rewrite规则有问题，会造成连续循环，而nginx有个最大50次限制，循环超过50次会失败。

修改配置：

# vim /usr/local/nginx/conf/vhost/www.2.com.conf 
    
    server { 
        listen 80;
        server_name www.2.com;
        index index.html;
        root /data/wwwroot/www.2.com;
    
        location / { 
            rewrite /(.*) /abc/$1 redirect;
        }
    }

重载配置：

# /usr/local/nginx/sbin/nginx -t
    
    # /usr/local/nginx/sbin/nginx -s reload

访问测试：

# curl -x127.0.0.1:80 www.2.com/1.html
    
    <html>
    <head><title>302 Found</title></head>
    <body bgcolor="white">
    <center><h1>302 Found</h1></center>
    <hr><center>nginx</center>
    </body>
    </html>
    
    # curl -x127.0.0.1:80 www.2.com/1.html -L
    curl: (47) Maximum (50) redirects followed

# curl -x127.0.0.1:80 www.2.com/1.html -I
    
    HTTP/1.1 302 Moved Temporarily
    Server: nginx
    Date: Mon, 22 Apr 2019 13:41:15 GMT
    Content-Type: text/html
    Content-Length: 154
    Location: http://www.2.com/abc/1.html
    Connection: keep-alive
    
    # curl -x127.0.0.1:80 www.2.com/abc/1.html -I
    
    HTTP/1.1 302 Moved Temporarily
    Server: nginx
    Date: Mon, 22 Apr 2019 13:41:27 GMT
    Content-Type: text/html
    Content-Length: 154
    Location: http://www.2.com/abc/abc/1.html
    Connection: keep-alive

可以看到，一直在循环 /abc ，直到循环超过50次。

*  示例4：

server { 
        listen 80;
        service_name www.123.com;
        root /tmp/123.com;
        index index.html;
        rewrite /(.*) /abc/$1 break;
    }

说明：在rewrite中使用break，可以避免循环。

*  示例5：

server { 
        listen 80;
        service_name www.123.com;
        root /tmp/123.com;
        index index.html;
        if ($request_uri !~ '^/abc/')
        { 
            rewrite /(.*) /abc/$1 redirect;
        }
    }

说明：增加一个条件判断，也可以避免循环。

修改配置：

# vim /usr/local/nginx/conf/vhost/www.2.com.conf 
    
    server { 
        listen 80;
        server_name www.2.com;
        index index.html;
        root /data/wwwroot/www.2.com;
    
        if ($request_uri !~ '^/abc/')
        { 
            rewrite /(.*) /abc/$1 redirect;
        }
    }

重载配置：

# /usr/local/nginx/sbin/nginx -t
    
    # /usr/local/nginx/sbin/nginx -s reload

访问测试：

# curl -x127.0.0.1:80 www.2.com/1.html -I
    
    HTTP/1.1 302 Moved Temporarily
    Server: nginx
    Date: Mon, 22 Apr 2019 13:48:42 GMT
    Content-Type: text/html
    Content-Length: 154
    Location: http://www.2.com/abc/1.html
    Connection: keep-alive
    
    # curl -x127.0.0.1:80 www.2.com/abc/1.html -I
    
    HTTP/1.1 404 Not Found
    Server: nginx
    Date: Mon, 22 Apr 2019 13:50:21 GMT
    Content-Type: text/html
    Content-Length: 162
    Connection: keep-alive

有了条件判断之后，不再进行循环，如果符合条件，直接redirect。

--------------------

### nginx全局变量 ###

nginx常用全局变量：

<table> 
 <thead> 
  <tr> 
   <th align="center">变量</th> 
   <th align="center">说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="center">$args</td> 
   <td align="center">请求中的参数，如 <a href="http://www.123.com/1.php?a=1&amp;b=2" rel="nofollow">www.123.com/1.php?a=1&amp;b=2</a> 的$args就是 a=1&amp;b=2</td> 
  </tr> 
  <tr> 
   <td align="center">$content_length</td> 
   <td align="center">http请求信息里的“Content-Length”</td> 
  </tr> 
  <tr> 
   <td align="center">$content_type</td> 
   <td align="center">http请求信息里的“Content-Type”</td> 
  </tr> 
  <tr> 
   <td align="center">$content_root</td> 
   <td align="center">nginx虚拟主机配置文件中的 root参数对应的值</td> 
  </tr> 
  <tr> 
   <td align="center">$document_uri</td> 
   <td align="center">当前请求中不包含指令的URI，如 <a href="http://www.123.com/1.php?a=1&amp;b=2" rel="nofollow">www.123.com/1.php?a=1&amp;b=2</a> 的 $document_uri 就是1.php，不包含后面的参数</td> 
  </tr> 
  <tr> 
   <td align="center"><strong>$host</strong></td> 
   <td align="center">主机头，即域名</td> 
  </tr> 
  <tr> 
   <td align="center"><strong>$http_user_agent</strong></td> 
   <td align="center">客户端的详细信息，也就是浏览器的标识，用curl -A可以指定</td> 
  </tr> 
  <tr> 
   <td align="center">$http_cookie</td> 
   <td align="center">客户端的cookie信息</td> 
  </tr> 
  <tr> 
   <td align="center">$limit_rate</td> 
   <td align="center">如果nginx服务器使用limit_rate配置了显示网络速率，则会显示，没有设置则显示为0</td> 
  </tr> 
  <tr> 
   <td align="center">$remote_addr</td> 
   <td align="center">客户端公网ip</td> 
  </tr> 
  <tr> 
   <td align="center">$remote_port</td> 
   <td align="center">客户端的port</td> 
  </tr> 
  <tr> 
   <td align="center">$remote_user</td> 
   <td align="center">如果nginx有配置认证，该变量代表客户端认证的用户名</td> 
  </tr> 
  <tr> 
   <td align="center">$request_body_file</td> 
   <td align="center">做反向代理时发给后端服务器的本地资源的名称</td> 
  </tr> 
  <tr> 
   <td align="center">$request_method</td> 
   <td align="center">请求资源的方式，GET/PUT/DELETE等</td> 
  </tr> 
  <tr> 
   <td align="center">$request_filename</td> 
   <td align="center">当前请求的资源文件的路径名称，相当于是 $document_root/$document_uri 的组合</td> 
  </tr> 
  <tr> 
   <td align="center"><strong>$request_uri</strong></td> 
   <td align="center">请求的链接，包括 $document_uri 和 $args</td> 
  </tr> 
  <tr> 
   <td align="center">$scheme</td> 
   <td align="center">请求的协议，如ftp,http,https</td> 
  </tr> 
  <tr> 
   <td align="center">$server_protocol</td> 
   <td align="center">客户端请求资源使用的协议的版本，如HTTP/1.0，HTTP/1.1，HTTP/2.0等</td> 
  </tr> 
  <tr> 
   <td align="center">$server_addr</td> 
   <td align="center">服务器IP地址</td> 
  </tr> 
  <tr> 
   <td align="center">$server_name</td> 
   <td align="center">服务器的主机名</td> 
  </tr> 
  <tr> 
   <td align="center">$server_port</td> 
   <td align="center">服务器的端口号</td> 
  </tr> 
  <tr> 
   <td align="center">$uri</td> 
   <td align="center">和$document_uri相同</td> 
  </tr> 
  <tr> 
   <td align="center"><strong>$http_referer</strong></td> 
   <td align="center">客户端请求时的referer，通俗讲就是该请求是通过哪个链接跳过来的，用curl -e可以指定</td> 
  </tr> 
 </tbody> 
</table>

--------------------

### rewrite实战 ###

本部分内容为nginx生产环境下使用的场景示例。

#### 域名跳转（域名重定向） ####

*  示例1（不带条件）：

server { 
        listen 80;
        server_name www.1.com;
        rewrite /(.*) http://www.2.com/$1 permanent;
        ......
    }

修改配置：

# vim /usr/local/nginx/conf/vhost/www.1.com.conf 
    
    server { 
        listen 80;
        server_name www.1.com;
        index index.html;
        root /data/wwwroot/www.1.com;
    
        rewrite_log on;
        rewrite /(.*) http://www.2.com/$1 permanent;
    }

重载配置：

# /usr/local/nginx/sbin/nginx -t
    
    # /usr/local/nginx/sbin/nginx -s reload

访问测试：

# curl -x127.0.0.1:80 www.1.com -I
    
    HTTP/1.1 301 Moved Permanently
    Server: nginx
    Date: Wed, 24 Apr 2019 12:47:15 GMT
    Content-Type: text/html
    Content-Length: 178
    Connection: keep-alive
    Location: http://www.2.com/                 #301跳转到www.2.com

*  示例2（带条件）：

server { 
        listen 80;
        server_name www.1.com 1.com;
        if ($host != 'www.1.com') { 
            rewrite /(.*) http://www.2.com/$1 permanent;
        ......
        }
    }

修改配置：

# vim /usr/local/nginx/conf/vhost/www.1.com.conf 
    
    server { 
        listen 80;
        server_name www.1.com 1.com;
        index index.html;
        root /data/wwwroot/www.1.com;
    
        rewrite_log on;
        if ($host != 'www.1.com') { 
        rewrite /(.*) http://www.2.com/$1 permanent;
        }
    }

重载配置：

# /usr/local/nginx/sbin/nginx -t
    
    # /usr/local/nginx/sbin/nginx -s reload

访问测试：

# curl -x127.0.0.1:80 www.1.com -I
    
    HTTP/1.1 200 OK
    Server: nginx
    Date: Wed, 24 Apr 2019 12:52:24 GMT
    Content-Type: text/html
    Content-Length: 10
    Last-Modified: Sat, 06 Apr 2019 09:42:39 GMT
    Connection: keep-alive
    ETag: "5ca8748f-a"
    Accept-Ranges: bytes                #是www.1.com时照常访问
    
    # curl -x127.0.0.1:80 1.com -I
    
    HTTP/1.1 301 Moved Permanently
    Server: nginx
    Date: Wed, 24 Apr 2019 12:52:33 GMT
    Content-Type: text/html
    Content-Length: 178
    Connection: keep-alive
    Location: http://www.2.com/                     #是1.com时301跳转到www.2.com

*  示例3（http跳转到https）：

server { 
        listen 80;
        server_name www.1.com;
        rewrite /(.*) https://www.2.com/$1 permanent;
        ......
    }

修改配置：

重载配置：

# /usr/local/nginx/sbin/nginx -t
    
    # /usr/local/nginx/sbin/nginx -s reload

访问测试：

# curl -x127.0.0.1:80 www.1.com -I
    
    HTTP/1.1 301 Moved Permanently
    Server: nginx
    Date: Wed, 24 Apr 2019 12:59:28 GMT
    Content-Type: text/html
    Content-Length: 178
    Connection: keep-alive
    Location: https://www.2.com/                 #301跳转到https://www.2.com

如果本身就是请求的https也不用担心，因为https请求的是443端口而不是80端口。

*  示例4（域名访问二级目录）：

server { 
        listen 80;
        server_name www.1.com;
        rewrite /(.*) https://www.2.com/aaa/$1 last;
        ......
    }

修改配置：

重载配置：

# /usr/local/nginx/sbin/nginx -t
    
    # /usr/local/nginx/sbin/nginx -s reload

访问测试：

# curl -x127.0.0.1:80 www.1.com -I
    
    HTTP/1.1 302 Moved Temporarily
    Server: nginx
    Date: Wed, 24 Apr 2019 13:05:18 GMT
    Content-Type: text/html
    Content-Length: 154
    Connection: keep-alive
    Location: http://www.2.com/aaa/                 #302跳转到http://www.2.com/aaa/

*  示例5（静态请求分离）：

server { 
        listen 80;
        server_name www.1.com;
        location ~* ^.+.(jpg|jpeg|gif|css|png|js)$
        { 
            rewrite /(.*) https://www.2.com/$1 permanent;
        }
        ......
    }

或者

server { 
        listen 80;
        server_name www.1.com;
        if ( $uri ~* (jpg|jpeg|gif|css|png|js)$)
        { 
            rewrite /(.*) https://www.2.com/$1 permanent;
        }
        ......
    }

修改配置：

# vim /usr/local/nginx/conf/vhost/www.1.com.conf 
    
    server { 
        listen 80;
        server_name www.1.com;
        index index.html;
        root /data/wwwroot/www.1.com;
    
        rewrite_log on;
        location ~* ^.+.(jpg|jpeg|gif|css|png|js)$
        { 
            rewrite /(.*) http://img.2.com/$1 permanent;
        }
    }

重载配置：

# /usr/local/nginx/sbin/nginx -t
    
    # /usr/local/nginx/sbin/nginx -s reload

访问测试：

# curl -x127.0.0.1:80 www.1.com/1.jpg -I
    
    HTTP/1.1 301 Moved Permanently
    Server: nginx
    Date: Wed, 24 Apr 2019 13:22:30 GMT
    Content-Type: text/html
    Content-Length: 178
    Connection: keep-alive
    Location: http://img.2.com/1.jpg                    #301跳转到http://img.2.com/1.jpg
    
    # curl -x127.0.0.1:80 www.1.com/abc/1.jpg -I
    
    HTTP/1.1 301 Moved Permanently
    Server: nginx
    Date: Wed, 24 Apr 2019 13:21:42 GMT
    Content-Type: text/html
    Content-Length: 178
    Connection: keep-alive
    Location: http://img.2.com/abc/1.jpg                 #301跳转到http://img.2.com/abc/1.jpg

#### 防盗链 ####

*  示例6：

server { 
        listen 80;
        server_name www.1.com;
        location ~* ^.+.(jpg|jpeg|gif|css|png|js|rar|zip|flv)$
        { 
            valid_referers none blocked server_names *.1.com 1.com *.2.com 2.com;
            if ($invalid_referer)
            { 
                rewrite /(.*) http://img.1.com/images/forbidden.png;            #或者直接 return 403;
            }
        }
        ......
    }

说明：

* 这里是通配，和正则里面的 * 不是一个意思；
    
    none 指的是referer不存在的情况（curl -e 测试）；
    
    blocked 指的是referer头部的值被防火墙或代理服务器删除或者伪装的情况，
            该情况下，referer头部的值不以http:// 或 https://开头（curl -e 后面跟的referer不以http:// 或 https://开头）。
            
    curl -e 指定来源网址

修改配置：

# vim /usr/local/nginx/conf/vhost/www.1.com.conf
    
    server { 
        listen 80;
        server_name www.1.com;
        index index.html;
        root /data/wwwroot/www.1.com;
    
        rewrite_log on;
        location ~* ^.+.(jpg|jpeg|gif|css|png|js|rar|zip|flv)$
        { 
            valid_referers none blocked server_names *.1.com 1.com *.2.com 2.com;
            if ($invalid_referer)
            { 
                return 403;
            }
        }
    }

重载配置：

# /usr/local/nginx/sbin/nginx -t
    
    # /usr/local/nginx/sbin/nginx -s reload

访问测试：

# curl -e "http://www.2.com/1.html" -x127.0.0.1:80 www.1.com/abc/1.jpg -I
    
    HTTP/1.1 404 Not Found
    Server: nginx
    Date: Wed, 24 Apr 2019 13:50:42 GMT
    Content-Type: text/html
    Content-Length: 162
    Connection: keep-alive
    
    提示404 Not Found说明没有问题
    
    # curl -e "http://www.3.com/1.html" -x127.0.0.1:80 www.1.com/abc/1.jpg -I
    
    HTTP/1.1 403 Forbidden
    Server: nginx
    Date: Wed, 24 Apr 2019 13:50:47 GMT
    Content-Type: text/html
    Content-Length: 162
    Connection: keep-alive
    
    从www.3.com过来的请求直接返回403，因为http://www.3.com不是白名单中的referer

#### 伪静态 ####

*  示例7（比如discuz伪静态）：

location /  { 
        rewrite ^([^\.]*)/topic-(.+)\.html$ $1/portal.php?mod=topic&topic=$2 last;
        rewrite ^([^\.]*)/forum-(\w+)-([0-9]+)\.html$ $1/forum.php?mod=forumdisplay&fid=$2&page=$3 last;
        rewrite ^([^\.]*)/thread-([0-9]+)-([0-9]+)-([0-9]+)\.html$ $1/forum.php?mod=viewthread&tid=$2&extra=page%3D$4&page=$3 last;
        rewrite ^([^\.]*)/group-([0-9]+)-([0-9]+)\.html$ $1/forum.php?mod=group&fid=$2&page=$3 last;
        rewrite ^([^\.]*)/space-(username|uid)-(.+)\.html$ $1/home.php?mod=space&$2=$3 last;
        rewrite ^([^\.]*)/(fid|tid)-([0-9]+)\.html$ $1/index.php?action=$2&value=$3 last;
    }

#### rewrite多个条件的并且 ####

*  示例8：

location / { 
        set $rule 0;
        if ($document_uri !~ '^/abc')
        { 
            set $rule "${rule}1";
        }
        if ($http_user_agent ~* 'ie6|firefox')
        { 
           set $rule "${rule}2";
        }
        if ($rule = "012")
        { 
            rewrite /(.*) /abc/$1 redirect;
        }
    }

修改配置：

# vim /usr/local/nginx/conf/vhost/www.1.com.conf
    
    server { 
        listen 80;
        server_name www.1.com;
        index index.html;
        root /data/wwwroot/www.1.com;
    
        rewrite_log on;
        if ($request_uri ~ "^/abc/")
        { 
            if ($http_user_agent ~ 'IE|chrome')
            { 
                return 406;                 #任意定义一个状态码
            }
        }
    }

重载配置：

# /usr/local/nginx/sbin/nginx -t
    
    nginx: [emerg] "if" directive is not allowed here in /usr/local/nginx/conf/vhost/www.1.com.conf:11
    nginx: configuration file /usr/local/nginx/conf/nginx.conf test failed

可以看到，这样写会报错，因为**nginx不支持在if中嵌套if**，要想达到多个条件的并且，可以这样做：

修改配置：

# vim /usr/local/nginx/conf/vhost/www.1.com.conf
    
    server { 
        listen 80;
        server_name www.1.com;
        index index.html;
        root /data/wwwroot/www.1.com;
    
        rewrite_log on;
    
        set $rule 0;
        if ($request_uri ~ "^/abc/")
        { 
            set $rule "${rule}1";
        }
        if ($http_user_agent ~ 'IE|chrome')
        { 
            set $rule "${rule}2";
        }
        if ($rule = "012")
        { 
            return 406;
        }   
    }

重载配置：

# /usr/local/nginx/sbin/nginx -t
    
    # /usr/local/nginx/sbin/nginx -s reload

访问测试：

# curl -x127.0.0.1:80 -A "kdjshd" www.1.com/abc/1.html -I
    
    HTTP/1.1 404 Not Found                  #返回404
    Server: nginx
    Date: Wed, 24 Apr 2019 14:00:47 GMT
    Content-Type: text/html
    Content-Length: 162
    Connection: keep-alive

# curl -x127.0.0.1:80 -A "kdjshdchrome" www.1.com/abcd/1.html -I
    
    HTTP/1.1 404 Not Found                  #返回404
    Server: nginx
    Date: Wed, 24 Apr 2019 14:04:31 GMT
    Content-Type: text/html
    Content-Length: 162
    Connection: keep-alive

# curl -x127.0.0.1:80 -A "kdjshdchrome" www.1.com/abc/1.html -I
    
    HTTP/1.1 406 Not Acceptable             #返回406
    Server: nginx
    Date: Wed, 24 Apr 2019 14:07:22 GMT
    Content-Type: text/html
    Content-Length: 172
    Connection: keep-alive

可以看到，必须同时满足定义的条件，才会返回406。

#### location配置 ####

*  语法规则：

nginx location语法规则：`location [=|~|~*|^~] /uri/ { … }`，nginx的location匹配的变量是$uri 。

<table> 
 <thead> 
  <tr> 
   <th>符号</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>=</td> 
   <td>表示精确匹配</td> 
  </tr> 
  <tr> 
   <td>^~</td> 
   <td>表示uri以指定字符或字符串开头</td> 
  </tr> 
  <tr> 
   <td>~</td> 
   <td>表示区分大小写的正则匹配</td> 
  </tr> 
  <tr> 
   <td>~*</td> 
   <td>表示不区分大小写的正则匹配</td> 
  </tr> 
  <tr> 
   <td>/</td> 
   <td>通用匹配，任何请求都会匹配到</td> 
  </tr> 
 </tbody> 
</table>

*  规则优先级：

=  高于  ^~  高于  ~* 等于 ~  高于  /

*  规则示例：

location = "/12.jpg" { ... }
    如：
    www.1.com/12.jpg 匹配
    www.1.com/abc/12.jpg 不匹配
    
    location ^~ "/abc/" { ... }
    如：
    www.1.com/abc/123.html 匹配
    www.1.com/a/abc/123.jpg 不匹配
    
    location ~ "png" { ... }
    如：
    www.1.com/aaa/bbb/ccc/123.png 匹配
    www.1.com/aaa/png/123.html 匹配
    
    location ~* "png" { ... }
    如：
    www.1.com/aaa/bbb/ccc/123.PNG 匹配
    www.1.com/aaa/png/123.html 匹配
    
    
    location /admin/ { ... }
    如：
    www.1.com/admin/aaa/1.php 匹配
    www.1.com/123/admin/1.php 不匹配

注意：

有些资料上介绍location支持不匹配 !~，
    如： location !~ 'png'{ ... }
    这是错误的，location不支持 !~
    
    如果有这样的需求，可以通过if来实现，
    如： if ($uri !~ 'png') { ... }
    
    location优先级小于if

--------------------