Cloudflare 建站指南

先判断你属于哪条建站路线

首版不追求覆盖所有组合，先把最常见、最适合小团队的三种方式说清楚。

推荐默认

适合文档站、内容站、说明页和落地页。项目代码在 GitHub，Pages 负责构建与托管，再绑定你的自定义子域名。

需要接口

页面仍然静态部署，表单、鉴权、Webhook 或轻量 API 放到 Worker。这样前端部署速度快，接口也能独立扩展。

多站共享

每个前端子项目继续独立发布，API 单独维护。这样不会因为一个站点改动影响所有前端部署。

资料里反复强调：仓库、Pages 项目、slug 和子域名如果不统一，后面多项目一起维护时很容易混乱。

对象	推荐写法	说明
项目 slug	cloudflare-site-guide	作为整个项目的核心标识，目录名也应一致。
GitHub 仓库	cloudflare-site-guide	便于和 Pages 项目、部署台账一一对应。
Pages 项目	cloudflare-site-guide	Cloudflare 控制台中尽量沿用同名。
子域名	cloudflare-site-guide.example.com	和 slug 对齐，减少 DNS、文档和截图沟通成本。

前端公开页面不要保存密钥

原始资料明确提醒：Secrets、API Token、数据库连接信息都不应放进前端代码和静态资源。前端公开站只保留公开信息，需要保密的值统一放进 Pages 或 Worker 的环境变量。

不是每个站都需要数据库。首版先把选择逻辑缩成容易记住的几类。

适合配置、简单缓存、标记位、轻量映射。读取快，适合不追求复杂查询的场景。

适合结构化数据、后台管理、需要 SQL 查询的业务。对于有内容表和关系型数据的项目更稳。

适合图片、文件、导出包等对象存储。网页静态资源通常仍由 Pages 或构建产物托管。

这几项不是上线后再补的，而是新项目刚建时就应确定。