Repolode
TheMaxMur

TheMaxMur/RS-Key

开源 Rust 固件,可将约 5 美元的树莓派 RP2350 开发板变成支持 Passkey、SSH、GPG、PIV 和 TOTP 的 USB 安全密钥。

可替代:YubiKey

Star
611
Fork
66
未关闭 Issue
19
最近提交
前天

这是什么?

RS-Key 是一套固件,把 .uf2 文件拷贝到 RP2350 开发板上,电脑就会把它识别为复合 USB 身份验证器。浏览器可以用它注册和登录 Passkey / WebAuthn,ssh 和 git 能用 ed25519-sk 密钥签名,gpg、ykman 以及 PKCS#11 工具可以使用它提供的 OpenPGP 卡、PIV 智能卡、OATH 和 OTP 功能。

项目使用 no_std Rust 编写,定位为低成本、可自托管的硬件安全密钥方案。默认镜像无需焊接,也不需要搭建编译环境。针对不同开发板、闪存容量以及行为差异,提供多种构建版本,包括带屏幕的可信显示版、FIPS 配置,以及实验性的后量子 ML-DSA 支持。

该固件仍处于实验阶段,尚未经过外部安全审计。RP2350 并非安全元件,因此项目文档中列出了威胁模型,并建议在存放重要凭据前,选择性启用 OTP 熔丝和安全启动加固。

核心功能

  • 01支持 Passkey、WebAuthn/U2F 登录,以及 ssh ed25519-sk 密钥
  • 02提供 OpenPGP 卡,用于 gpg 签名、解密和认证
  • 03通过 PKCS#11 或 ykman 使用 PIV 智能卡
  • 04支持 OATH TOTP/HOTP 账户和 Yubico 风格的 OTP 槽位
  • 05可将 FIDO 主种子以 BIP-39 或 SLIP-39 单词备份,并提供设备端审计日志

适用场景

  • 用自行组装的开发板替代商业硬件安全密钥
  • 以较低成本为账户添加 Passkey 或双因素登录
  • 用硬件支持的密钥为 git 提交和 ssh 会话签名
  • 在真实硬件或内置模拟器上学习和测试 FIDO2、OpenPGP、PIV 协议

快速上手

  1. 1

    从发布页面下载最新的 rs-key-<version>-default.uf2 文件

  2. 2

    插入开发板时按住 BOOT 按钮,直到出现 RP2350 磁盘

  3. 3

    将 .uf2 文件复制到 RP2350 磁盘,开发板重启后即作为安全密钥使用

  4. 4

    在 webauthn.io 注册通行密钥,提示触摸时按下 BOOT 按钮

使用前须知

  • 该项目处于实验阶段,尚未经过外部安全审计。
  • RP2350 不是安全元件,不适合保护高价值凭据。
  • 使用 OTP 熔丝和安全启动的生产加固不可逆,操作失误可能导致开发板损坏。
  • 采用 AGPL-3.0 许可证,这是一种较强的 Copyleft 许可证。

标签

常见问题

RS-Key 是什么?
开源 Rust 固件,可将约 5 美元的树莓派 RP2350 开发板变成支持 Passkey、SSH、GPG、PIV 和 TOTP 的 USB 安全密钥。 RS-Key 是一套固件,把 .uf2 文件拷贝到 RP2350 开发板上,电脑就会把它识别为复合 USB 身份验证器。浏览器可以用它注册和登录 Passkey / WebAuthn,ssh 和 git 能用 ed25519-sk 密钥签名,gpg、ykman 以及 PKCS#11 工具可以使用它提供的 OpenPGP 卡、PIV 智能卡、OATH 和 OTP 功能。
RS-Key 可以免费使用吗?用的什么许可证?
RS-Key 以 AGPL-3.0 许可证开源。用于商业产品前,请先确认许可证条款。
RS-Key 还在维护吗?
活跃维护中。RS-Key 最近一次提交是在 2026年10月17日。
RS-Key 适合用来做什么?
用自行组装的开发板替代商业硬件安全密钥 以较低成本为账户添加 Passkey 或双因素登录 用硬件支持的密钥为 git 提交和 ssh 会话签名 在真实硬件或内置模拟器上学习和测试 FIDO2、OpenPGP、PIV 协议
RS-Key 怎么安装和运行?
从发布页面下载最新的 rs-key-<version>-default.uf2 文件 插入开发板时按住 BOOT 按钮,直到出现 RP2350 磁盘 将 .uf2 文件复制到 RP2350 磁盘,开发板重启后即作为安全密钥使用 在 webauthn.io 注册通行密钥,提示触摸时按下 BOOT 按钮
在哪里获取 RS-Key?
源代码和安装说明在 GitHub 上:https://github.com/TheMaxMur/RS-Key

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目