实例讲解Nginx下的rewrite规则

共计 6301 个字符，预计需要花费 16 分钟才能阅读完成。

一．正则表达式匹配，其中：
* ~ 为区分大小写匹配
* ~* 为不区分大小写匹配
* !~ 和!~* 分别为区分大小写不匹配及不区分大小写不匹配
二．文件及目录匹配，其中：
* - f 和!- f 用来判断是否存在文件
* - d 和!- d 用来判断是否存在目录
* - e 和!- e 用来判断是否存在文件或目录
* - x 和!- x 用来判断文件是否可执行
三．rewrite 指令的最后一项参数为 flag 标记，flag 标记有：
1.last    相当于 apache 里面的 [L] 标记，表示 rewrite。
2.break 本条规则匹配完成后，终止匹配，不再匹配后面的规则。
3.redirect  返回 302 临时重定向，浏览器地址会显示跳转后的 URL 地址。
4.permanent  返回 301 永久重定向，浏览器地址会显示跳转后的 URL 地址。

使用 last 和 break 实现 URI 重写，浏览器地址栏不变。而且两者有细微差别，使用 alias 指令必须用 last 标记; 使用 proxy_pass 指令时，需要使用 break 标记。Last 标记在本条 rewrite 规则执行完毕后，会对其所在 server{……}标签重新发起请求，而 break 标记则在本条规则匹配完成后，终止匹配。
例如：如果我们将类似 URL/photo/123456 重定向到 /path/to/photo/12/1234/123456.png
rewrite “/photo/([0-9]{2})([0-9]{2})([0-9]{2})”/path/to/photo/$1/$1$2/$1$2$3.png ;

四．NginxRewrite 规则相关指令

1.break 指令
使用环境：server,location,if;
该指令的作用是完成当前的规则集，不再处理 rewrite 指令。

2.if 指令
使用环境：server,location
该指令用于检查一个条件是否符合，如果条件符合，则执行大括号内的语句。If 指令不支持嵌套，不支持多个条件 && 和 || 处理。

3.return 指令
语法：returncode ;
使用环境：server,location,if;
该指令用于结束规则的执行并返回状态码给客户端。
示例：如果访问的 URL 以 ”.sh” 或 ”.bash” 结尾，则返回 403 状态码
location ~ .*\.(sh|bash)?$
{
return 403;
}

4.rewrite 指令
语法：rewriteregex replacement flag
使用环境：server,location,if
该指令根据表达式来重定向 URI，或者修改字符串。指令根据配置文件中的顺序来执行。注意重写表达式只对相对路径有效。如果你想配对主机名，你应该使用 if 语句，示例如下：
if($host ~* www\.(.*) )
{
set $host_without_www $1;
rewrite ^(.*)$  http://$host_without_www$1permanent;
}

5.Set 指令
语法：setvariable value ; 默认值:none; 使用环境：server,location,if;
该指令用于定义一个变量，并给变量赋值。变量的值可以为文本、变量以及文本变量的联合。
示例：set$varname “hello world”;

6.Uninitialized_variable_warn 指令
语法：uninitialized_variable_warnon|off
使用环境：http,server,location,if
该指令用于开启和关闭未初始化变量的警告信息，默认值为开启。

五．Nginx 的 Rewrite 规则编写实例
1. 当访问的文件和目录不存在时，重定向到某个 php 文件
if(!-e $request_filename)
{
rewrite ^/(.*)$ index.php last;
}

2. 目录对换 /123456/xxxx  ====>  /xxxx?id=123456
rewrite ^/(\d+)/(.+)/  /$2?id=$1 last;

3. 如果客户端使用的是 IE 浏览器，则重定向到 /ie 目录下
if($http_user_agent  ~ MSIE)
{
rewrite ^(.*)$ /ie/$1 break;
}

4. 禁止访问多个目录
location ~ ^/(cron|templates)/
{
deny all;
break;
}

5. 禁止访问以 /data 开头的文件
location ~ ^/data
{
deny all;
}

6. 禁止访问以.sh,.flv,.mp3 为文件后缀名的文件
location ~ .*\.(sh|flv|mp3)$
{
return 403;
}

7. 设置某些类型文件的浏览器缓存时间
location ~ .*\.(gif|jpg|jpeg|png|bmp|swf)$
{
expires 30d;
}
location ~ .*\.(js|css)$
{
expires 1h;
}

8. 给 favicon.ico 和 robots.txt 设置过期时间;
这里为 favicon.ico 为 99 天,robots.txt 为 7 天并不记录 404 错误日志
location ~(favicon.ico) {
log_not_found off;
expires 99d;
break;
}
location ~(robots.txt) {
log_not_found off;
expires 7d;
break;
}

9. 设定某个文件的过期时间; 这里为 600 秒，并不记录访问日志
location ^~ /html/scripts/loadhead_1.js {
access_log  off;
root /opt/lampp/htdocs/web;
expires 600;
break;
}

10. 文件反盗链并设置过期时间
这里的 return412 为自定义的 http 状态码，默认为 403，方便找出正确的盗链的请求
“rewrite ^/ http://img.linuxidc.net/leech.gif;”显示一张防盗链图片
“access_log off;”不记录访问日志，减轻压力
“expires 3d”所有文件 3 天的浏览器缓存

location ~*^.+\.(jpg|jpeg|gif|png|swf|rar|zip|css|js)$ {
valid_referers none blocked *.linuxidc.com*.linuxidc.net localhost 208.97.167.194;
if ($invalid_referer) {
rewrite ^/ http://img.linuxidc.net/leech.gif;
return 412;
break;
}
access_log  off;
root /opt/lampp/htdocs/web;
expires 3d;
break;
}

11. 只允许固定 ip 访问网站，并加上密码

root /opt/htdocs/www;
allow  208.97.167.194;
allow  222.33.1.2;
allow  231.152.49.4;
deny  all;
auth_basic“C1G_ADMIN”;
auth_basic_user_file htpasswd;

12 将多级目录下的文件转成一个文件，增强 seo 效果
/job-123-456-789.html 指向 /job/123/456/789.html

rewrite^/job-([0-9]+)-([0-9]+)-([0-9]+)\.html$ /job/$1/$2/jobshow_$3.html last;

13. 文件和目录不存在的时候重定向：

if (!-e $request_filename) {
proxy_pass http://127.0.0.1;
}

14. 将根目录下某个文件夹指向 2 级目录
如 /shanghaijob/ 指向 /area/shanghai/
如果你将 last 改成 permanent，那么浏览器地址栏显是 /location/shanghai/
rewrite ^/([0-9a-z]+)job/(.*)$ /area/$1/$2last;
上面例子有个问题是访问 /shanghai 时将不会匹配
rewrite ^/([0-9a-z]+)job$ /area/$1/ last;
rewrite ^/([0-9a-z]+)job/(.*)$ /area/$1/$2last;
这样 /shanghai 也可以访问了，但页面中的相对链接无法使用，
如./list_1.html 真实地址是 /area/shanghia/list_1.html 会变成 /list_1.html, 导至无法访问。
那我加上自动跳转也是不行咯
(-d $request_filename) 它有个条件是必需为真实目录，而我的 rewrite 不是的，所以没有效果
if (-d $request_filename){
rewrite ^/(.*)([^/])$ http://$host/$1$2/permanent;
}
知道原因后就好办了，让我手动跳转吧
rewrite ^/([0-9a-z]+)job$ /$1job/permanent;
rewrite ^/([0-9a-z]+)job/(.*)$ /area/$1/$2last;

15. 域名跳转
server
{
listen      80;
server_name  jump.linuxidc.com;
index index.html index.htm index.php;
root  /opt/lampp/htdocs/www;
rewrite ^/ http://www.linuxidc.com/;
access_log  off;
}

16. 多域名转向
server_name  www.linuxidc.comwww.linuxidc.net;
index index.html index.htm index.php;
root  /opt/lampp/htdocs;
if ($host ~ “linuxidc\.net”) {
rewrite ^(.*) http://www.linuxidc.com$1permanent;
}

六．nginx 全局变量
arg_PARAMETER    #这个变量包含 GET 请求中，如果有变量 PARAMETER 时的值。
args                    #这个变量等于请求行中(GET 请求) 的参数，如：foo=123&bar=blahblah;
binary_remote_addr #二进制的客户地址。
body_bytes_sent    #响应时送出的 body 字节数数量。即使连接中断，这个数据也是精确的。
content_length    #请求头中的 Content-length 字段。
content_type      #请求头中的 Content-Type 字段。
cookie_COOKIE    #cookie COOKIE 变量的值
document_root    #当前请求在 root 指令中指定的值。
document_uri      #与 uri 相同。
host                #请求主机头字段，否则为服务器名称。
hostname          #Set to themachine’s hostname as returned by gethostname
http_HEADER
is_args              #如果有 args 参数，这个变量等于”?”，否则等于””，空值。
http_user_agent    #客户端 agent 信息
http_cookie          #客户端 cookie 信息
limit_rate            #这个变量可以限制连接速率。
query_string          #与 args 相同。
request_body_file  #客户端请求主体信息的临时文件名。
request_method    #客户端请求的动作，通常为 GET 或 POST。
remote_addr          #客户端的 IP 地址。
remote_port          #客户端的端口。
remote_user          #已经经过 Auth Basic Module 验证的用户名。
request_completion #如果请求结束，设置为 OK. 当请求未结束或如果该请求不是请求链串的最后一个时，为空(Empty)。
request_method    #GET 或 POST
request_filename  #当前请求的文件路径，由 root 或 alias 指令与 URI 请求生成。
request_uri          #包含请求参数的原始 URI，不包含主机名，如：”/foo/bar.php?arg=baz”。不能修改。
scheme                #HTTP 方法（如 http，https）。
server_protocol      #请求使用的协议，通常是 HTTP/1.0 或 HTTP/1.1。
server_addr          #服务器地址，在完成一次系统调用后可以确定这个值。
server_name        #服务器名称。
server_port          #请求到达服务器的端口号。

七．Apache 和 Nginx 规则的对应关系
Apache 的 RewriteCond 对应 Nginx 的 if
Apache 的 RewriteRule 对应 Nginx 的 rewrite
Apache 的[R] 对应 Nginx 的 redirect
Apache 的 [P] 对应 Nginx 的 last
Apache 的 [R,L] 对应 Nginx 的 redirect
Apache 的 [P,L] 对应 Nginx 的 last
Apache 的 [PT,L] 对应 Nginx 的 last

例如：允许指定的域名访问本站，其他的域名一律转向 www.linuxidc.net
  Apache:
RewriteCond %{HTTP_HOST} !^(.*?)\.aaa\.com$[NC]
RewriteCond %{HTTP_HOST} !^localhost$
RewriteCond %{HTTP_HOST}!^192\.168\.0\.(.*?)$
RewriteRule ^/(.*)$ http://www.linuxidc.net[R,L]

  Nginx:
if($host ~* ^(.*)\.aaa\.com$ )
{
set $allowHost‘1’;
}
if($host ~* ^localhost)
{
set $allowHost‘1’;
}
if($host ~* ^192\.168\.1\.(.*?)$ )
{
set $allowHost‘1’;
}
if($allowHost !~‘1’)
{
rewrite ^/(.*)$ http://www.linuxidc.netredirect ;
}

推荐阅读：

Nginx 实现反向代理和负载均衡的配置及优化 http://www.linuxidc.com/Linux/2013-11/92909.htm

Nginx 做负载均衡报:nginx: [emerg] could not build the types_hash http://www.linuxidc.com/Linux/2013-10/92063.htm

Nginx 负载均衡模块 ngx_http_upstream_module 详述 http://www.linuxidc.com/Linux/2013-10/91907.htm

Nginx+Firebug 让浏览器告诉你负载均衡将请求分到了哪台服务器 http://www.linuxidc.com/Linux/2013-10/91824.htm

Ubuntu 安装 Nginx php5-fpm MySQL(LNMP 环境搭建) http://www.linuxidc.com/Linux/2012-10/72458.htm

Nginx 的详细介绍：请点这里
Nginx 的下载地址：请点这里