开始之前

最后会得到什么

一个你亲手组装的小型硬件钱包：树莓派 Zero 2 W 上面插一块带摇杆的 1.3 寸屏幕。它运行 OneKey Classic 的开源固件，用一根 USB 线连接电脑。

电脑上用的是 OneKey 桌面版 App，同样由你从源码编译。App 负责显示余额、准备交易；设备保管你的私钥，把你要签名的内容显示在屏幕上，你按下按键后它才会签名。

为什么要自己做

买来的钱包要经过工厂、仓库和快递才到你手上。大多数人选择信任这条链路。如果你不想依赖这种信任，可以用通用零件自己做一个。这些零件每年卖出几百万件，用在别的地方。设备上的所有软件也都由你自己装。

上面没有任何看不见内部的东西。固件和 App 都来自公开的源码，你下载下来，可以逐行查看，在自己的电脑上编译。

它做不到什么

存钱之前，请先把这几条看清楚。

• 固件版本较旧。 教程使用 2025 年 6 月的 OneKey Classic 固件 3.12.0，因为这是目前能编译到树莓派这类电脑上的最新版本。现在出售的 Classic 设备运行的是更新的固件。
• OneKey App 会提示设备不是正品。 这是对的，它确实不是 OneKey 生产的。你自己编译的 App 会跳过这项检查。
• 只能用 USB 连接。 没有蓝牙，不支持手机 App。
• 出了问题自己负责。 没有客服。先放小额资金，在完整测试过恢复之前，不要放大额。

需要准备什么

• 下一页列出的零件，总共大约 38 到 57 美元。
• 一台 macOS 或 Linux 电脑，16 GB 内存，30 GB 左右空闲硬盘空间。编译 App 是最吃资源的一步。（Windows 电脑可以完成树莓派上的所有步骤，但目前编译不了 App。）
• 设置过程中需要联网。做好之后的设备永远不联网。
• 纸和笔，用来抄写助记词。
• 大约 5 个小时，可以分一两天做完。大部分时间是在等下载和编译。

不需要会焊接，也不需要会编程。每条命令都写在页面上，旁边有复制按钮。会复制、粘贴、按回车，就能做出来。

先选好选项

开始之前，先在我的配置里选好选项。每一步里的命令都会跟着你的选择变化。