Cloudflare Pages / Workers / 域名发布

把 Cloudflare 建站流程讲清楚,再开始做项目。

这是一份给独立开发者和小团队的建站指南。它不直接照搬原始笔记,而是把路线选择、配置规则、落地步骤和上线检查提炼成更适合网页阅读的结构。

内容入口

按你当前所处阶段进入

首页只保留摘要和路径指引,详细步骤、命令和配置说明分别放在三个主内容页。

路径指引

先定路线,再开始落项目

不是所有站点都需要同一套托管方式。首版把最常见的三种落地路线先讲清楚。

静态站优先

纯内容站或文档站

默认优先 GitHub + Cloudflare Pages。构建产物清晰,成本低,适合博客、指南站、落地页和说明页。

动态能力补充

页面带表单、接口或鉴权

前端仍可走 Pages,接口能力拆到 Worker 或独立 API。先分清静态页面和动态能力的边界。

多项目复用

多个前端共用一个 API

前端项目继续独立发布,接口集中维护。命名、环境变量和域名规则要提前统一,避免后期失控。

快速检查项

上线前先盯住这些高频失误

从命名、构建产物、域名绑定到环境变量,先把最容易返工的点过一遍。

  • slug、仓库名、Pages 项目名、子域名前缀尽量保持一致
  • 静态导出项目要确认 `next.config` 已开启 `output: 'export'`
  • 构建后产物目录是否明确,例如 Pages 场景常用 `out`
  • 正式域名和 pages.dev 默认域名都要分别确认可访问
  • 前端不要放 Secrets,密钥只放在 Pages / Worker 环境变量里
  • 如果页面需要调用 API,要先处理 CORS 与来源域名白名单
  • Web Analytics 和自定义埋点应在上线前接好,而不是上线后补
  • README、DEPLOY 和台账要同步更新,避免项目交接后失控
加入飞书群

需要后续模板、排障表或上线答疑

当前群入口还在整理,先保留统一占位 CTA。后续替换真实链接时,只需要修改一处配置。