Appwrite 2FA：如何为 Console 账号设置身份验证器 App
作者：Novaz 团队 · 更新于 2026年11月5日
Novaz 操作步骤已在 1.0.5 版本中核实
本文译自英文指南。在服务的网站上，按钮和菜单的中文名称可能略有不同。
Appwrite 有两种多重身份验证（MFA），很容易找错页面。一种是你为自己 App 的用户构建的功能。另一种保护你自己的开发者账号，也就是你用来登录 Appwrite Console、管理组织和项目的账号。本指南讲的是第二种（Appwrite）。如果你想为 App 的用户提供 MFA，Appwrite 在它的 Auth 文档中另有介绍。
对你的 Console 账号来说，MFA 是可选的。Appwrite 的文档将身份验证器 App 生成的基于时间的验证码（TOTP）列为支持的方式，并表示以后会增加更多验证因素（Appwrite）。下面的步骤以 iPhone 上的 Authenticator App - Novaz 为例，其他身份验证器 App 的操作也一样。
我们如何核实本指南： Appwrite 的步骤来自 Appwrite 官方文档及其截图（链接见下文），我们于 2026 年 10 月 21 日查阅。我们没有在 Appwrite 账号上实际测试，因此个别标签可能略有不同。Novaz 的步骤已在 1.0.5 版 App 中核对。
使用身份验证器 App 开启 MFA
Appwrite 的页面很简短，文字和截图使用的标签也略有不同。以下步骤同时参照了两者（Appwrite）：
- 登录 Appwrite Console。打开右上角的账号菜单，选择 Your account（你的账号）。
- 进入安全设置。在 Appwrite 的截图中，这是左侧列表里的 Security（安全），页面上有一张 Multi-factor authentication（多重身份验证）卡片。
- 打开 Multi-factor authentication 开关。
- 添加身份验证器。文字中把按钮称为 Add authentication factor（添加验证因素）；截图中显示的是 Authenticator app（身份验证器 App）一行，带有 Add（添加）按钮。
- 一个 Scan QR code（扫描二维码）窗口随即打开。在 Novaz 中点按 +，然后点按 扫描二维码，将相机对准二维码。如果 Console 就在这台 iPhone 上打开，先截屏，再改用 选择照片。参阅在同一台 iPhone 上扫描二维码。
- 如果无法扫描，同一窗口会显示 Manual entry code（手动输入码），旁边有复制按钮。在 Novaz 中点按 +，然后点按 手动输入密钥，在 服务 中输入一个名称（例如 Appwrite），并把这个码粘贴到 设置密钥。参阅什么是 2FA 设置密钥？
- 选择 Continue（继续），输入 Novaz 当前的验证码完成设置。
- 保存你的恢复码（见下一节）。
文档没有说明验证码有几位，也没有说明多久更换一次。扫描二维码更稳妥，因为二维码会把这些设置交给你的 App。手动输入的密钥会每 30 秒生成 6 位验证码。
恢复码是你唯一的恢复途径
Appwrite 在这一点上说得格外直白。它的文档称恢复码是“the only way to access your account if you lose access to your authenticator app”（无法使用身份验证器 App 时访问账号的唯一途径）（Appwrite）。对于被锁定的 Console 账号，它没有介绍任何支持途径。
截图显示，同一设置页面上有一行 Recovery codes（恢复码），带有 View（查看）按钮，所以只要还在登录状态，你就可以再次查看。请在手机以外的地方保存一份副本，例如密码管理器或打印件。如果你没有 Novaz 备份，或者备份早于你的 Appwrite 账号，这些恢复码就是你的恢复途径。详见2FA 备用码。
同一张截图还把 Email（电子邮件）列为一种验证因素，一次性验证码会发送到账号已验证的地址。页面文字只提到了身份验证器 App，所以仅凭文档，我们无法告诉你登录时电子邮件验证码能否作为后备。
如果 Appwrite 不接受你的验证码
Appwrite 的文档没有讲到验证码被拒的情况。最常见的原因是 iPhone 的时钟：打开 设置 › 通用 › 日期与时间，开启 自动设置。时钟偏差达到 15 秒或以上时，Novaz 也会提醒你。如果你是手动输入的密钥，请检查是否完整复制。其他原因见身份验证器验证码无效？
更换手机
Appwrite 没有说明如何把 MFA 转移到新手机、如何更换身份验证器，也没有说明如何关闭 MFA。无论做哪一项，都请趁还能用旧手机登录时，在同一张 Multi-factor authentication 卡片中操作。如果你开启了 Novaz 的 iCloud 备份或导出了备份文件，可以在新手机上恢复 Appwrite；没有的话，就要在新手机上把它作为新账号添加。参阅如何把身份验证器 App 转移到新 iPhone。
如果丢失了身份验证器
用一个恢复码登录，然后在新手机上重新设置身份验证器。如果没有恢复码，Appwrite 的文档没有提供其他重新登录账号的途径。详见丢了装有身份验证器 App 的手机？
Appwrite 官方帮助
- Multi-factor authentication（你的 Console 账号）
- Multi-factor authentication（Appwrite Auth，面向你 App 的用户）
- Security
