使用令牌连接您的 GitHub 账号，以便从仓库部署您的网站

连接操作为您带来的优势

使用令牌连接 GitHub 允许网站从您的某个仓库进行部署：推送到分支，网站即会更新。当您选择 GitHub Pages 作为网站主机时，它还允许我们将其发布到您账户下的 GitHub Pages。

如果您的仓库属于某个组织，请改用 the Zinn® GitHub app —— 参见安装 Zinn® GitHub app。令牌属于个人，当该人员离开时将失效。

开始之前

拥有一个能够访问您想要部署的仓库的 GitHub 账户。如果它们属于某个组织，可能需要组织所有者为其批准细粒度令牌。

1. 在 GitHub 上创建密钥

在 GitHub 上，点击您的头像，然后依次点击 Settings → Developer settings → Personal access tokens → Fine-grained tokens → Generate new token。为其命名并选择过期时间。在 Repository access 下选择 Only select repositories 并挑选您要部署的仓库——即能够正常工作的最小权限范围。

在 Repository permissions 下，为以下项授予 Read and write 权限：

• Contents
• Pages
• Administration

点击 Generate token 并复制它 —— GitHub 只会显示一次。

2. 在此处进行连接

在您的控制面板中打开 Integrations 并选择 Connect an account。选择 Code hosting 作为分组，选择 GitHub 作为账户，填写 API token，然后点击 Connect account。

在保存任何内容之前，我们会对您粘贴的内容进行测试。无效的密钥绝不会被存储，系统会给出报错原因。有效的密钥将被加密保存在我们的密钥保管库中（绝不保存在数据库中），并且绝不会再次显示，连您本人也无法查看。

接下来会发生什么

• 网站可以直接从此账户下的仓库进行部署：在网站的仓库连接中进行选择，挑选仓库和分支，推送即可完成部署。
• 每个其他分支都可以拥有自己的预览，以便您在更改生效到线上网站之前对其进行检查。
• 诸如 Render 和 Azure Static Web Apps 等 Git 构建的静态主机使用此连接作为网站代码的来源。

如果连接失败

仓库未显示。 令牌的仓库访问权限中未包含该仓库。请在 GitHub 上编辑令牌并添加该仓库。

曾经连接成功，后来失效了。 细粒度令牌会在您选择的日期过期。请生成新令牌并进行连接；GitHub 会在令牌过期前向您发送电子邮件。

提示密钥被拒绝。 通常是以下三种情况之一：复制时带入了空格或换行符、密钥已过期、或者密钥在您复制后已被撤销或重新生成。请创建一个新密钥并重新粘贴。

连接成功，但后续操作失败。 密钥通过了身份验证，但缺少该操作所需的权限。请使用上面列出的权限创建一个新密钥，然后断开旧连接并连接新密钥。

断开连接

打开 Integrations，找到该账户并点击 Disconnect. 这会立即删除存储的密钥。任何使用该密钥的内容将在下一次操作时停止，并且依赖它的屏幕会明确提示，而不是默默失败。

断开连接不会撤销已经完成的操作 —— 我们在您的账户上更改的记录、部署或设置将保持原样。如果您认为密钥本身可能已泄漏，请同时在供应商处将其撤销；断开连接只会删除我们的副本，而不会删除他们的副本。