本指南以 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 Mint 无法检测到硬件设备时的解决方案
在 Linux Mint 系统上使用 OneKey 硬件钱包时,需要安装 UDEV 规则,以便应用能正确连接设备。
使用 Ctrl + Alt + T 打开终端窗口。
安装 UDEV 规则(Ubuntu)。
sudo curl https://data.onekey.so/onekey.rules -o /etc/udev/rules.d/99-onekey.rules
通知 UDEV 重新加载规则,然后拔下设备并重新插入。
sudo udevadm control --reload-rules
不要手动更改 /dev 下设备文件的权限,例如使用 chmod 或 chown。
此类更改是临时的,在重启或重新插入设备后不会保留,放宽权限可能带来安全风险。