GitLab 账户指南

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

GitLab.com 和自托管实例均支持身份验证器验证码。在开始之前请验证你的账户邮箱,如果你的组织托管了自己的实例,请使用该组织的 GitLab 地址。

添加身份验证器

  1. 打开你的头像菜单并选择 Edit profile(编辑个人资料)。
  2. 选择 Access(访问权限)→ Password and authentication(密码与身份验证)。
  3. 在 One-time password authenticator(一次性密码身份验证器)下,选择 Register authenticator(添加身份验证器)。

将 GitLab 添加到 Sign In

你可以使用 Sign In,这是我们开发的 iPhone 身份验证器应用,可在设备上生成验证码。

  1. 在另一块屏幕上显示设置二维码,打开 Sign In 并轻点 Add(添加)→ Scan QR Code(扫描二维码)。
  2. 扫描二维码,核对账户详细信息,然后轻点 Add Account(添加账户)。
  3. 在 GitLab 中输入你当前的密码和六位验证码,然后选择 Register with two-factor app(使用两步验证应用完成设置)。下载你的恢复码。

GitLab 提供了用于手动输入的两步验证设置详情以及二维码。在 Sign In 中,选择 Add(添加)→ Enter Setup Key(输入设置密钥),将 Service(服务)设置为 GitLab,Account(账户)设置为你的账户名,将密钥粘贴到 Key(密钥)中,然后轻点 Add Account(添加账户)。请妥善保管此密钥,不要泄露。

保存恢复码

将 gitlab-recovery-codes.txt 安全地保存在手机以外的地方。每个恢复码只能使用一次。在身份验证器提示处,选择 Recover your account(恢复你的账户)来使用其中一个。

如果无法使用这些恢复码,请查阅适用于你实例的 GitLab 恢复说明。请在更换手机前准备好恢复方案。

Git 与组织要求

启用双重认证后,通过 HTTPS 使用 Git 或访问 GitLab API 时,请用个人访问令牌(personal access token)代替账户密码。群组或实例策略可能强制要求开启双重认证。兼容的 WebAuthn 设备可提供另一种验证选项。

如果验证码无效

确认 Sign In 中选择的 GitLab 账户与你要登录的账户一致。等待新的验证码生成,并在它更新前输入。如果仍然验证失败,请检查 iPhone 的日期与时间是否设为自动设置。

排查问题时,请保留已经登录的设备,不要退出登录,并妥善保管账户恢复信息。仅在 Sign In 中添加账户并不代表设置完成:还需要 GitLab 验证通过,并确认两步验证已启用。

官方帮助