使用 Cloudflare 配置子目录

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

1

配置你的 GitBook 站点

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

输入你希望托管文档的网站 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”部分中，点击 + 添加.

在打开的“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 时，你应该会看到你的文档站点！