Skip to content

Managing GitHub Integration in Supabase Studio

Last edited: 8/12/2026

在项目或组织设置中，可能找不到断开 GitHub 账号的选项，或者在尝试修改组织级集成时会显示权限错误。这是因为 GitHub 集成分为三个不同的层级——账户、组织 和 项目——而底层的 OAuth 授权存在于账户层级。

🌐 The option to disconnect a GitHub account may be missing from Project or Organization settings, or permission errors may be displayed when trying to modify organization-level integrations. This happens because the GitHub integration is managed at three distinct levels — Account, Organization, and Project — and the underlying OAuth grant lives at the Account level.

GitHub 连接配置的位置 #

🌐 Where the GitHub connection is configured

1. 账户偏好 #

🌐 1. Account preferences

在 账户偏好设置 中，你授权 GitHub OAuth 应用，这样 Supabase 就可以读取你的仓库。从这里你可以重新认证或完全移除连接。

🌐 In Account Preferences you authorize the GitHub OAuth app so Supabase can read your repositories. From here you can re-authenticate or remove the connection entirely.

2. 组织整合设置 #

🌐 2. Organization integration settings

在 组织集成设置 中，你可以看到组织里所有连接到 GitHub 仓库的项目。在这里你可以：

🌐 In Organization Integration Settings you can see every project in the organization that is connected to a GitHub repository. From here you can:

  • 打开 配置连接 以跳转到项目集成设置。
  • 删除连接以移除项目与其 GitHub 仓库之间的关联。这不会撤销账户级别上的 OAuth 授权。

如果你的角色只允许访问组织中的部分项目，那么本页的 GitHub 和 Vercel 部分可能会返回权限错误。请参阅 访问控制 — 组织集成权限 了解所需权限。

🌐 If your role only grants access to a subset of projects in the organization, the GitHub and Vercel sections of this page can return a permission error. See Access Control — organization integration permissions for the required permissions.

3. 项目整合设置 #

🌐 3. Project integration settings

项目级设置让你可以将预览分支与选定的 GitHub 分支同步，保持生产分支同步，并为每个拉取请求自动创建预览分支。

🌐 Project-level settings let you sync preview branches with a chosen GitHub branch, keep the production branch in sync, and automatically create a preview branch for every pull request.

如何更新或删除连接 #

🌐 How to update or remove the connection

  1. 前往 账户偏好。
  2. 找到 GitHub 集成部分。
  3. 点击 管理，然后 移除连接。
  4. 要链接不同的 GitHub 账号或更改已授予的权限范围，请从你想应用新链接的项目或组织重新启动 GitHub 连接流程。

🌐 Related guides