Hub

API docs

Join the Hugging Face community

and get access to the augmented documentation experience

Collaborate on models, datasets and Spaces

Faster examples with accelerated inference

Switch between documentation themes

to get started

双因素身份验证（2FA）

使用双因素身份验证通过两种方法核实用户身份，从而增加额外的安全性，确保即使密码泄露，也只有经过授权的人员才能访问账户。

如果您选择启用双因素身份验证，则每次登录时都需要提供：

用户名或电子邮件地址 & 密码（常规登录凭据）
第二步，使用您的双因素认证方法之一：
- 您的其中一个通行密钥
- 来自身份验证器应用的一次性安全验证码

启用双因素身份验证（2FA）

双重身份验证通过您的身份验证设置中的“双重身份验证”部分进行管理。该部分会列出您的双重身份验证方式（通行密钥和身份验证器应用），并在启用 2FA 后显示您的恢复代码。

要开启双因素身份验证，您首先需要至少一种验证方式：在“通行密钥”部分添加一个通行密钥，或设置身份验证器应用（见下文）。如果您只有通行密钥，请点击“双因素身份验证”部分中的“开启”。设置身份验证器应用会自动开启双因素身份验证。

设置身份验证器应用

要使用一次性密码设置身份验证器应用：

在 Hugging Face Hub 上：

前往您的身份验证设置
在“双因素身份验证”部分，点击“身份验证器应用”旁边的“设置”

在你的设备上（通常是你的手机）：

安装兼容的应用程序。例如：
- Authy
- Google Authenticator
- Microsoft Authenticator
- FreeOTP
在应用中，您可以通过以下两种方式之一添加新条目：
- 使用设备摄像头扫描屏幕上显示的 Hub 代码，即可自动添加该条目
- 输入屏幕上显示的设置密钥以手动添加该条目

在 Hugging Face Hub 中：

在“来自应用的 6 位验证码”中输入来自身份验证设备的六位 PIN 码
保存

如果您输入了正确的 PIN 码且尚未开启双因素身份验证，Hub 将显示一组恢复代码。请下载这些代码并将其保存在安全的地方。

每次登录以及每隔 30 天，系统都会提示您进行 2FA

若要迁移到新的身份验证器应用，请点击“Authenticator app”旁边的“Reset”。若要移除它，请点击“Remove”：仅当您至少拥有一个 passkey 可用作替代的第二步验证时，才允许执行此操作。否则，请关闭双因素身份验证。

使用通行密钥

当启用双因素身份验证时，您的任何通行密钥都可以用作第二步验证。如果您没有身份验证器应用，则无法删除最后一个通行密钥：请先设置身份验证器应用或关闭双因素身份验证。

恢复代码

在成功开启 2FA 后，系统会要求您下载一组生成的恢复代码。如果您将来无法访问您的通行密钥和身份验证器应用，可以使用其中一个恢复代码登录您的账户。

每个验证码只能使用一次来登录您的账户
您应该复制并打印这些代码，或者将其下载并存储在安全的位置。如果您选择下载，该文件名为 huggingface-recovery-codes.txt

如果丢失了恢复代码，或者想要生成新的恢复代码，可以使用身份验证设置页面。

重新生成双因素身份验证恢复代码

要重新生成 2FA 恢复码：

访问您的身份验证设置
如果您已开启 2FA，请在“双因素身份验证”部分中点击“恢复代码”旁边的“查看”
点击重新生成恢复代码

如果您重新生成 2FA 恢复代码，请妥善保存。您无法使用之前创建的任何恢复代码。

使用已启用双因素身份验证的账户登录

当您在启用双因素认证（2FA）的情况下登录时，流程与标准登录步骤仅有细微差别。输入用户名和密码后，您会看到一个额外的提示。根据提示，您可以使用其中一个通行密钥（passkey）、提供一次性密码验证器应用中的 PIN 码，或使用恢复码来完成登录过程。如果您设置了多种验证方式，可以在提示界面中切换它们。

如果您使用通行密钥而非密码登录，则无需进行第二步验证。