操作指南 · 网页上线

把网页部署到 Cloudflare Pages：免费、快速、有手就行

适用对象：WorkBuddy 使用者 · 无需编程基础 · 一次配置长期有效

一句话核心：AI 帮你做好的 HTML 网页，用 Cloudflare Pages 一键上线，立刻获得一个 https://项目名.pages.dev 的公开链接——免费、全球 CDN 加速、自动 HTTPS，发给任何人都能打开。

一、先搞懂：Cloudflare Pages 是什么

Cloudflare Pages 是一个静态网站托管服务：你把 HTML 文件交给它，它帮你挂到网上，全球可访问。可以理解为「免费的网站门面」。

免费

零成本

静态托管免费额度对个人完全够用，不限带宽请求量。

快

全球 CDN

内容分发到全球节点，访问者就近取内容。

省心

自动 HTTPS

不用买证书、不用配服务器，部署完就是一个 https 链接。

可更新

改完重发即生效

网页改了重新部署一次，链接不变、内容更新。

和其他方案怎么选

方案	适合场景	备注
Cloudflare Pages	对外分享、作品集、报告页	免费 + 全球 CDN，国内访问速度一般
GitHub Pages	和 GitHub 仓库绑定的展示页	免费，需仓库 Public，国内访问慢
OA Pages（公司内网）	只对同事可见的页面	内网权限可控，不用注册外部账号

原则：对外展示用 Cloudflare Pages / GitHub Pages，对内协作用 OA Pages，需要登录、存数据、跑后端程序才考虑买服务器。

二、一次性准备：拿到两把钥匙（约 5 分钟）

部署需要两样东西，只需要配置一次，以后长期有效：

打开 dash.cloudflare.com，用邮箱注册，免费计划即可。

创建 API Token（第一把钥匙）

进入 dash.cloudflare.com/profile/api-tokens → Create Token → 选「Edit Cloudflare Workers」模板 → Account Resources 选你的账户 → 创建后立即复制保存（只显示一次）。

记下 Account ID（第二把钥匙）

Cloudflare 控制台首页右侧边栏就能看到，一串 32 位字母数字。

交给 AI 保管

把 Token 和 Account ID 发给 WorkBuddy，让它配好环境变量。之后每次部署不用再碰这两样东西。

Token 等于账号钥匙，不要写进会公开的文档、网页或群聊。如果泄露了，去控制台把旧 Token 吊销（Roll），重新生成一个。

三、日常使用：一句话部署

配置完成后，每次上线只要一句话：

把这个网页部署到 Cloudflare Pages，项目名叫 my-report

检查文件 → 调用部署工具 → 返回线上地址 https://my-report.pages.dev

网页我改好了，重新部署一下

重新上传 → 链接不变，内容更新，1 分钟内生效

背后的原理（知道就行，不用操作）

# AI 实际执行的命令（wrangler 是 Cloudflare 官方 CLI）
wrangler pages deploy ./我的网页目录 --project-name=my-report

首次部署会自动创建项目；之后同项目名再部署就是更新。生产地址固定为 https://项目名.pages.dev。

四、常见问题

问题	原因与解决
部署后打开 404	入口文件必须叫 `index.html`（注意大小写）；确认部署的目录里直接放着它。
页面样式丢失 / 图片不显示	多是文件路径问题——CSS、图片要和 HTML 一起放进部署目录，让 AI 检查引用路径。
更新了但打开还是旧内容	浏览器缓存。`Ctrl + Shift + R` 强制刷新，或开隐身窗口验证。
国内打开慢	Cloudflare 国内节点有限，属正常现象。重要场合可以绑定自己的备案域名加速，或改用国内托管。
想要更好记的网址	在 Pages 项目 → Custom domains 里绑定自己的域名（如 `report.你的域名.com`）。

五、安全红线（务必记住）

API Token 不进公开内容：不写进要部署的网页、不进 Git 公开仓库、不发群聊。
敏感页面加保护：含个人信息的页面（如简历），让 AI 给站点加访问密码再上线。
泄露即吊销：怀疑 Token 泄露，第一时间去控制台 Roll 掉换新。

今天带走三件事

1 · 两把钥匙配一次

API Token + Account ID，交给 AI 保管，长期有效。

2 · 部署就一句话

「把这个网页部署到 Cloudflare Pages」，链接即刻生成。

3 · Token 是钥匙

不进公开页面，泄露就吊销换新。