Nginx URL重写（rewrite）配置及信息详解

Posted 2023-05-03

参考技术A URL重写有利于网站首选域的确定，对于同一资源页面多条路径的301重定向有助于URL权重的集中

nginx URL重写（rewrite）介绍
和apache等web服务软件一样，rewrite的组要功能是实现RUL地址的重定向。Nginx的rewrite功能需要PCRE软件的支持，即通过perl兼容正则表达式语句进行规则匹配的。默认参数编译nginx就会支持rewrite的模块，但是也必须要PCRE的支持

rewrite语法格式及参数语法说明如下:
rewrite <regex> <replacement> [flag];

flag标记说明：

last #本条规则匹配完成后，继续向下匹配新的location URI规则

break #本条规则匹配完成即终止，不再匹配后面的任何规则

redirect #返回302临时重定向，浏览器地址会显示跳转后的URL地址

permanent #返回301永久重定向，浏览器地址栏会显示跳转后的URL地址

rewrite参数的标签段位置：
server,location,if

例子：

说明：

rewrite为固定关键字，表示开始进行rewrite匹配规则

regex部分是 ^/(.*) ，这是一个正则表达式，匹配完整的域名和后面的路径地址

replacement部分是 http://www.czlun.com/ 1，是取自regex部分()里的内容。匹配成功后跳转到的URL。

flag部分 permanent表示永久301重定向标记，即跳转到新的 http://www.czlun.com/$1 地址上

regex 常用正则表达式说明

Nginx的rewrite功能在企业里应用非常广泛：

u 可以调整用户浏览的URL，看起来更规范，合乎开发及产品人员的需求。

u 为了让搜索引擎搜录网站内容及用户体验更好，企业会将动态URL地址伪装成静态地址提供服务。

u 网址换新域名后，让旧的访问跳转到新的域名上。例如，访问京东的360buy.com会跳转到jd.com

u 根据特殊变量、目录、客户端的信息进行URL调整等

Nginx配置rewrite过程介绍
（1）创建rewrite语句
vi conf/vhost/ www.abc.com.conf

文件内容

server



server



或者

server



（2）重启服务
确认无误便可重启，操作如下：

nginx -t

nginx -s reload

（3）查看跳转效果
打开浏览器访问abc.com

页面打开后，URL地址栏的 abc.com 变成了 www.abc.com 说明URL重写成功。

[转] Nginx URL重写（rewrite）配置及信息详解

1）if判断指令

语法为if(condition){…}     #对给定的条件condition进行判断。
如果为真，大括号内的rewrite指令将被执行，if条件(conditon)可以是如下任何内容：

  a:当表达式只是一个变量时，如果值为空或任何以0开头的字符串都会当做false，其他情况为true。
  b: 直接比较变量和内容时，使用 = 或!=
  c: 正则表达式匹配，*不区分大小写的匹配，!和！*反之。

注意：使用正则表达式字符串一般不需要加引号，但是如果含有右花括号“}”或者分号“；”字符时，必须要给整个正则表达式加引号

其他指令：
-f和!-f用来判断请求文件是否存在
-d和!-d用来判断请求目录是否存在
-e和!-e用来判断是请求的文件或者目录否存在
-x和!-x用来判断请求的文件是否可执行

例子：if (-f $request_filename){
        … #判断请求的文件是否存在，存在就执行这里面的代码块
    }

2）break指令

用于中断当前相同作用域中的Nginx配置，和Java中的break语法类似，可以在server块和location以及if块中使用。
语法：break;

3）if 可用的全局变量
还有$host_host变量，和$host区别如下：
$host不带端口，$http_host带端口

4）return指令

 该指令用于完成对请求的处理，直接向客户端响应状态的代码。和Java中的return语法类似。可以再server块和location以及if块中使用。

 语法：return code URL;  #code表示状态码，URL表示返回给客户单的URL地址
 或者：return URL: #当状态码是302或者307的时候，可以使用，返回的URL必须包含“http://”、“https://”或者直接使用“$scheme”变量(RequestScheme代表传输协议，
Nginx内置变量)
  或者 return [text]; #为返回给客户端的响应体内容，支持变量的使用

5）rewrite指令

 该指令通过正则表达式的使用来改变URI.可以同时存在一个或者多个指令，按照顺序一次对URL进行匹配和处理。该指令可以在server块后者location块中配置

  语法： 　指令语法：rewrite regex replacement [flag];
　  rewrite是实现URL重定向的重要指令， 　
   regex：用来匹配URI的正则表达式；
　  replacement：匹配成功后用来替换URI中被截取内容的字符串，默认情况如果该字符串包含“http://”、"https://"开头，则不会继续向下对URI进行其他处理。直接返回重写的URI给客户端
    flag：用来设置rewrite对URI的处理行为,包含如下数据：

标记符号 说明
last 终止在本location块中处理接收到的URI，并将此处重写的URI作为新的URI使用其他location进行处理。（只是终止当前location的处理）
break 将此处重写的URI作为一个新的URI在当前location中继续执行，并不会将新的URI转向其他location。
redirect 将重写后的URI返回个客户端，状态码是302，表明临时重定向，主要用在replacement字符串不以“http://”，“ https://”或“ $scheme” 开头；
permanent 将重写的URI返回客户端，状态码为301,指明是永久重定向；
6）rewrite_log指令

该指令用于是否开启URL重写日志的输出，
语法：
  rewrite_log on | off
  默认是off，如果配置为on，URL重写的相关日志将以notice级别输出到error_log指令配置的日志文件中

7）set指令

用来设置新的变量，
  语法: set variable value;
    variable,这个是变量的名称，这个符号的“$”必须作为变量第一个字符，并且不能和Nginx服务器预设的全局变量同名
    value,为变量的值。
比如 set $id “3”; #设置id为3

8）uninitialized_variable_warn指令

这个指令用来配置会用未初始化的变量时，是否记录警告日志，
 语法： unitialized_variable_warn on | off
  默认设置时on状态

9）防盗链的例子

语法：valid_referers none | blocked | server_name | string ...;
1
这里表示请求头部Referer域是否匹配上面值，如果匹配了$invalid_referer 的值为0，没有相匹配就是1；

字符 说明
none 表示Referer头域不存在的情况
blocked 检测Referer头域的值被防火墙或者代理服务器删除或者伪装的情况，这种情况，该头域的值不以“http://”或者“https://”开头
server_name 设置一个或者多个URL，检测Referer头域的值是否是这些URL中的某个
10）例子

例子一（域名跳转）:
server {
listen 80;
server_name abc.com;
rewrite ^/(.*) http://www.ab c.com/$1 permanent; # 跳转到www.abc.com网址上
}
例子二：
server {
listen 80;
server_name www.myweb.com www.web.info
if($host ~ myweb.info){ #"."需要使用“”转义，这里是匹配到www.web.info时
rewrite ^(.*) http://www.myweb.com/&1 permant; #永久重定向到http://www.myweb.com网址上&1是匹配的uri
}
}
例子三(防盗链)：
location ~* .(gif|jpg|png|swf|flv)$ {
valid_referers none blocked www.vison.com www.wsvison.com; #这里表示Referer头域中的值是none或者blocked或者后面这些网址才会返回去正常的gif|jpg|png|swf|flv文件，否则执行下面if块代码
if ($invalid_referer) { #上面没有匹配成功，$invalid_referer值为1，否则为0
return 404;
} //防盗链
}
其他例子：
if ($http_user_agent ~ MSIE) {
rewrite ^(.*)$ /msie/$1 break;
} //如果UA包含"MSIE"，rewrite请求到/msid/目录下

if ($http_cookie ~* "id=([^;]+)(?:;|$)") {
set $id $1;
} //如果cookie匹配正则，设置变量$id等于正则引用部分

if ($request_method = POST) {
return 405;
} //如果提交方法为POST，则返回状态405（Method not allowed）。return不能返回301,302

if ($slow) {
limit_rate 10k;
} //限速，$slow可以通过 set 指令设置

if (!-f $request_filename){
break;
proxy_pass http://127.0.0.1;
} //如果请求的文件名不存在，则反向代理到localhost 。这里的break也是停止rewrite检查

if ($args ~ post=140){
rewrite ^ http://example.com/ permanent;
} //如果query string中包含"post=140"，永久重定向到example.com

参考：https://segmentfault.com/a/1190000002797606#articleHeader0