使用 Cloudflare 配置子目录

使用 Cloudflare 通过 /docs 子目录托管您的文档

此功能可在 终极站点计划.

1

配置你的 GitBook 站点

在你的 GitBook 组织中，在侧栏点击你的文档站点名称，然后点击 管理站点 或打开 设置 选项卡。打开 域名和重定向 部分并在“子目录”下，点击 设置子目录.

输入你希望托管文档的 URL。然后为文档访问指定子目录，例如， tomatopy.pizza/docs，并点击 配置.

在 其他配置，你现在会看到一个代理 URL。在配置你的 Cloudflare worker 的下一步中会用到它。将其复制到剪贴板。

2

创建你的 Cloudflare worker

登录你的 Cloudflare 帐户并导航到 Workers & Pages

点击 创建 按钮。

在“创建应用程序”屏幕上，点击 Hello world 按钮（位于“从模板开始”卡片中）。

给该 worker 起一个更具描述性的名称，例如 mydocs-subpath-proxy。重命名 worker 完成后，点击 部署.

3

配置你的自定义域名

你的 worker 会获得一个默认 URL 可供使用。要改为配置你的自定义域名（例如 tomatopy.pizza），点击 设置。 然后，在“域与路由（Domains & Routes）”部分，点击 + 添加.

在打开的“域与路由”托盘中，点击 自定义域名，然后在随后的文本框中输入你的自定义域名。当你指定自定义域名时， 不要 包含子目录。例如， tomatopy.pizza 是正确的，而 tomatopy.pizza/docs 则不正确。

4

更新 worker 代码

当 worker 部署完成后，点击 编辑代码，或点击 继续到项目，然后点击右上角的 编辑代码 按钮。

在打开的代码编辑器中，用以下代码片段替换示例代码：

export default {
  fetch(request) { 
    const SUBDIRECTORY = '/docs';
    const url = new URL(request.url);
    const target = "<INSERT YOUR PROXY URL FROM GITBOOK>" + url.pathname.slice(SUBDIRECTORY.length);
    const proxy = new URL(
      target.endsWith('/') ? target.slice(0, -1) : target 
    )
    proxy.search = url.search;
    return fetch(new Request(proxy, request));
  }
};

务必在第 5 行将 URL 更新为你在第一步从 GitBook 获取的代理 URL。

完成后，点击 部署。此过程可能需要几分钟。完成后，访问该 URL 时，你应该能看到你的文档站点！