Web 服务器与网关 / 系统课时

return 为什么适合简单重定向

return 为什么适合简单重定向

整站换域名或 HTTP 升级 HTTPS 时,目标往往只由固定主机名加原路径组成。本篇用 return 明确返回状态和目标地址,保留路径与查询参数,并检查未知 Host 与目标站点,减少无必要的正则匹配。

学习目标

  • 用 return 表达固定目标的简单重定向。
  • 保留原始路径与查询参数,限制允许的目标主机名。
  • 按第一跳和最终响应分别验收域名迁移。

固定映射不需要捕获路径

return 会结束当前处理,返回指定状态和地址。当所有路径都迁往同一个新域名时,可以直接拼接固定前缀与 $request_uri,不必先用正则把整条路径捕获出来。

request_uri 包含原始请求 URI 及查询参数;$uri 是当前规范化 URI,不包含查询参数,并可能在内部处理时变化。选择变量应由迁移规则决定,不能把两者随意互换。return 的参数与上下文见 Nginx return 文档。

在两个本机域名间完成迁移

以下片段示例位于 http,Nginx 1.28、curl 与空闲 8080 即可验证,不依赖公网 DNS。默认站点拒绝未知 Host;已有相同监听的 default_server 时先合并。

nginx
server {
    listen 127.0.0.1:8080 default_server;
    server_name _;
    return 404;
}
server {
    listen 127.0.0.1:8080;
    server_name old.test;
    return 308 http://new.test:8080$request_uri;
}
server {
    listen 127.0.0.1:8080;
    server_name new.test;
    location / { return 200 "new-site\n"; }
}

这里用 308 表示永久迁移并保持方法;如果页面迁移选择 301,需另外验收 POST 行为。本机使用 HTTP 只为隔离观察地址映射,生产应先准备可完整验证的 HTTPS 目标。

对照路径和查询参数

检查并重载成功后运行:

bash
# 先看第一跳,再带两个域名的解析覆盖跟随。
curl --noproxy '*' --resolve old.test:8080:127.0.0.1 -sS -o /dev/null -D - 'http://old.test:8080/docs/start?lang=zh'
curl --noproxy '*' --resolve old.test:8080:127.0.0.1 --resolve new.test:8080:127.0.0.1 -sS -L -w 'status=%{http_code}\n' 'http://old.test:8080/docs/start?lang=zh'

预期结果:第一条返回 308,Location 为 http://new.test:8080/docs/start?lang=zh。第二条输出:

text
new-site
status=200

再访问 new.test,应直接返回 200,不得跳回 old.test;使用未知 Host 应得到 404。只测首页 / 容易漏掉参数丢失、编码路径与应用深层链接的问题,验收集合应包含实际业务路径。

生产目标一次归一到正确地址

若实际规范地址是 https://www.example.test,先配置真实证书覆盖它并验证 HTTPS 可用,再把 HTTP 旧域名和 HTTP 规范域名引向该地址。以下片段依赖空闲 80 及已经存在的 HTTPS 站点,示例名称需替换为实际拥有的域名:

nginx
server {
    listen 80;
    server_name old.example.test www.example.test;
    return 308 https://www.example.test$request_uri;
}

这样可以减少“先换域名、再换协议”的多次往返。HTTPS 旧域名若也需迁移,必须先具备覆盖旧域名的可用证书,握手成功后才能返回跳转。

目标主机名使用固定允许值,不能把任意传入 Host 当作新站点地址。若旧路径与新路径不是一一对应,或者要删除、改写参数,则需要显式映射规则;简单 return 只负责已确定的地址拼接,不负责猜测应用路由。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

return 为什么适合简单重定向

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通