跳到正文
Novaz Authenticator获取

Bitbucket 2FA：如何设置身份验证器 App

作者：Novaz 团队 · 更新于 2026年11月5日
Novaz 操作步骤已在 1.0.5 版本中核实

本文译自英文指南。在服务的网站上，按钮和菜单的中文名称可能略有不同。

本页内容
  1. 开始之前：SSH 和密码
  2. 使用身份验证器 App 开启 2FA
  3. 六个恢复码
  4. 如果 Bitbucket 不接受你的验证码
  5. 换到新手机
  6. 如果丢失了身份验证器
  7. 关闭 2FA
  8. Bitbucket 和 Atlassian 官方帮助

Bitbucket Cloud 是 Atlassian 在 bitbucket.org 上提供的 Git 托管服务，使用 Atlassian 账号登录（Bitbucket），但它的两步验证是一项单独的设置。Atlassian 介绍了两道验证，一道针对账号，一道针对 Bitbucket。如果两者都开启，你可能会连续遇到两次验证码提示，而且一方的验证码无法通过另一方的验证（Atlassian）。

本文介绍的是 Bitbucket 自己的设置，它支持基于时间（TOTP）的身份验证器 App 或 FIDO U2F 安全密钥。它的帮助页面没有提到短信（Bitbucket）。它是可选的，除非某个 Bitbucket Premium 工作区要求你先开启才能访问其私有仓库（Bitbucket）。账号层面的验证请参阅 Atlassian 的两步验证帮助。

步骤中使用 iPhone 上的 Authenticator App - Novaz；其他身份验证器 App 的操作大致相同。

我们如何核实本指南： Bitbucket 的步骤来自 Atlassian 官方的 Bitbucket Cloud 帮助页面、知识库文章和开发者更新日志（链接见下文），我们于 2026 年 10 月 20 日查阅。我们没有在 Bitbucket 账号上实际测试，因此个别标签可能略有不同。Novaz 的步骤已在 1.0.5 版 App 中核对。

开始之前：SSH 和密码

Bitbucket 列出了以下要求（Bitbucket）：

  • 账号上有 SSH 密钥。 开启两步验证后，Git 的远程操作应通过 SSH 进行，所以请先切换你的远程仓库地址、Git 客户端和构建工具。
  • 已确认的电子邮件地址和 Atlassian 账号密码。 还没有密码？Bitbucket 建议通过密码找回设置一个，然后重新登录。

两步验证页面仍然建议在 HTTPS 和 API 中使用应用密码（app password），但 Bitbucket 的更新日志已计划在 2026 年 7 月 28 日完全弃用它们（Bitbucket）。取而代之的 API 令牌不要求开启两步验证（Bitbucket）。

使用身份验证器 App 开启 2FA

  1. 在 Bitbucket 中，选择 Settings（设置）齿轮图标，然后选择 Personal Bitbucket settings（个人 Bitbucket 设置）（Bitbucket）。
  2. 在 Security（安全）下，选择 Two-step verification（两步验证）。直接访问地址是 bitbucket.org/account/settings/two-step-verification/manage（Bitbucket）。
  3. 查看要求，输入你的 Atlassian 账号密码，然后选择 Set up two-step verification（设置两步验证）。
  4. 出现二维码时，在 Novaz 中点按 +，选择 扫描二维码，将相机对准二维码。如果是在同一台 iPhone 上，先截屏，然后改用 选择照片。参阅在同一台 iPhone 上扫描二维码。
  5. 如果扫描失败，Bitbucket 的 Account（账号）和 Key（密钥）字段包含同样的信息。在 Novaz 中点按 +，然后点按 手动输入密钥，在 服务 中输入 Bitbucket，并把 Key 粘贴到 设置密钥。参阅什么是 2FA 设置密钥？
  6. 将 Novaz 中当前的验证码输入 Verification code（验证码）。
  7. 下载或抄下你的恢复码。

验证码为 6 位（Bitbucket），但没有任何页面给出间隔，而在 Novaz 中手动输入的密钥始终生成 30 秒验证码，所以能扫描就尽量扫描。此后，每次登录都会要求你在 Verification code 中输入验证码，然后点击 Verify（验证）。Bitbucket 没有提到记住设备。

六个恢复码

你会得到 6 个恢复码，每个只能用一次，使用时像 App 验证码一样输入 Verification code。请至少保留两个未用的：Bitbucket 要求用两个恢复码才能生成新的恢复码或关闭两步验证。在 Two-step verification 页面上点击 Show recovery codes（显示恢复码）即可查看；6 个全部用完后，在该页面选择 Can't find codes?（找不到恢复码？）（Bitbucket）。

如果你丢了 iPhone，而又没有 Novaz 备份，或者只有添加 Bitbucket 之前的备份，这些恢复码就是你重新登录的途径。请把它们存放在手机以外的地方。详见2FA 备用码。

如果 Bitbucket 不接受你的验证码

Bitbucket 帮助中心建议进行以下检查（Bitbucket，Bitbucket）：

  • 把数字连在一起输入，中间不加空格。
  • 看对条目。如果同时开启了 Atlassian 账号验证，你会有两个条目，而且它们不能互换。
  • 不要重复使用恢复码。
  • 校准时钟：30 到 60 秒的偏差就会让验证码失效。在 iPhone 上，开启 设置 › 通用 › 日期与时间 › 自动设置；如果已经开启，就关闭后再打开，然后等待新的验证码。时钟偏差达到 15 秒或以上时，Novaz 会发出提醒。

仍然不行？使用恢复码，并参阅身份验证器验证码无效？

换到新手机

Bitbucket 的做法是关闭两步验证后重新开启（Bitbucket）。趁旧手机还能用时，打开 Two-step verification，输入旧手机上的验证码或一个恢复码，选择 Disable two-step verification（停用两步验证），然后用新手机重新设置，并保存新的恢复码。

在 Novaz 中，iCloud 备份或备份文件可以在新 iPhone 上恢复你的账号，验证码会继续有效，无需上述操作。如果没有备份，每个账号都要在新 iPhone 上从头添加。参阅如何把身份验证器 App 转移到新 iPhone。

如果丢失了身份验证器

先用恢复码。Bitbucket 还提到可以通过 SSH 获取恢复码，但没有给出步骤。

如果恢复码已经用完，一篇 2026 年 3 月的知识库文章介绍了通过电子邮件恢复的方法（Atlassian）：

  1. 在要求输入验证码时，选择 Forgot code（忘记验证码），然后选择 Send recovery email（发送恢复邮件）。主帮助页面把这一项称为 Can't find codes?，所以标签可能不同。
  2. 第一封邮件只是让你等待。24 小时后，第二封邮件会带来一个一次性登录链接（请检查垃圾邮件）。
  3. 该链接 24 小时后失效，点击后会在关闭两步验证的状态下让你登录。请重新设置。

等待时间无法缩短：“Atlassian cannot disable two-step verification for any Bitbucket user account”（Atlassian 无法为任何 Bitbucket 用户账号关闭两步验证）（Bitbucket）。如果邮件方式失败，文章建议提交 Atlassian 支持工单。

如果你的 Atlassian 账号也开启了两步验证，请先用它的 24 位字符紧急恢复密钥解除那一层验证。详见丢了装有身份验证器 App 的手机？

关闭 2FA

在 Two-step verification 中，输入 App 验证码或恢复码，选择 Disable two-step verification，然后点击 Disable（停用）确认（Bitbucket）。如果你在自己管理的内容上要求两步验证，请先在 Access controls（访问控制）下取消勾选 Require two-step verification（要求两步验证）（Bitbucket）。之后，用 移除账号 从 Novaz 中删除 Bitbucket 条目。

Bitbucket 和 Atlassian 官方帮助

更多指南：开发者工具