知识库

使用令牌连接您的 GitHub 帐户,以便从存储库部署您的网站

为您部署的存储库创建细粒度 GitHub 令牌并进行连接,这样推送即可部署您的站点,并且分支也可以获得预览。

连接该账户为您带来的便利

使用令牌连接 GitHub 允许网站从您的某个代码库进行部署:推送至相应分支,网站便会自动更新。当您选择将 GitHub Pages 作为网站主机时,该连接还允许我们发布至您账户下的 GitHub Pages。

如果您的代码库属于某个组织,请改用 Zinn® GitHub 应用 — 参见《安装 Zinn® GitHub 应用》。令牌仅属于个人,会在该人员离职后失效。

开始之前

一个拥有您想要部署的代码库访问权限的 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。

我们在保存任何内容之前都会测试您粘贴的内容。无法使用的密钥绝不会被存储,并且返回的提示会说明其问题所在。能够正常使用的密钥将加密保存在我们的机密保险库中 — 绝不会存入我们的数据库 — 并且绝不会再次显示,即使对您本人也是如此。

后续运作方式

  • 网站可以直接从此账户上的代码库进行部署:在网站的代码库连接中选择它,选定代码库和分支,推送即可触发部署。
  • 所有其他分支均可拥有独立的预览版本,方便您在更改上线到实际网站之前进行检查。
  • 使用 Git 构建的静态托管服务(例如 Render 和 Azure Static Web Apps)会使用此连接作为网站代码的来源。

如果无法连接

未显示代码库。 令牌的代码库访问权限未包含该代码库。请在 GitHub 上修改该令牌并添加该代码库。

原先可以使用,随后失效。 细粒度令牌会在您选择的日期到期。请生成新令牌并进行连接;GitHub 会在令牌到期前向您发送电子邮件。

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

已成功连接,但随后某些操作失败。 密钥通过了身份验证,但缺少该操作所需的权限。请使用上述权限创建新密钥,然后断开旧连接并连接新密钥。

断开连接

打开 Integrations,找到该账户并点击 Disconnect。这将立即删除所存储的密钥。任何正在使用该密钥的操作都将在下一次执行时停止,并且依赖该密钥的界面将显示相应提示,而不是静默失败。

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

博客最新动态

我们关于托管、SEO 和大规模网站运营的撰文。

来自托管层的 SEO 与外链建设:2026 年运营商视角

虚拟主机如何在 2026 年影响收录与链接资产传递(link equity):保持页面被有效索引、在建站前严格审查老域名、构建无痕迹(footprint)的外链,以及客观剖析底层基础设施在 SEO 方面的能力与局限。

阅读文章 →

让 WordPress 更快更安全:性能与插件核对清单

打造快速、安全的 WordPress 的实用核对清单:服务器级缓存、按站点设置的对象缓存、少数几个值得运行的插件、保持技术栈最新,以及绝不能进行缓存的 WooCommerce 页面。

阅读文章 →

如何在 2026 年选择托管型网站托管服务:购买者指南

究竟是什么将优质的托管服务与带控制面板的廉价主机区分开来——迁移、备份、隔离、真正的缓存以及诚实的扩展能力——以及如何在您做出决定之前对其进行评估。

阅读文章 →

阅读博客 →

仍需帮助?

每个套餐均包含技术支持,客服团队全天 24 小时在线,您可以用我们支持的任意 58 种语言与我们联系——我们将用您的语言为您解答。

联系支持团队 → 所有文章 →