内容
跳转管理
后台 跳转管理(/admin/redirects,仅管理员)把旧网址和多余的域名统一跳到新地址,用 301 保留搜索排名和外链带来的流量,类似 WordPress 的 Redirection 插件,但无需安装插件。修改约 1 分钟内在所有节点生效,不需要重新部署。
域名跳转(一个站点多个域名)
站点绑定了多个域名(旧域名、.cn / .com、带不带 www)时,让访客统一到主域名:
| 来源域名 | 主域名 | 效果 |
|---|---|---|
old-brand.com | www.example.com | old-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 天未再出现的记录由定时任务自动清理。默认关闭。