内容

跳转管理

后台 跳转管理(/admin/redirects,仅管理员)把旧网址和多余的域名统一跳到新地址,用 301 保留搜索排名和外链带来的流量,类似 WordPress 的 Redirection 插件,但无需安装插件。修改约 1 分钟内在所有节点生效,不需要重新部署。

域名跳转(一个站点多个域名)

站点绑定了多个域名(旧域名、.cn / .com、带不带 www)时,让访客统一到主域名:

来源域名主域名效果
old-brand.comwww.example.comold-brand.com/zh/about?x=1 和 www.old-brand.com/... → https://www.example.com/zh/about?x=1
*www.example.com除主域名外的所有域名都跳到主域名(本地开发、*.pages.dev 预览和 IP 访问除外),常用于统一 www 与不带 www
  • 路径和参数原样保留,默认 301(永久),也可选 302 / 307 / 308。
  • 后台页面和前台页面都会跳转;/api/**、/_nuxt/** 等接口和资源不跳转(支付回调、定时任务、反向代理不受影响)。
  • 域名必须已经指向本站点(Cloudflare Pages 的「自定义域」、nginx 的 server_name 等)。在 Cloudflare Pages 上,这比「转发 URL」页面规则更可靠:自定义域会被 Pages 直接响应,页面规则不会生效。
  • 邮件(MX 记录)不受影响,只有 HTTP 访问会跳转。

也可以用环境变量配置(构建时写入,适合不想进后台的场景;与后台规则同时生效):

NUXT_HOST_REDIRECTS="old-brand.com>www.example.com,alias.fi>www.example.com>302"

网址跳转

来源目标说明
/old-page/zh/new-page精确匹配,忽略大小写和结尾 /,访客的参数(如 ?utm_source=)会带到目标
/blog/*/zh/posts/*结尾 * 匹配整个目录,* 的部分原样带到目标
/?p=123/zh/posts/hello带参数的来源只匹配完全相同的参数,用于 WordPress 旧链接
/removed-product(410)内容已永久删除,告诉搜索引擎不再收录
/产品https://shop.example.com/中文路径、完整网址都可以
  • 后台、接口、资源路径和首页不能作为来源;目标不能是 javascript: 等不安全链接,也不能指向自己。
  • 批量导入:每行 来源 目标 [状态码],空格、Tab 或逗号分隔,可直接粘贴其他跳转插件导出的 CSV(前两列为来源和目标),已存在的来源会跳过。
  • 测试:输入网址或路径,查看会跳到哪里。
  • 每条规则显示命中次数和最近命中时间(每分钟批量写入)。

404 记录

在「404 记录」中开启后,访问出现 404 的页面路径会被记录(访问次数、来源页面、最近时间,不记录 IP)。按次数排序就能找出迁移后还缺跳转的旧链接,点「添加跳转」直接建规则。常见的扫描探测路径(/wp-login.php、.env、.php 等)会被忽略;最多保留 5000 条,90 天未再出现的记录由定时任务自动清理。默认关闭。