YubiKey-Guide：把 GnuPG 和 SSH 密钥锁进硬件，但别跳过离线环境

它解决的是私钥被复制的问题

普通 GnuPG 和 SSH 密钥存在磁盘上，一旦系统被入侵，私钥文件就可能被读取。YubiKey-Guide 的核心思路是把私钥写入 YubiKey 的 OpenPGP 应用，设备本身不允许导出私钥。文档明确写着：私钥无法从设备中复制出来，单独的离线 Certify 密钥只用于替换或续期。这意味着即使你登录的机器完全被控制，攻击者也只能看到公钥和签名结果，拿不到私钥本体。这份指南面向的是愿意接受操作复杂度的人，通常是处理代码签名、服务器登录或加密通信的工程师。它解决的问题很具体：如何在硬件上建立可信的密钥根，同时保留日后更换密钥的能力。

离线环境是整个流程的基石

指南把密钥生成环境按安全性从低到高排了七个等级，从公共电脑一直到无网络的 ARM 设备。它明确建议大多数人在个人电脑上用 Debian Live USB 启动，不挂载主存储。这个要求不是可选的，因为 Certify 主密钥一旦生成，就必须永远离线保存。指南给出的命令是下载 Debian Live 镜像、验证签名、用 dd 写入 U 盘，然后从 U 盘启动。它甚至警告 dd 命令会擦除目标设备，要求先检查设备路径。这种对环境的执着是这份指南与大多数快速教程的本质区别，它不假设你信任自己的日常系统。如果你跳过这一步，私钥生成过程暴露在联网系统里，硬件保护的意义就打了折扣。

从 Certify 密钥到三个子密钥的架构

指南的密钥结构是生成一个离线 Certify 主密钥，再创建三个子密钥，分别用于签名、加密和认证。签名子密钥写入 YubiKey 的签名槽位，加密子密钥写入加密槽位，认证子密钥写入认证槽位。Certify 主密钥只用来签发和续期子密钥，从不进入 YubiKey。这样做的好处是，如果 YubiKey 丢失，你可以用离线主密钥重新签发新的子密钥，而不是失去整个身份。指南中包含了具体的 gpg 命令，比如用 --quick-generate-key 创建主密钥，用 --quick-add-key 添加子密钥，然后通过 --key-edit 的 keytocard 命令把子密钥传输到设备。整个流程在文档中按步骤展开，每一步都有对应的命令和预期输出。这种设计把密钥的生命周期管理从单点故障中解放出来，但也要求你妥善保管离线介质。

PIN 和触摸策略是日常使用的摩擦点

YubiKey 的 OpenPGP 应用有独立的 PIN，默认值通常是 123456，指南要求你立即修改。它还允许设置强制触摸标志，让每次签名或认证操作都需要物理接触密钥。这意味着每次 git commit 签名或 SSH 登录，你都要伸手碰一下 YubiKey。指南在配置触摸一节给出了具体命令，比如 gpg --card-edit 然后设置 forcesig 属性。这个设计是安全与便利的权衡，强制触摸能防止远程恶意软件在你不注意时调用密钥，但也让自动化脚本变得麻烦。如果你经常在 CI 环境或无人值守服务器上使用密钥，这种交互式触摸会成为一个实际障碍。文档没有回避这一点，它把触摸配置作为可选项，而不是默认推荐。

SSH 和 GitHub 的接入方式

指南把 SSH 使用分成两条路径：替换系统自带的 ssh-agent，或者直接使用 GnuPG 的 gpg-agent 作为 SSH agent。它详细说明了如何设置 SSH_AUTH_SOCK 环境变量指向 S.gpg-agent.ssh 套接字，以及如何用 ssh-add 导入公钥。对于 GitHub，它给出了添加认证子密钥公钥到账户的步骤。文档还覆盖了 SSH agent 转发和 GnuPG agent 转发，包括链式转发的场景。这些内容对日常使用很实用，但实现起来比单纯的 ssh-keygen 复杂得多。你需要理解 agent 的通信机制，否则转发失败时很难排查。指南的 troubleshooting 部分列出了一些常见问题，比如 PIN 输入错误导致的锁定，以及如何用 gpg --card-status 检查设备状态。

更新和轮换子密钥的长期维护

子密钥有有效期，到期后需要续期或轮换。指南区分了两种操作：续期只延长现有子密钥的有效期，不需要触碰 YubiKey；轮换则是生成新的子密钥并重新传输到设备。续期可以用离线 Certify 密钥签发，然后导入 YubiKey 上的公钥部分。轮换则需要重新执行子密钥生成和传输流程。文档还提供了重置 YubiKey 的方法，用于彻底清空设备，但这会删除所有密钥，只能作为最后手段。这些操作意味着你必须在 YubiKey 的整个生命周期内保存好离线主密钥和备份介质，否则到期后无法续期，只能重新建立整个身份。指南没有美化这一点，它明确要求备份密钥，并且建议把备份存放在不同物理位置。

局限性和替代方案的边界

这份指南最大的限制是它假设你有足够的时间和纪律去执行完整的离线流程。对于只是想保护个人 SSH 密钥的开发者，使用 YubiKey 的 FIDO2 功能或者 Yubico 官方的 SSH 指南会更直接，后者不需要生成 GnuPG 主密钥，也不需要离线环境。另一个替代方案是使用只支持 OpenPGP 的硬件，比如 Nitrokey，但它的流程和此指南不兼容。指南在 Alternative solutions 一节提到了这些选项，但没有深入比较。如果你选择 YubiKey-Guide 的路线，需要接受以下成本：每次操作都要触摸密钥，密钥续期依赖离线介质，以及学习 GnuPG 的复杂命令。文档还提醒，YubiKey Security Key 和 Bio 型号不支持 OpenPGP，购买前必须确认型号。这些边界在 README 里写得很清楚，但容易被忽略。

编辑结论

如果你愿意花半天时间准备一个离线 Debian Live 环境，并且能接受命令行操作，YubiKey-Guide 是目前把 GnuPG 和 SSH 密钥固化到硬件的最详尽路线图。它适合安全敏感的开发者和运维人员，不适合只想把 SSH 密钥塞进 YubiKey 的普通用户，后者应该去看 Yubico 官方的 SSH 指南或使用 FIDO2 的 sk-ssh-ed25519 方案。采用前先验证三件事：你的 YubiKey 型号是否支持 OpenPGP 应用，因为 Security Key 和 Bio 系列不支持；你是否有两个以上物理介质存放加密备份；你是否愿意在每次签名或加密时触摸密钥，因为默认配置下这是强制动作。这份指南不承诺快速，它承诺的是可审计的流程，但所有安全承诺都建立在执行者严格遵循离线步骤的基础上。

官方来源

1. Official documentation
2. Official README
3. Project repository