站点重定向

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

站点重定向在迁移文档或重组内容以避免断链（可能影响 SEO）时非常有用。

当您将文档从一个提供商迁移到另一个提供商时（例如刚将文档迁移到 GitBook），通常会使用重定向。断链会影响 SEO，因此我们建议在需要的地方设置重定向。

除了 由 GitBook 创建的自动重定向之外，您可以从站点域中的任何路径创建重定向。

在站点上管理重定向

要开始，请在 GitBook 中查看您站点的仪表板并打开 设置 选项卡，然后点击 域与重定向.

创建重定向

点击 添加重定向 并选择 手动 选项。

填写来源路径 —— 即您希望重定向到其他位置的 URL 段，以及您希望链接到的目标内容。您可以选择任何 章节, 变体，或 页面 到您的站点。点击 添加 以创建重定向。

您也可以创建 通配符重定向 通过在来源路径末尾添加 *，例如：

• /docs/* 匹配 /docs/ 下的所有内容

• /changelog* 匹配以 /changelog 开头的路径

当您的来源路径包含通配符 (*) 时，您可以启用 将通配符替换为匹配文本.

• 开启： 被 * 匹配的部分会追加到目标路径。

  • 示例：来源 /docs/* → 目标 /help /docs/install 重定向到 /help/install

• 关闭： 所有匹配的 URL 都重定向到相同的固定目标。

  • 示例：来源 /docs/* → 目标 /help /docs/install 重定向到 /help

如果您想为同一页面添加另一个重定向，可以在点击之前切换 添加另一个重定向 选项为开启。 添加当您添加重定向时，模态窗口会保持打开，目标内容会设置为先前的选择，这样您就可以立即添加另一个 URL 段。

编辑重定向

要编辑重定向，请在列表中按其旁边的 编辑 图标。更新重定向并点击 保存.

要删除重定向，请按 删除重定向 按钮并确认。

从 CSV 导入重定向

点击 添加重定向 并选择 上传 CSV.

上传一个恰好包含两列且列名为： source 和 destination：

• 来源是您想要重定向的路径（例如 /docs/site-redirects）

• 目标可以是：

  • 一个特定页面：使用该页面的管理员 URL，如下图所示

  • 一个外部 URL

  • 一个空字符串（""）：会移除该来源的重定向

您可以在此菜单中找到页面的 GitBook 管理员 URL

每次导入最多支持 500 行。

如果您的 CSV 包含重复的来源值，则仅处理第一行。导入以 upsert（更新或插入）方式运行：具有相同来源的现有重定向会被更新，而对于尚不存在的来源会创建新的重定向。

如果有任何行失败，右下角的提示中会提供一个错误 CSV。它包含来源、目标和每个错误的简要说明，便于您修复，删除错误列后重新导入。

关于自动重定向

每当页面被移动或重命名时，其规范 URL 也会随之改变。为了保持内容可访问，GitBook 会自动创建一个 HTTP 307 从旧 URL 到新 URL 的重定向。

每次加载 URL 时，GitBook 会通过以下步骤解析该 URL：

1. 站点内容通过遵循任意自动创建的重定向解析到其规范 URL。

2. 如果无法解析该 URL，则会将该 URL 与 空间级重定向进行匹配，这些重定向在您仓库的 .gitbook.yaml 文件中定义。

3. 最后，该 URL 会与通过以下方式创建的站点级重定向进行匹配， 上述流程.