如何设置nginx重定向

nginx 是一个灵活且高效的网络服务器,如果想要在nginx服务器中重定,你可以从下面挑选一个适合的方式。

简单且快速的 return

这是一个非常简单的设置方式,只需要个return语句就可以了

1
return 301 https://example.com$request_uri;

你需要把这段代码放到nginx配置文件的server代码块中,301是永久重定向,你也可以设置成302做一个临时重定向(不建议)。

一个完整的例子:

1
2
3
4
5
6
server {
listen 80;
listen [::]:80;
hostname example.com www.example.com;
return 301 https://example.com$request_uri;
}

正则表达式 rewrite

如果return不能满足你的复杂业务需求,你可以考虑下正则匹配重定向:

1
rewrite ^/foo/(bar)/(.*)$ https://$server_name/$1/$2 permanent;

同样这也是需要在server代码块中,其中permanent301永久跳转,若需要302可修改为redirect

一个完整的例子:

1
2
3
4
5
6
7
server {
listen 80;
listen [::]:80;
hostname example.com www.example.com;
root /var/www/example.com/public;
rewrite ^/foo/(bar)/(.*)$ $scheme://$server_name/$1/$2 permanent;
}

又如:

1
2
3
4
5
6
7
server {
listen 80;
server_name www.fangyongle.com fangyongle.cn;
if ($host != 'www.fangyongle.com' ) {
rewrite ^/(.*)$ https://www.fangyongle.com/$1 permanent;
}
}

再如:

1
2
3
4
5
6
7
# 根据文件类型设置过期时间
location ~* \.(js|css|jpg|jpeg|gif|png|swf)$ {
if (-f $request_filename) {
expires 1h;
break;
}
}

使用Maps

如果你有一堆需要重定向的连接映射,你可以考虑在一个地方定义它,然后再通过if来手动判断重定向。

首先定义重定向链接映射redirect-map.conf

1
2
3
4
5
map $request_uri $redirect_uri {
/about.html /about-us;
/customers.html /our-customers;
/products.html /our-products;
}

然后在server代码块使用:

1
2
3
4
5
6
7
include redirect-map.conf;
server {
[…]
if ( $redirect_uri ) {
return 301 $redirect_uri;
}
}

映射也可以有一些语法:

1
2
3
4
5
6
7
8
9
10
11
12
map $request_uri $redirect_uri {
/about.html /about-us;
/customers.html /our-customers;
/products.html /our-products;
# Match any url that ends in products.html or producs.htm
~products\.html?$ /our-products;
# case-insensitive version of the above
~*products\.html?$ /our-products;
# A named capture that maps
# e.g. product-1234.html into /products/item-1234/overview
~product-(?<sku>\d+)\.html /products/item-$sku/overview;
}

一些实用的重定向例子

http 重定向为 https

1
return 301 https://$host$request_uri;

统一规范域名

1
2
3
4
server_name example.com www.example.com example.net www.example.net _;
if ( $host != $server_name ) {
return 301 $scheme://$server_name$request_uri;
}

含 www 和 不含 www 之间的重定向

1
2
3
4
# non-www to www
if ( $host !~ ^www\. ) {
return 301 $scheme://www.$host$request_uri;
}
1
2
3
4
# www to non-www
if ( $host ~ ^www\.(?<domain>.+)$ ) {
return 301 $scheme://$domain$request_uri;
}

附录

重定向中常用全局变量

1
2
3
4
5
$scheme		       // HTTP方法(如http,https),如:http
$host // 请求主机头字段,否则为服务器名称,如:blog.fangyongle.com
$server_name // 服务器名称,如:blog.fangyongle.com
$request_uri // 包含请求参数的原始URI,不包含主机名,如:/2018/81.html?a=1&b=2
$request_filename // 当前请求的文件的路径名,由root或alias和URI request组合而成,如:/2013/81.html

nginx 部分常用全局变量

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
$remote_addr		//获取客户端ip
$binary_remote_addr //客户端ip(二进制)
$remote_port //客户端port,如:50472
$remote_user //已经经过Auth Basic Module验证的用户名
$host //请求主机头字段,否则为服务器名称,如:blog.fangyongle.com
$request //用户请求信息,如:GET ?a=1&b=2 HTTP/1.1
$request_filename //当前请求的文件的路径名,由root或alias和URI request组合而成,如:/2013/81.html
$status //请求的响应状态码,如:200
$body_bytes_sent // 响应时送出的body字节数数量。即使连接中断,这个数据也是精确的,如:40
$content_length // 等于请求行的“Content_Length”的值
$content_type // 等于请求行的“Content_Type”的值
$http_referer // 引用地址
$http_user_agent // 客户端agent信息,如:Mozilla/5.0 (Windows NT 5.1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/29.0.1547.76 Safari/537.36
$args //与$query_string相同 等于当中URL的参数(GET),如a=1&b=2
$document_uri //与$uri相同 这个变量指当前的请求URI,不包括任何参数(见$args) 如:/2018/81.html
$document_root //针对当前请求的根路径设置值
$hostname //如:centos53.localdomain
$http_cookie //客户端cookie信息
$cookie_COOKIE //cookie COOKIE变量的值
$is_args //如果有$args参数,这个变量等于”?”,否则等于”",空值,如?
$limit_rate //这个变量可以限制连接速率,0表示不限速
$query_string // 与$args相同 等于当中URL的参数(GET),如a=1&b=2
$request_body // 记录POST过来的数据信息
$request_body_file //客户端请求主体信息的临时文件名
$request_method //客户端请求的动作,通常为GET或POST,如:GET
$request_uri //包含请求参数的原始URI,不包含主机名,如:/2018/81.html?a=1&b=2
$scheme //HTTP方法(如http,https),如:http
$uri //这个变量指当前的请求URI,不包括任何参数(见$args) 如:/2018/81.html
$request_completion //如果请求结束,设置为OK. 当请求未结束或如果该请求不是请求链串的最后一个时,为空(Empty),如:OK
$server_protocol //请求使用的协议,通常是HTTP/1.0或HTTP/1.1,如:HTTP/1.1
$server_addr //服务器IP地址,在完成一次系统调用后可以确定这个值
$server_name //服务器名称,如:blog.fangyongle.com
$server_port //请求到达服务器的端口号,如:80

Rewrite正则相关指令详解

nginx的rewrite相当于apache的rewriterule(大多数情况下可以把原有apache的rewrite规则加上引号就可以直接使用),它可以用在server,locationIF条件判断块中,命令格式如下:

1
rewrite <regex> <replacement> <flag>

正则表达式匹配

  • ~为区分大小写匹配
  • ~*为不区分大小写匹配
  • !~!~*分别为区分大小写不匹配及不区分大小写不匹配

文件及目录匹配判断

  • -f!-f用来判断是否存在文件
  • -d!-d用来判断是否存在目录
  • -e!-e用来判断是否存在文件或目录
  • -x!-x用来判断文件是否可执行

flag标记

  • last - 基本上都用这个Flag。
  • break - 中止rewirte,不在继续匹配
  • redirect - 返回临时重定向的HTTP状态302
  • permanent - 返回永久重定向的HTTP状态301

使用lastbreak实现URI重写,浏览器地址栏不变。而且两者有细微差别:

  • 使用alias指令必须用last标记
  • 使用proxy_pass指令时,需要使用break标记
  • last标记在本条rewrite规则执行完毕后,会对其所在server{......}标签重新发起请求,而break标记则在本条规则匹配完成后,终止匹配。
恰好你喜欢,恰好想喝咖啡