站点重定向
设置站点重定向,将流量引导到你站点上的任意内容

当你将文档从一个提供商迁移到另一个提供商时,通常会使用重定向——比如你刚把文档迁移到 GitBook 时。失效链接会影响 SEO,因此我们建议在需要的地方设置重定向。
除了 GitBook 创建的自动重定向之外,你还可以从站点域名中的任意路径创建重定向。
重定向可以创建为 生效 或 草稿。草稿重定向允许你在发布之前准备并审核重定向规则。草稿在启用之前不会影响你的线上站点。
管理站点上的重定向
要开始使用,请在 GitBook 中查看你站点的仪表板,并打开 设置 选项卡,然后点击 域名与重定向.
创建重定向
点击 添加重定向 并选择 手动 选项。
填写 源路径 ——你想要重定向的 URL slug——以及 目标 内容,即你希望访客被带到的内容。你可以选择你站点上的任意区块、变体或页面。
点击 启用重定向 可立即启用该重定向。
如果你想先创建重定向但暂时不让它生效,请改为点击 另存为草稿 。草稿重定向会出现在 草稿 选项卡中,并可稍后启用。
你也可以通过在源路径末尾添加 * 来创建 通配符重定向 ,例如:
/docs/* 匹配 /docs/ 下的所有内容
/changelog* 匹配以 /changelog 开头的路径
当你的源路径包含通配符 (*) 时,你可以启用 用匹配文本替换通配符.
开启: 被 * 匹配的部分会追加到目标路径。
示例:源 /docs/* → 目标 /help /docs/install 重定向到 /help/install
关闭: 所有匹配的 URL 都会重定向到同一个固定目标。
示例:源 /docs/* → 目标 /help /docs/install 重定向到 /help
如果你想为同一页面添加另一个重定向,请在点击之前切换 添加另一个重定向 。 启用重定向 或 另存为草稿.
当你添加重定向时,弹窗将保持打开状态,目标内容会保留为你之前的选择,这样你就可以快速添加另一个源路径。
编辑重定向
要编辑重定向,请点击列表中其旁边的 编辑 图标。更新重定向后,点击 启用重定向 以发布你的更改。
如果该重定向当前是 草稿,你也可以在编辑弹窗中通过点击 启用重定向.
启用草稿重定向
草稿重定向会出现在重定向表格的 草稿 选项卡中。
你可以通过两种方式发布草稿重定向:
• 打开该重定向并点击 启用重定向 在编辑弹窗中。 • 使用表格中的 切换开关 直接启用该重定向。
一旦启用,重定向会移到 生效 选项卡,并立即开始为访客进行路由。
从 CSV 导入重定向
点击 添加重定向 并选择 上传 CSV.
上传一个包含以下列的 CSV source, 目标,以及可选的 intent.
source是你想要重定向的路径,例如 /docs/site-redirects目标可以是:某个特定页面,使用其管理后台 URL,如下图所示
外部 URL
空白,取决于 intent
intent可以是:live,留空,或完全省略,用于创建、更新或移除生效重定向
draft,用于创建、更新或移除草稿重定向
publish,用于将现有草稿重定向发布为生效状态,
目标必须为空。

每次导入最多支持 500 行。
如果你的 CSV 包含重复的 source 值,只会处理第一行。导入以 upsert 方式运行:具有相同 source 的现有重定向会被更新,而尚不存在的 source 会创建新的重定向。
如果有任何行失败,可从右下角的提示气泡中获取错误 CSV。它包含 source、destination 以及每个错误的简要说明,方便你修复后删除错误列并重新导入。
CSV 示例
/docs/site-redirects
https://example.com/page
空白
创建或更新生效重定向
/docs/site-redirects
https://example.com/page
生效
创建或更新生效重定向
/docs/site-redirects
https://example.com/page
草稿
创建或更新草稿重定向
/docs/site-redirects
空
空白
移除生效重定向
/docs/site-redirects
空
生效
移除生效重定向
/docs/site-redirects
空
草稿
移除草稿重定向
/docs/site-redirects
空
publish
将现有草稿重定向发布为生效状态
关于自动重定向
每当页面被移动或重命名时,它们的规范 URL 也会随之改变。为了保持你的内容可访问,GitBook 会自动创建一个 HTTP 307 从旧 URL 到新 URL 的重定向。
每次加载 URL 时,GitBook 会按以下步骤解析它:
最后更新于
这有帮助吗?