永别密码登录NodeWarden Passkey 无密码登录完整指南WebAuthn/FIDO2 设置与跨设备同步【免费下载链接】nodewardenBitwarden-compatible server running on Cloudflare Workers项目地址: https://gitcode.com/gh_mirrors/no/nodewardenNodeWarden 是一款运行在 Cloudflare Workers 上的 Bitwarden 兼容自托管密码库服务器它内置了Passkey通行密钥无密码登录能力。通过 WebAuthn/FIDO2 标准你可以用指纹、人脸或设备 PIN 一步登录并解锁整个密码库彻底告别主密码。本文将带你完成 Passkey 的设置、启用免密直解并实现跨设备同步登录。Passkey 登录是什么和主密码有什么区别传统登录流程是输邮箱 → 输主密码 → 输 TOTP三步。启用 Passkey 后流程变成打开登录页点击 Passkey 登录系统弹出生物识别指纹/面容或设备 PIN 确认验证通过 → 直接拿到登录令牌⚠️ 注意区分 NodeWarden 中的两种 Passkey类型用途数量上限账号通行密钥Account Passkey替代主密码登录可配合 PRF 免密解锁保险库5 个两步验证 Passkey作为 2FA 第二因素替代 TOTP5 个服务端基于 FIDO2 协议生成一次性 challenge并在验证通过后消费该 challenge防止重放攻击核心实现在 src/handlers/account-passkeys.ts。如何创建账号通行密钥Passkey 设置步骤登录 Web Vault进入安全设备Security Devices页面相关界面代码见 webapp/src/components/SecurityDevicesPage.tsx在账号通行密钥区域点击添加输入主密码确认身份Passkey 创建仍需一次主密码验证为这个 Passkey 命名例如我的 iPhone便于日后识别按提示完成指纹/面容/PIN 认证保存成功创建时服务端会强制要求residentKey: required与userVerification: required——前者让 Passkey 成为可发现凭证是跨设备同步的关键后者确保每次使用都有生物识别。前端注册逻辑封装在 webapp/src/lib/account-passkeys.ts 中。启用直接解锁连主密码都不用输PRF 直解这是 NodeWarden Passkey 最有价值的功能Passkey 直接解锁保险库Direct Unlock。原理是利用 FIDO2 的PRF伪随机函数扩展注册时客户端会生成一组加密密钥并用 PRF 输出加密后随凭证存储登录时 Passkey 验证产生同样的 PRF 输出本地即可解密保险库密钥全程无需键盘输入主密码。若设备支持 PRF创建 Passkey 时会自动启用直解提示通行密钥已保存可直接解锁若当时未启用可在 Passkey 列表中对该条目点击启用直接解锁用一次生物识别即可补开对应的前端动作封装在 webapp/src/hooks/useAccountSecurityActions.ts。 登录时若 Passkey 不支持 PRF系统会自动降级为Passkey 登录 主密码解锁的混合模式不会卡住你。如何把 Passkey 用作两步验证第二因素习惯双因素安全可以把 Passkey 作为 2FA在安全设备页找到两步验证 Passkey区域输入主密码后添加命名例如家用的 YubiKey之后登录第二步骤即可用指纹代替输入 6 位 TOTP⚠️ 建议至少保留一个 2FA 备份方式如恢复码服务端在启用时会为你生成一次性恢复码相关流程见 src/handlers/account-passkeys.ts。Passkey 跨设备同步为什么它能跟着账号走很多人误以为 Passkey 只绑在一台设备上——其实不是Passkey 的钥匙存在你的平台密码管理器里Google 密码管理器、Apple iCloud 钥匙串、Android/Windows 凭据等钥匙孔存在 NodeWarden 服务端D1 数据库存储层见 src/services/storage-account-passkey-repo.ts由于 NodeWarden 要求注册可发现凭证Passkey 与你的账号邮箱绑定。当你的密码管理器在另一台设备同步凭据后新设备上直接点 Passkey 登录服务端即可通过 credentialId 认出你典型场景iPhone 上创建的 Passkey同步到 iPad 或 Mac 后无需重新注册即可登录 特殊环境非标准 HTTPS 页面、移动连接器可配合项目自带的 WebAuthn 连接页使用如 webapp/public/webauthn-connector.html 与 webapp/public/webauthn-mobile-connector.html其连通性测试见 scripts/webauthn-connector.test.mjs。管理 Passkey查看、删除与安全审计查看安全设备页列出所有账号 Passkey 与 2FA PasskeyAPI 见 src/handlers/account-passkeys.ts删除删除需再次输入主密码2FA Passkey 至少保留 1 个不可删光上限账号 Passkey 与 2FA Passkey 各 5 个审计每次创建、启用直解、删除都会写入审计日志account.passkey.create等事件可在日志中心追溯常见问题FAQQ1忘了主密码还能用 Passkey 登录吗若 Passkey 启用了 PRF 直解——可以这正是它的意义。若只有仅登录型 Passkey则仍需主密码解锁。Q2Passkey 登录被锁定的账号会怎样服务端会明确拒绝并提示Passkey 不属于已锁定账号见 webapp/src/lib/app-auth.ts。Q3换手机后 Passkey 会失效吗只要旧设备上的密码管理器完成云同步如 iCloud 钥匙串/Google 密码管理器Passkey 可在新设备直接使用未同步的 Passkey 则需在安全设备页删除后重建。Q4Passkey 和 YubiKey 能同时用吗可以。YubiKey 既可注册为 Passkey硬件安全密钥也可作传统 OTP 第二因素二者并存不冲突。小结NodeWarden 的 Passkey 无密码登录把输入主密码彻底变成看一眼面容PRF 直解进一步省掉最后一次键盘输入跨设备同步让 Passkey 跟着账号而不是设备走。建议组合使用账号 Passkey直解用于日常 Passkey/TOTP 作为 2FA即可在安全性和便捷性之间取得最佳平衡。【免费下载链接】nodewardenBitwarden-compatible server running on Cloudflare Workers项目地址: https://gitcode.com/gh_mirrors/no/nodewarden创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考