GitHub 账户指南

如何设置 GitHub 两步验证(2FA)

为 GitHub 账户增加一道登录验证。本指南适用于个人账户,介绍如何用 Sign In 生成验证码,以及手机无法使用时如何恢复访问。

在开始之前

开始前,请确保能登录 GitHub 账户、手边有 iPhone,并准备好安全保存恢复码的位置。企业托管用户(Enterprise Managed Users)通常通过组织的身份提供商登录,请向管理员咨询相应的设置方法。

打开 GitHub 的双重认证设置

  1. 在浏览器中打开 GitHub 并登录。
  2. 点击你的个人资料头像,打开设置 (Settings) → 密码和身份验证 (Password and authentication)。
  3. 选择启用双重认证 (Enable two-factor authentication)。按照下文将账户添加到 Sign In 时,请保持二维码设置页面处于打开状态。

打开 GitHub 安全设置 →

将 GitHub 添加到 Sign In

为了在 iPhone 上获取验证码,我们推荐使用我们的身份验证器应用 Sign In。它会在你的设备上生成验证码。

  1. 如果 GitHub 的二维码在另一块屏幕上,请在 Sign In 中选择Add → Scan QR Code(添加→扫描二维码)并进行扫描。
  2. 若要在单台 iPhone 上设置,请在 GitHub 上选择设置密钥 (setup key)。在 Sign In 中,选择Add → Enter Setup Key(添加→输入设置密钥)。输入 GitHub 作为服务 (Service),你的用户名作为账户 (Account),并将密钥粘贴到密钥 (Key) 中。
  3. 检查详情并点击Add Account(添加账户)。
  4. 返回 GitHub,使用来自 Sign In 的当前六位验证码进行确认。
  5. 下载你的恢复码,妥善保管,并确认你已保存它们以完成双重认证的启用。

请对设置密钥保密。仅在 Sign In 中添加账户并不代表 GitHub 的两步验证已启用。

其他支持的方法

在通过身份验证器生成的验证码或短信完成初次设置后,GitHub 还提供其他选项:通行密钥、硬件安全密钥以及GitHub 自带的手机端登录确认。通行密钥和安全密钥提供输入验证码所不具备的网络钓鱼防护能力。

短信仅在支持的国家/地区可用,并可能受到你所在组织的限制。选择备用验证方式时,请考虑短信可能无法送达,以及手机号被盗用的风险。

保存恢复码

将恢复码保存在即使手机丢失也能访问的地方。每个代码仅可使用一次。在设置 (Settings) → 密码和身份验证 (Password and authentication) 中,选择恢复码旁边的查看 (View) 以再次保存它们。生成新的一组代码将使旧的一组失效。

完成设置后,请完成一次带有双重认证的登录,并确认你的备用验证方式可用。避免将所有恢复选项放在同一台设备上。

如果你无法登录,请尝试使用保存的恢复码或先前配置的替代方案。GitHub 的账户恢复说明介绍了其他符合条件的恢复选项。当所有身份验证和恢复选项都丢失时,支持团队无法简单地移除双重认证。

如果验证码被拒绝

  • 检查你在 Sign In 中是否选择了正确的 GitHub 用户名。GitHub 不会通过短信发送身份验证器生成的验证码。
  • 等待获取新验证码并及时输入,不要带有空格。
  • 检查你的 iPhone 日期和时间是否设置为自动获取。
  • 如果恢复码失败,请使用最新一组中未使用的代码。先前使用过或已被替换的代码将无法生效。

GitHub 官方帮助

官方文档核对日期:2026 年 10 月 8 日。