适用范围与准备

适用于 GitLab.com、自建或专用实例上的账户要打开两步验证。Free、Premium 和 Ultimate 都有这项。本篇不写服务器配置,也不写 Duo 或 Forti。GitHub 丢了验证器是另一篇。

先区分原因

可用方式包括通行密钥、验证器一次性密码、WebAuthn 设备,以及邮件一次性密码。两步验证打开之后,通行密钥会成为额外的默认选项。通行密钥那一页没有展开。设置了实体设备时,也要再设一次性密码,避免设备丢失后进不去。打开前需要已验证的邮箱,并注册一次性密码、WebAuthn 或邮件一次性密码。一次性密码的路径是头像、编辑个人资料、访问、密码和身份验证、一次性密码验证器、注册验证器。扫描二维码或手动输入,再输入当前密码和六位 PIN。然后下载恢复码。页面提到验证器自带云备份可以降低风险,这里不写某个应用的做法。WebAuthn 要插入实体设备,在同一访问页选择 WebAuthn 设备、注册设备、设置新设备,按浏览器提示按下按钮或传感器,再输入账户密码和设备名称。通过身份提供商登录时可能跳过密码。它默认绑在这台电脑的这个浏览器上。浏览器或设备自己允许其他用法时另说,那些设置不编。第一次设置必须下载恢复码。清除浏览器数据可能失去访问。邮件一次性密码只有实例启用了才有。GitLab 18.7 起在一项功能标志后引入,18.7 在 GitLab.com 启用并在 2026 年逐步放开。19.1 里对应的应用设置默认关闭,功能标志在 19.2 移除。路径是同一访问页、启用邮件一次性密码、当前密码、更新设置。恢复码在一次性密码设置后立刻显示,可以复制、打印,或下载为 gitlab-recovery-codes.txt。每条只用一次。WebAuthn 设备不会生成恢复码。登录时先输入用户名和密码,再选另一种方式。多种方式可以切换。一次性密码画面填六位码并验证,或选择恢复账户再填一条恢复码。WebAuthn 登录在验证安全设备之后的步骤被截断,后面不编。

按顺序操作

  1. 确认邮箱已验证。从头像进入编辑个人资料、访问、密码和身份验证。
  2. 用验证器时注册,扫码或手输,填当前密码和六位 PIN,然后马上保存恢复码。
  3. 用安全密钥时插上再注册,并同时注册一次性密码,避免只剩一把密钥。
  4. 实例开了邮件一次性密码时,在同一页启用并输入当前密码。看不到开关就说明实例没开。
  5. 下次登录先输入密码,再填六位码。手机不在时用一条还没用过的恢复码。

对照

方式恢复材料
一次性密码有恢复码,每条只用一次
WebAuthn不生成恢复码,默认绑这台浏览器
邮件一次性密码只有实例启用才有
通行密钥两步验证打开后成为额外选项
恢复码文件gitlab-recovery-codes.txt

怎样确认有效

退出再登录时,密码之后会出现第二种验证。恢复码文件在你自己保存的位置。

无效时恢复与下一步

没有改网络。清除浏览器数据后,WebAuthn 可能失效,改用一次性密码或恢复码。怎样重置两步验证的另一页没有展开。