Git 集成

你可以将每个 Cloudflare Pages 项目连接到 GitHub 或 GitLab 仓库，Cloudflare 会在每次向分支推送更改时自动部署代码。

将 git 仓库连接到 Cloudflare Pages 项目时，Cloudflare 还会：

• 为自定义分支提供预览部署，为仓库中任意分支的提交生成预览 URL，而不影响生产部署。
• 在仓库的 pull request（PR）中提供 预览 URL。
• 在 Git 仓库中提供 构建和部署状态检查。
• 使用提交消息跳过构建。

这些功能让你可以直接在 GitHub 或 GitLab 中管理部署，而无需离开团队的常规开发工作流。

Cloudflare 支持将 Cloudflare Pages 连接到你的 GitHub 和 GitLab 仓库。Pages 目前不支持连接自托管的 GitHub 或 GitLab 实例。

若使用其他 Git 提供商（如 Bitbucket）或自托管实例，可从 Direct Upload 项目开始，并使用 CI/CD 提供商（如 GitHub Actions）配合 Wrangler CLI 部署。

若 Cloudflare 账户未关联 Git 账户，首次 连接 Git 或添加新 Git 账户时会提示设置 GitHub 或 GitLab 安装。按提示操作并授权 Cloudflare Git 集成。

可在以下页面检查 Git 集成是否已安装：

• GitHub Applications（应用）页面 ↗（若在组织中，选择 Switch settings context（切换设置上下文） 访问 GitHub 组织设置）
• GitLab Authorized Applications（已授权应用）页面 ↗

有关为组织账户提供访问权限的详情，请参阅 GitHub 和 GitLab 指南。

可通过前往 Pages 项目，然后 Settings（设置） > Builds（构建），在 Git Repository（Git 仓库） 下选择 Manage（管理） 来管理仓库连接关联的 Git 安装。

这对管理仓库访问权限或通过重新安装排查安装问题很有用。更多详情请参阅 GitHub 和 GitLab 指南。

若使用 Git 集成项目且不想在每次推送提交时触发部署，可使用 分支控制 禁用/暂停构建：

然后，可使用 Wrangler 直接部署到 Pages 项目，并更改 Git 仓库而不自动触发构建。