Nginx快速入门：return、rewrite重定向、重写详解（六）_网站优化分享

0. 引言

我们在日常的生产过程中，常常有需要重定向转发的需求，比如企业更换了域名，但又要保证之前的域名能访问，这就需要做重定向的跳转。

我们在之前的章节中学习了Nginx的负载均衡、各类转发代理配置，今天继续来补充关于转发的的最后一个环节——重定向（或称跳转）

1. 重定向、重写详解

什么是重定向？

重定向是指将客户端的请求从一个URL自动重定向到另一个URL。这通常是通过服务器发送一个特定的HTTP状态码来完成的，告诉客户端（以及搜索引擎）资源已经移动到了新的位置。重定向可以是临时的（302 Found）或永久的（301 Moved Permanently）

一句话概括：重定向转发时浏览器上的地址是会变化的，客户是能感知到的

什么是重写？

重写是指在不改变URL的情况下，修改客户端请求的HTTP请求行（request line）或路径。这通常用于URL的标准化或修改，而不需要告诉客户端资源已经移动。重写通常在服务器配置文件中完成，例如在Nginx的rewrite指令中。

一句话概括：重写转发时浏览器上的地址是会不会变化的，客户是无感的

应用场景：

重定向用于告诉客户端资源已经移动到了新位置

重写用于在不改变客户端URL的情况下修改请求

1.1 return 详解

1.1.1 return 核心概念

介绍：

return指令用于立即结束当前处理块的执行，并返回一个状态码给客户端。这个状态码可以是204（No Content）、400（Bad Request）到500（Server Error）之间的任何值。
return通常用于访问控制、错误处理或配置特定的HTTP响应
该指令可以返回指定的响应码和重定向URL给客户端，也可以返回指定的响应码和文本给客户端

作用域：

server, location, if

语法：

return code [text];
return code URL;
return URL;

return的状态码为301、302、303、307、308时，则为重定向；

return的状态码为其他时，可以返回响应主体[text]。

1.1.2 return 案例

官方文档：https://nginx.org/en/docs/http/ngx_http_rewrite_module.html#return

1、返回指定状态码和文本

如果要返回文本，需要指定 default_type application/json;，不配置的话，跳转会默认以下载文件形式
```
location ~ /user {
    default_type application/json; 
    return 200 "跳转成功";
}
```
- 2、重定向到指定链接
  
  重定向分为临时重定向和永久重定向：
  
  永久重定向：
  301，308 表示永久重定向，重定向结果会缓存，下次请求直接从缓存获取；区别在于301会进行方法转变，比如一个POST提交的请求，会转换为GET请求转发，而308则会保持原本方法进行转发
  
  临时重定向：
  300，该请求有多种可能的响应，浏览器可以选择它们其中的一个。服务器没有任何标准可以遵循去代替用户来进行选择
  302，重定向请求转发时使用 GET 方法，不管原请求使用的是何种方法
  303，基本跟 302 一致，所以很少用 303，都是使用 302
  307，为了补充 302.重定向必须使用原请求的方法和包体访问
```
location /user/ {
        return 300 "http://www.baidu.com";
    }
```
  或者
```
location /user/ {
        return "http://www.baidu.com";
    }
```
  3、返回一个自定义页面，并将参数、uri打印出来
```
location /test {
     default_type text/html;
     set $name 跳转成功;
     return 200 $name
request_uri:$request_uri
document_uri:$document_uri
uri:$uri
query_string:$query_string
args:$args;
 }
```
  注意，要让nginx支持显示中文，需要在nginx.conf中配置：
```
http {
     ...
    charset utf-8;
}
```
  1.2 rewrite 详解
  
  1.2.1 rewrite 核心概念
  
  官方文档：https://nginx.org/en/docs/http/ngx_http_rewrite_module.html
  介绍：
  Nginx 的 rewrite 模块是一个功能丰富的组件，它使得用户能够通过正则表达式对请求的 URI 进行重写。rewrite 模块支持 PCRE（Perl Compatible Regular Expressions）正则表达式，这为用户提供了强大的匹配和重写能力。通过正则表达式，用户可以精确地控制哪些请求需要被重写以及重写后的 URI。同时，rewrite 模块还提供了一系列的标记（flag），如 last、break、redirect、permanent 等，以控制重写后的行为，例如是否继续执行后续的重写规则、是否返回重定向响应等。这个功能通常用于以下几种场景：
  - URL 规范化：使 URL 看起来更规范、合理，便于用户记忆和搜索引擎优化。
  - 动态 URL 地址伪装：企业常常将动态 URL 地址伪装成静态地址提供服务，以提高系统的负载能力和用户体验。
  - 域名更换：当网站更换域名时，可以通过 rewrite 指令将旧域名的访问跳转到新域名上，确保用户的访问不会受到影响。
  - 业务调整：在服务端进行某些业务调整时，可能需要通过重写 URL 来实现特定的访问控制或数据分发。
  作用域：
  
  server, location, if
  
  语法：
  
  rewrite regex replacement [flag];
  
  可选的flag参数：
  - last
    
    标记表示在执行了当前的重写规则后，继续执行后续的 rewrite 规则或 location 匹配。
    它通常用在 server 块或 if 块中，以确保重写规则可以与其他规则组合使用，形成一个规则链。
    - break
      
      标记表示在执行了当前的重写规则后，停止执行后续的所有 rewrite 规则。
      它通常用在 location 块中，用于确保一旦某个重写规则匹配并执行后，不会继续执行其他可能存在的重写规则。
      - redirect：
        
        标记表示重写规则执行后，返回一个重定向响应（HTTP 302 状态码）给客户端，而不是继续处理请求。
        它用于实现临时性的重定向，比如在网站维护时将用户重定向到另一个地址。
        
        permanent
        
        标记表示重写规则执行后，返回一个永久重定向响应（HTTP 301 状态码）给客户端，并且后续的请求应该直接跳转到新的 URI，而不是再次执行重写规则。
        它用于实现永久性的重定向，比如在域名更改后，将旧域名重定向到新域名。
        
        301和302的应用场景：
        302 需要经常变化跳转路径的uri则使用302
        301 基本不变的调整uri（http跳转https、seo）
        
        1.2.2 rewrite 案例
        
        1、替换旧域名xxx.com为新域名yyy.com
        
        server { listen 80; server_name www.xxx.com; #域名修改 charset utf-8; location / { #添加域名重定向 if ($host = 'www.xxx.com'){ #$host为rewrite全局变量，代表请求主机头字段或主机名 rewrite ^/(.*)$ http://www.yyy.com/ permanent; #为正则匹配的内容，即“域名/”之后的字符串 } root html; index index.html index.htm; }
        
        2、旧域名访问/user/的请求跳转新域名，并且访问在路径上添加/new/
        
        server { listen 80; server_name www.xxx.com; charset utf-8; #添加 locatoin /user/ { rewirte (.+) http://www.newxxx.com/new permanent; #这里的为位置变量，代表/user/ } locaiton / { root html; index index.html index.htm; } }
        
        3、将动态链接改为伪静态链接（看起来像是静态链接的地址）
        
        用户访问：www.xxx.com/user/view/3/index.html
        实际地址：http://www.xxx.com/user/index.jsp?post=3&action=view
        
        location ~ /user/view { rewrite /user/(.*)/(.*)/(.*).html /user/.jsp?post=&action= last; } $N 表示第几个括号中的变量
        
        4、业务新版本上线，要求所有 IP 访问任何内容都显示一个维护页面，只有允许 IP 192.168.244.2访问后台业务
        
        先创建维护页面
        
        ehho "
        系统升级中... 持续时间 2023-12-24 23:00:00 -2023-12-24 23:50:00
        " > /var/www/html/system.html
        
        修改配置
        
        server { listen 80; server_name www.xxx.com; charset utf-8; # 显示中文 # 是否转发标记 set $rewrite true; #设置变量$rewrite，变量值为boole值true # 是否为内部IP if ($remote_addr = "192.168.244.2"){ set $rewrite false; } # 跳转维护页面 if ($rewrite = true){ rewirte (.+) /system.html; #将域名后边的路径重写成/system.html } location = /system.html { root /var/www/html; #网页返回维护页面 } location / { root html; index index.html index.htm; } }
        
        5、项目升级，但部分jsp链接未升级，需要将所有.jsp访问转发到原项目
        
        location ~* .*\.jsp { rewrite (.+) http://www.old.xxx.com permanent; }
        
        2. 总结
        
        本章，我们重点讲解了重定向和重写的区别，并且讲解了return,rewrite的用法，用实际的案例进行了演示，下一节我们将展示nginx如何实现企业安全防护
        
        广州有哪些网络公司证券官网入口永久免费自助建站系统个人页面设计网站制作公司哪家好大连专业制作网站

上一篇：Springboot3.0.0+集成SpringDoc并配置knife4j的UI

下一篇：Mac 升级ruby 升级brew update

0. 引言

1. 重定向、重写详解

1.1 return 详解

1.1.1 return 核心概念

1.1.2 return 案例

1.2 rewrite 详解

1.2.1 rewrite 核心概念

1.2.2 rewrite 案例

系统升级中... 持续时间 2023-12-24 23:00:00 -2023-12-24 23:50:00

2. 总结