Hub documentation
通行密钥
通行密钥
Passkey 允许您使用指纹、面部识别、设备屏幕锁或硬件安全密钥,而非密码,登录 Hugging Face Hub。它们基于 WebAuthn 标准,并且具有抗钓鱼能力,因为 Passkey 仅在其创建的网站上有效。
Passkeys 有两种使用方式:
- 作为登录方式,用于替代您的用户名和密码
- 作为双因素身份验证 (2FA)的第二因素,在您使用密码登录后要求提供
添加通行密钥
- 前往您的 身份验证设置
- 在 Passkeys 部分,点击 添加通行密钥
- 请按照浏览器、设备或密码管理器的提示创建通行密钥
您可以注册多个通行密钥,例如每个设备一个,或者在密码管理器中注册一个并在硬件安全密钥上注册一个。通过密码管理器在您的设备之间同步的通行密钥会带有 Synced 徽章。

通过其组织的身份验证提供商登录的托管账户无法添加通行密钥。
使用通行密钥登录
在 Hub 登录页面 上,点击用户名或邮箱字段。如果您拥有 Hugging Face 的通行密钥,您的浏览器或密码管理器会提示您使用它。选择该密钥并通过您的设备确认,即可在不输入密码的情况下登录。
使用通行密钥登录时,您的设备已验证了您的身份,因此系统不会要求您输入额外的双因素身份验证代码。
使用通行密钥进行双因素身份验证
当启用双重身份验证时,在您使用密码登录后,可以使用您的任何通行密钥作为第二步验证。要通过通行密钥启用此功能:
- 添加至少一个通行密钥
- 前往您的 身份验证设置
- 在 双因素身份验证 部分,点击 开启
Hub 随后会显示一组恢复代码。请下载它们并将其保存在安全的地方。有关更多详细信息,请参阅 恢复代码。
使用密码登录后,系统会要求您使用其中一个通行密钥进行确认。如果您还设置了身份验证器应用,也可以选择使用它,或使用恢复代码。
关闭双重身份验证不会删除您的通行密钥,您仍可使用它们登录。
管理您的通行密钥
在您的 身份验证设置 中的 通行密钥 部分,您可以查看每个通行密钥的添加时间和最后使用时间,并且:
- 重命名通行密钥以便更轻松地识别
- 删除通行密钥。您将无法再使用它登录。
如果已启用双因素身份验证且您没有身份验证器应用,则必须先设置身份验证器应用或关闭双因素身份验证,才能移除您的最后一个通行密钥。
从 Hub 中移除通行密钥后,它可能仍存储在你的设备或密码管理器中。你也可以在那里将其删除。
Update on GitHub