如何设置nginx重定向

原文： https://skyfi.github.io/2018/09/21/%E5%A6%82%E4%BD%95%E8%AE%BE%E7%BD%AEnginx%E9%87%8D%E5%AE%9A%E5%90%91/

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代码块中，其中permanent为301永久跳转，若需要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,location和IF条件判断块中，命令格式如下：

1	rewrite <regex> <replacement> <flag>

正则表达式匹配

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

文件及目录匹配判断

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

flag标记

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

使用last和break实现URI重写，浏览器地址栏不变。而且两者有细微差别：

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