Understand Nginx Redirect

nginx的转发模块ngx_http_rewrite_module包含以下指令:

break
if
return
rewrite
rewrite_log
set
uninitialized_variable_warn

break

break指令用来停止当前的ngx_http_rewrite_module指令集合(current set of ngx_http_rewrite_module directives)。

比如：

if ($slow) {
    limit_rate 10k;
    break;
}

if

条件判断，如果满足条件，括号内的指令将被执行。条件可以为：

变量名：true or false
比较运算： = or !=
正则表达式： ~(区分大小写匹配case-sensitive matching)or ~*(不区分大小写匹配case-insensitive matching)
-f: 判断文件是否存在
-d：判断文件，文件夹，符号连接是否存在
-x: 检查文件是否可执行

例如：

if ($http_user_agent ~ MSIE) {
    rewrite ^(.*)$ /msie/$1 break;
}

if ($http_cookie ~* "id=([^;]+)(?:;|$)") {
    set $id $1;
}

if ($request_method = POST) {
    return 405;
}

if ($slow) {
    limit_rate 10k;
}

if ($invalid_referer) {
    return 403;
}

return

停止处理并发挥特殊的http code 给客户端。

return (301 | 302 | 303 | 307) url;

return (1xx | 2xx | 4xx | 5xx) ["text"];

rewrite

rewrite regex URL [flag];

如果请求的URI满足regex，则URI被替换。如果替换的URI是http或https开头，则停止以后处理并返回给客户端。

flag的可选值为：

last:停止当前的ngx_http_rewrite_module指令并以替换的URI来查找新的location。
break:停止当前的ngx_http_rewrite_module指令****集合****。
redirect:返回302.
permanent:返回永久的转发:301 code.

注意：last指令会重新查找新的location,而break会跳出当前的location or if direct。
因此，当使用于location内部中时，last会跳出后重新匹配。

location /download/ {
    rewrite ^(/download/.*)/media/(.*)\..*$ $1/mp3/$2.mp3 break;
    rewrite ^(/download/.*)/audio/(.*)\..*$ $1/mp3/$2.ra  break;
    return  403;
}

假如你访问URL:/download/a/media/a.mp3。
上面将匹配：/download/a/mp3/a.mp3。

如果，将break更换为last:

location /download/ {
    rewrite ^(/download/.*)/media/(.*)\..*$ $1/mp3/$2.mp3 last;
    rewrite ^(/download/.*)/audio/(.*)\..*$ $1/mp3/$2.ra  last;
    return  403;
}

那么过程就变成了：

/download/a/media/a.mp3-->/download/a/mp3/a.mp3-->
/download/a/mp3/a.mp3-->403

set

设置变量。eg:

 set $is_mobile "pc";
 if ( $http_user_agent ~* "(Android|iPhone|iPod|Symbian|IEMobile|BlackBerry)"){
       set $is_mobile "mobile";
 }

应用

例子来自于:nginx blog:

server {
    listen 80;
    server_name www.old-name.com old-name.com;
    return 301 $scheme://www.new-name.com$request_uri;
    #return 301 $scheme://www.new-name.conm;
    #rewrite ^ $scheme://www.new-name.com$request_uri permanent;
    #rewrite ^/(.*)$ $scheme://www.new-name.com/$1 permanent;

}

add or remove www

# add 'www'
server {
    listen 80;
    listen 443 ssl;
    server_name domain.com;
    return 301 $scheme://www.domain.com$request_uri;
    #rewrite ^(.*)$ $scheme://www.domain.com$1 permanent;
}

# remove 'www'
server {
    listen 80;
    listen 443 ssl;
    server_name www.domain.com;
    return 301 $scheme://domain.com$request_uri;
}

默认转发：

server {
    listen 80 default_server;
    listen 443 ssl default_server;
    server_name _;
    return 301 $scheme://www.domain.com;
}

强制HTTPS：

server {
    listen 80;
    server_name www.domain.com;
    return 301 https://www.domain.com$request_uri;
}

或者:

# NOT RECOMMENDED
if ($scheme != "https") {
    rewrite ^ https://www.mydomain.com$uri permanent;
}

这种，需要额外处理，不推荐使用。

location / {
    try_files $uri $uri/ /index.php?$args;
}

移除不支持文件：

location ~ \.(aspx|php|jsp|cgi)$ {
    return 410;
    #deny all;
}

自定义路由：

rewrite ^/listings/(.*)$ /listing.html?listing=$1 last;

微信公众账号：myersguo

参考资料

https://www.nginx.com/blog/creating-nginx-rewrite-rules/
http://nginx.org/en/docs/http/ngx_http_rewrite_module.html