本指南以 Ubuntu 22.04.3LTS 系统为例演示安装过程。
方法一:Snap 安装
安装 snap:
sudo apt install snapd
在其他 Linux 系统上安装 snap,请参阅链接:参考
以两种方式安装 OneKey 应用:
打开链接:https://snapcraft.io/onekey-wallet,并直接从 snap 商店安装。
通过命令行安装:
sudo snap install onekey-wallet
下载并安装 bridge(下载链接)
在浏览器中访问地址 http://127.0.0.1:21320/status/,确保页面打开并显示“已连接设备:1”。
完成安装。打开 OneKey 应用并选择“连接硬件钱包”。
方法二:直接下载并运行 AppImage
如果在运行时遇到“缺少 X Server 或 $DISPLAY”的错误,请安装相关图形环境组件。对于 Ubuntu 或 Debian 系统,可以安装 xorg。
Linux 无法检测到硬件设备时的解决方案
在 Linux Mint 系统上使用 OneKey 硬件钱包时,需要安装 UDEV 规则,以便应用能正确连接设备。
1.前往https://data.onekey.so/onekey.rules,复制UDEV规则
2.在 /etc/udev/rules.d/99-onekey.rules 新建文件,并且将上述规则复制并保存。
3.完成以上后,终端中输入:
sudo udevadm control --reload-rules
不要手动更改 /dev 下设备文件的权限,例如使用 chmod 或 chown。
此类更改是临时的,在重启或重新插入设备后不会保留,放宽权限可能带来安全风险。