上线部署：Cloudflare Pages

对于第一次部署，推荐使用 Direct Upload（直接上传）。它不需要 GitHub，也不需要购买服务器。

已经为你生成好的上传文件：

C:\Users\hqc\Desktop\ai\output\codex-docs-dist.zip

第一步：登录 Cloudflare

1. 打开 Cloudflare Dashboard。
2. 没有账号就先注册；已有账号直接登录。
3. 确认 dagoujiao.help 位于当前 Cloudflare 账号中。

如果主域名不在这个账号中，也可以先部署，稍后再处理域名绑定。

第二步：进入 Compute / Workers

Cloudflare 新版界面可能不再显示 Workers & Pages。按照你看到的页面任选一种入口：

• 点击左侧 Build → Compute；或
• 点击账户首页中间 Workers 卡片里的 Ship something new。

进入后：

1. 点击 Create application / Create（创建应用）。
2. 找到 Pages 或 Upload static assets（上传静态资源）。
3. 选择 Upload assets / Direct Upload（上传资源 / 直接上传）。

Cloudflare 的界面经常更新，核心是选择“上传静态资源”，不要选择从模板编写 Worker 代码。

第三步：创建项目

项目名称建议填写：

dagoujiao-docs

项目名称会生成一个临时地址，例如：

https://dagoujiao-docs.pages.dev

这个名称只允许英文、数字和短横线。

第四步：上传网站文件

上传文件：

codex-docs-dist.zip

如果 Cloudflare 当前页面不接受 ZIP：

1. 在 Windows 中右键压缩包。
2. 选择“全部解压”。
3. 打开解压后的文件夹。
4. 把里面的所有文件和文件夹拖入上传区域。

上传内容中应该能看到：

index.html
404.html
assets
guide
images

不要上传整个 ai 项目，也不要只上传 package.json。

第五步：部署并测试临时地址

1. 点击 Deploy site（部署网站）。
2. 等待 Cloudflare 显示部署成功。
3. 打开系统生成的 pages.dev 地址。
4. 测试首页、Windows、macOS、API 配置和 CCS 下载页面。

部署成功后，即使还没有绑定自己的域名，网站也已经可以公开访问。

第六步：绑定 docs.dagoujiao.help

1. 进入刚创建的 Pages 项目。
2. 打开 Custom domains（自定义域）。
3. 点击 Set up a custom domain（设置自定义域）。
4. 输入：

docs.dagoujiao.help

5. 点击继续并确认 DNS 配置。

如果 dagoujiao.help 已经在同一个 Cloudflare 账号中，Cloudflare 通常会自动创建 DNS 记录和 HTTPS 证书。

第七步：等待域名生效

域名状态显示 Active（有效） 后访问：

https://docs.dagoujiao.help

刚绑定时可能需要几分钟。如果提示证书未生效，先等待，不要反复删除 DNS 记录。

以后如何更新网站

每次修改教程后，在项目目录运行：

npm run docs:build

重新压缩：

Compress-Archive -Path "docs\.vitepress\dist\*" `
  -DestinationPath "output\codex-docs-dist.zip" -Force

然后进入 Cloudflare Pages 项目，点击 Create new deployment（创建新部署），重新上传压缩包。

部署失败时检查

问题	处理方法
打开后只有文件列表	上传层级错误，确保根目录直接存在 index.html
页面显示 404	重新上传完整 dist 内容，不要漏掉 assets 和 guide
图片不显示	确保上传内容中包含 images 文件夹
自定义域一直未激活	检查域名是否在同一个 Cloudflare 账号中
ZIP 无法上传	解压后拖入全部文件和文件夹

WARNING

部署文件中不要加入 API Key、后台账号密码或用户数据。这个文档站只需要公开教程和图片。