跳转到主要内容

如何在 Linux 系统上安装 OneKey 应用

更新于今天

本指南以 Ubuntu 22.04.3LTS 系统为例演示安装过程。

方法一:Snap 安装

  1. 安装 snap:sudo apt install snapd

    在其他 Linux 系统上安装 snap,请参阅链接:参考

  2. 以两种方式安装 OneKey 应用:

  3. 下载并安装 bridge(下载链接

  • 下载后,切换到 bridge 所在目录并执行以下命令进行安装:sudo dpkg -i onekey-bridge-2.2.0-amd64.deb

    HC 截图 (2).png
  • 在浏览器中访问地址 http://127.0.0.1:21320/status/,确保页面打开并显示“已连接设备:1”。

    HC 截图模板 (2).png
  • 完成安装。打开 OneKey 应用并选择“连接硬件钱包”。

方法二:直接下载并运行 AppImage

  1. 下载 AppImage 文件。

  2. 使用以下命令安装必要依赖:sudo apt-get install fuse libfuse。(有关依赖及其在不同系统上安装的更多信息,请参阅 链接

  3. 切换到 AppImage 文件所在目录并赋予文件可执行权限:

    chmod +x OneKey-Wallet-4.18.0-linux-x86_64.AppImage

  4. 以当前用户(非 root)运行安装:./OneKey-Wallet-4.18.0-linux-x86_64.AppImage

如果在运行时遇到“缺少 X Server 或 $DISPLAY”的错误,请安装相关图形环境组件。对于 Ubuntu 或 Debian 系统,可以安装 xorg。

Linux Mint 无法检测到硬件设备时的解决方案

在 Linux Mint 系统上使用 OneKey 硬件钱包时,需要安装 UDEV 规则,以便应用能正确连接设备。

  1. 使用 Ctrl + Alt + T 打开终端窗口。

  2. 安装 UDEV 规则(Ubuntu)。

    sudo curl https://data.onekey.so/onekey.rules -o /etc/udev/rules.d/99-onekey.rules

  3. 通知 UDEV 重新加载规则,然后拔下设备并重新插入。

    sudo udevadm control --reload-rules


    不要手动更改 /dev 下设备文件的权限,例如使用 chmodchown
    此类更改是临时的,在重启或重新插入设备后不会保留,放宽权限可能带来安全风险。

这是否解答了您的问题?