推一次代码，App 自动上线

本地建项目

用脚手架生成项目骨架，本地先跑通再说后面的事。

npm create vite@latest my-app -- --template react
cd my-app
npm install
npm run dev        # 本地预览，确认能跑

推到 GitHub

代码托管到 GitHub，流水线就挂在仓库上。注意把 package-lock.json 一起提交——云端靠它精确还原依赖。

git init
git add .
git commit -m "init"
gh repo create my-app --public --source=. --push

写流水线文件

在仓库里新建 .github/workflows/deploy.yml，告诉 GitHub Actions：什么时候触发、在云端按什么顺序干活。不用手写——下一节的生成器选好选项就能直接下载。

接上 Cloudflare Pages

两种接法任选：让 Pages 直接连 GitHub 仓库自动构建（零配置、最省事），或者由 GitHub Actions 构建完再用 wrangler 推给 Pages（控制权全在自己手里）。细节见第三节。

绑定自己的域名

把域名绑到 Pages 项目上，之后每次 push 都是给这个域名更新版本。像 mu2.is-a.bot 这样的子域名、以及在 Cloudflare 注册满 30 天的域名，都可以走这一步。

接法一：Pages 直连 GitHub（最省事）

Cloudflare 控制台 → Workers & Pages → Create → Pages → Connect to Git，选中仓库，再按第四节的预设表填好「构建命令」和「输出目录」，保存。此后每次 push，Pages 自己拉代码、构建、发布，仓库里连 workflow 文件都不用放。

适合：纯前端项目、想最快上线。代价是构建过程在 Cloudflare 那边，流水线细节（多一步测试、构建后处理）不如 Actions 灵活。

接法二：GitHub Actions 构建 + wrangler 部署（本页生成器用的就是这个）

构建和测试都在 GitHub Actions 里跑，最后一步用 cloudflare/wrangler-action 把产物推到 Pages。需要在仓库的 Settings → Secrets and variables → Actions 里加两个密钥：

CLOUDFLARE_API_TOKEN    # Cloudflare 控制台 → 头像 → My Profile → API Tokens 创建，权限选 Cloudflare Pages: Edit
CLOUDFLARE_ACCOUNT_ID   # Cloudflare 控制台首页右侧或域名概览页可见

适合：要在部署前跑测试、一个仓库发多个目标、或者想把发布流程完全版本化管起来。

绑定自定义域名

Pages 项目 → Custom domains → Set up a custom domain，输入要绑的域名：

· 域名就在同一个 Cloudflare 账号里（比如在 Cloudflare 注册、已满 30 天的域名）：Cloudflare 自动添加 CNAME 记录，什么都不用手动配，等几分钟证书签发完，HTTPS 自动开启。

· 像 mu2.is-a.bot 这样的外部子域名：先在 is-a.bot 的申请里把记录指到本站的 pages.dev 地址（CNAME），或拿到 NS 托管后把子域名作为站点加进 Cloudflare，再回到 Pages 里绑定。