--- title: "PassKey 免密码通行密钥登录" description: "宝塔面板（BT Panel）11.5.0+ 支持的平引入台使用的 PassKey 免密码通行密钥登录指南，认证信息仅存于本地设备；含系统 PIN 码设置、绑定面板可信证书、添加与管理通行密钥的完整步骤。" --- > Documentation Index > Fetch the complete documentation index at: https://docs.bt.cn/llms.txt > Use this file to discover all available pages before exploring further. # PassKey 免密码通行密钥登录 PassKey 是一种现代化的无密码身份认证方式，可以让您无需输入账号密码即可直接登录宝塔面板。认证信息仅存储在本地设备上，安全性更高。 :::info 版本要求 此功能从宝塔面板 11.5.0 版本开始支持。 ::: ## 前置条件 ### 1. 开启电脑 PIN 码 使用 PassKey 前必须先在操作系统中设置 PIN 码。 **Windows 系统设置：** 打开【设置】-【账户】-【登录选项】-【PIN（Windows Hello）】 ![Windows设置PIN](/img/user-guide/config/safe/passkey/image-20260121154016598.png) ![创建PIN码](/img/user-guide/config/safe/passkey/image-20260121154905365.png) :::tip macOS 用户 macOS 用户需要在【系统设置】-【Touch ID 与密码】中设置密码或使用 Touch ID。 ::: ### 2. 面板 SSL 证书要求 PassKey 功能要求面板必须使用**系统可信的证书**，且必须给面板绑定域名，自签名证书不支持此功能。 ![配置商业证书](/img/user-guide/config/safe/passkey/image-20260121160336852.png) ## 配置 PassKey ### 1. 添加通行密钥 进入【设置】-【安全设置】-【PassKey】，点击【添加】按钮。 ![PassKey设置入口](/img/user-guide/config/safe/passkey/image-20260121154748792.png) ![添加PassKey](/img/user-guide/config/safe/passkey/image-20260121160728913.png) ### 2. 验证 PIN 码 系统会提示输入 Windows PIN 码或使用生物识别进行验证。 ![输入PIN码](/img/user-guide/config/safe/passkey/image-20260121160751254.png) ### 3. 完成添加 验证成功后，PassKey 配置完成。 ![添加成功](/img/user-guide/config/safe/passkey/image-20260121160806388.png) ## 使用 PassKey 登录 ### 登录流程 1. 访问面板登录页面，选择 PassKey 登录方式 ![选择PassKey登录](/img/user-guide/config/safe/passkey/image-20260121160859062.png) 2. 系统会弹出身份验证窗口 ![身份验证](/img/user-guide/config/safe/passkey/image-20260121160912629.png) 3. 使用 PIN 码或生物识别完成验证后，自动登录成功 ![登录成功](/img/user-guide/config/safe/passkey/image-20260121160928275.png) ## 特殊说明 :::tip Google 账户用户 如果您使用 Google 账户登录的浏览器，无需单独设置 PIN 码，Google 账户会自动管理 PassKey 凭证。 ::: ## 安全优势 - **无需记忆密码：** 使用生物识别或 PIN 码即可登录 - **本地存储：** 认证信息仅存储在本地设备，不会上传到服务器 - **防钓鱼攻击：** PassKey 与域名绑定，无法在钓鱼网站上使用 - **更高安全性：** 采用公钥加密技术，即使服务器被入侵也无法泄露用户凭证 ## 常见问题 ### 为什么无法添加 PassKey？ 1. 检查面板是否使用可信的 SSL 证书 2. 确认操作系统已设置 PIN 码或启用生物识别 3. 确保浏览器支持 WebAuthn 标准（建议使用最新版 Chrome、Edge 或 Firefox） ### 如何管理多个设备的 PassKey？ 每个设备可以单独添加 PassKey，在【安全设置】-【PassKey】中可以查看和管理所有已添加的设备。 ### 丢失设备后如何处理？ 如果设备丢失，应立即在面板的【安全设置】-【PassKey】中删除该设备的 PassKey，然后使用账号密码重新登录。 Source: https://docs.bt.cn/user-guide/config/safe/passkey/index.mdx