Cloudflare Pages 新仓库部署指南

🌐 Cloudflare Pages 新仓库部署指南

适用于：你想用 Cloudflare Pages 部署新建或重建的 GitHub 仓库，并绑定自定义域名。

前提

github上有一个A仓库，然后你把A仓库删掉了，又建了一个新的A仓库，名字一样，但是发现cloudflare不能构建了

步骤 1：删除旧 Pages 项目（如果存在）

1. 登录 Cloudflare → Pages → 旧项目

2. 删除绑定的自定义域名：

   • 进入 Settings → Custom domains
   • 点击域名旁的 Remove/Delete

3. 删除 Pages 项目：

   • 进入 Settings → General → Delete this project
   • 确认删除

⚠️ 注意：如果不删除旧项目，Pages 仍然绑定旧仓库，新仓库提交无法触发构建。

步骤 2：创建新的 Pages 项目

1. 登录 Cloudflare → Pages → Create a project

2. 选择 GitHub 作为代码源

3. 选择新建的仓库

4. 设置 分支（如 main）

5. 配置 构建设置：

   • Build command（构建命令）：根据你使用的框架填写（如 Astro、Next.js 等）
   • Output directory（输出目录）：构建后生成静态文件的目录

步骤 3：绑定自定义域名

1. 在 Pages 项目页面，进入 Settings → Custom domains

2. 点击 Add custom domain

3. 输入你的域名

4. 完成域名验证：

   • Cloudflare 会自动检查 DNS 设置
   • 如果域名在 Cloudflare DNS 上管理，确保 A/CNAME 记录正确

5. 等待验证通过

步骤 4：清理缓存（推荐）

• 在 Settings → Build & Deploy → Clear build cache
• 确保第一次构建是干净的，不会使用旧缓存

步骤 5：触发构建

• 方法 A：推送 commit

git commit --allow-empty -m "trigger initial deploy"
git push origin main

• 方法 B：在 Pages 页面点击 Deploy latest commit

构建完成后，Cloudflare 会自动部署到自定义域名和默认 Pages 域名。

步骤 6：检查部署

1. 在 Pages 项目页面查看最新部署状态
2. 确认显示 Build successful / Deployment complete
3. 访问域名确认网页显示新内容

经验总结 / Tips

• 仓库名字相同不等于绑定同一项目，Pages 绑定的是 GitHub 仓库 ID。
• 删除旧项目是必须的，否则新仓库提交无法触发构建。
• 清理构建缓存可以避免旧依赖或资源影响新构建。
• 空提交（--allow-empty）是触发构建的快速方式，即使没有改动。
• 第一次启用自定义域名部署可能稍慢，耐心等待几分钟即可。