Nginx rewrite重定向配置详解
rewrite 模块内置了类似脚本语言的 set、if、break、return 配置指令，通过这些指令，用户可以在 HTTP 请求处理过程中对 URI 进行更灵活的操作控制。rewrite 模块提供的指令可以分两类，一类是标准配置指令，这部分指令只是对指定的操作进行相应的操作控制；另一类是脚本指令，这部分指令可以在 HTTP 指令域内以类似脚本编程的形式进行编写。
1、标准配置指令
常用的标准配置指令如下面表格所示。| 名称 | rewrite 日志记录指令 |
|---|---|
| 指令 | rewrite_log |
| 作用域 | http, server, location |
| 默认值 | off |
| 指令值选项 | on 或 off |
| 指令说明 | 当指令值为 on 时，rewrite 的执行结果会以 notice 级别记录到 Nginx 的 error 日志文件中 |
配置样例如下：
http {
rewrite_log off;
}
| 名称 | 未初始化变量告警日志记录指令 |
|---|---|
| 指令 | uninitialized_variable_warn |
| 作用域 | http, server, location |
| 默认值 | on |
| 指令值选项 | on 或 off |
| 指令说明 | 指令值为 on 时，会将未初始化的变量告警记录到日志中 |
配置样例如下：
http {
uninitialized_variable_warn off;
}
| 名称 | rewrite 指令 |
|---|---|
| 指令 | rewrite |
| 作用域 | server, location |
| 默认值 | on |
| 指令值选项 | on 或 off |
| 指令说明 | 对用户的 URI 用正则表达式的方式进行重写，并跳转到新的 URI |
配置样例如下：
http {
rewrite ^/users/(.*)$ /show?user=$1 last;
}
rewrite regex replacement [flag];
1) regex 是 PCRE 语法格式的正则表达式。2) replacement 是重写 URI 的改写规则。当改写规则以“http://”“https://”或“$scheme”开头时，Nginx 重写该语句后将停止执行后续任务，并将改写后的 URI 跳转返回客户端。
3) flag 是执行该条重写指令后的操作控制符。操作控制符有如下 4 种：
- last：执行完当前重写规则跳转到新的 URI 后继续执行后续操作；
- break：执行完当前重写规则跳转到新的 URI 后不再执行后续操作。不影响用户浏览器 URI 显示；
- redirect：返回响应状态码 302 的临时重定向，返回内容是重定向 URI 的内容，但浏览器网址仍为请求时的 URI；
- permanent：返回响应状态码 301 的永久重定向，返回内容是重定向 URI 的内容，浏览器网址变为重定向的 URI。
2、脚本指令
常见的脚本指令如下面表格所示。| 名称 | 设置变量指令 |
|---|---|
| 指令 | set |
| 作用域 | server, location, if |
| 指令说明 | set 指令，可以用来定义变量 |
配置样例如下：
http {
server{
set $test "check";
}
}
http{
server {
listen 8080;
location /foo {
set $a hello;
rewrite ^ /bar;
}
location /bar {
# 如果这个请求来自“/foo”,$a的值是“hello”。如果直接访问“/bar”，$a的值为空
echo “a = [$a]”;
}
}
}
http{
server {
listen 8080;
location /foo {
set $a hello;
rewrite ^ /bar;
}
location /bar {
# 如果这个请求来自“/foo”,$a的值是“hello”。如果直接访问“/bar”，$a的值为空
if ( $a = “hello” ){
rewrite ^ /newbar;
}
}
}
}
http {
server{
set $test;
}
}
http {
server{
set $test "check ";
if ( "${test}nginx" = "nginx" ){ #${test}nginx的值为"check nginx"
}
}
}
| 名称 | 条件判断指令 |
|---|---|
| 指令 | if |
| 作用域 | server, location |
| 指令说明 | 条件判断指令 |
配置样例如下：
http {
server {
if ($http_cookie ~* "id=([^;]+)(?:;|$)") {
set $id $1;
}
}
}
2) 变量内容字符串比较操作运算符为“=”或“!=”。
3) 进行正则表达式比较时，有以下 4 个操作运算符：
- “~”：区分大小写匹配；
- “~*”：不区分大小写匹配；
- “!~”：区分大小写不匹配；
- “!~*”：不区分大小写不匹配。
4) 进行文件或目录比较时，有以下 4 个操作运算符：
- “-f”：判断文件是否存在，可在运算符前加“!”表示反向判断。
- “-d”：判断目录是否存在，可在运算符前加“!”表示反向判断。
- “-e”：判断文件、目录或链接符号是否存在，可在运算符前加“!”表示反向判断。
- “-x”：判断文件是否为可执行文件，可在运算符前加“!”表示反向判断。
| 名称 | 终止指令 |
|---|---|
| 指令 | break |
| 作用域 | server, location, if |
| 指令说明 | 终止后续指令的执行 |
配置样例如下：
http {
server {
if ($slow) {
limit_rate 10k;
break;
}
}
}
| 名称 | 跳转指令 |
|---|---|
| 指令 | return |
| 作用域 | server, location, if |
| 指令说明 | 向客户端返回响应状态码或执行跳转 |
配置样例如下：
http {
server {
if ($request_method = POST) {
return 405;
}
}
}
- return code：向客户端返回指定 code 的状态码，当返回非标准的状态码 444 时，Nginx 直接关闭连接，不发送响应头信息。
- return code text：向客户端发送带有指定 code 状态码和 text 内容的响应信息。因要在客户端显示 text 内容，所以 code 不能是 30×。
- return code URL：这里的 URL 可以是内部跳转或变量 $uri，也可以是有完整 scheme 标识的 URL，将直接返回给客户端执行跳转，code 只能是 30×。
- return URL：此时默认 code 为 302，URL 必须是有完整 scheme 标识的 URL。
2) return 也可以用来调试输出 Nginx 的变量。
声明：《Nginx系列教程》为本站“54笨鸟”官方原创，由国家机构和地方版权局所签发的权威证书所保护。
