Passar para o conteúdo principal

Como instalar o aplicativo OneKey em um sistema Linux

Atualizado hoje

Este guia demonstra o processo de instalação usando o sistema Ubuntu 22.04.3LTS como exemplo.

Método 1: via Snap

  1. Instale o snap: sudo apt install snapd

    Consulte o link para instalar o snap em outros sistemas Linux: Referência

  2. Instale o OneKey App de duas maneiras:

  3. Baixe e instale o bridge (Link para download)

  • Após o download, vá para o diretório onde o bridge está localizado e execute o seguinte comando para instalar: sudo dpkg -i onekey-bridge-2.2.0-amd64.deb

HC Screenshot (2).png
  • Acesse o endereço http://127.0.0.1:21320/status/ no seu navegador para garantir que a página abra e mostre "Dispositivos conectados: 1".

    HC Screenshot Template (2).png
  • Conclua a instalação. Abra o OneKey App e selecione "Conectar Carteira de Hardware".

Método 2: Baixar e executar diretamente o AppImage

  1. Faça o download do arquivo AppImage.

  2. Instale as dependências necessárias com o comando: sudo apt-get install fuse libfuse. (Consulte o link para mais informações sobre dependências e sua instalação em diferentes sistemas)

  3. Vá para o diretório onde o arquivo AppImage está localizado e dê permissão de execução ao arquivo:

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

  4. Execute com o usuário atual (não root): ./OneKey-Wallet-4.18.0-linux-x86_64.AppImage

Se você encontrar o erro "Missing X Server or $DISPLAY" durante a execução, instale os componentes relacionados ao ambiente gráfico. Para sistemas Ubuntu ou Debian, você pode instalar o xorg.

Solução para quando o Linux Mint não detecta dispositivos de hardware

Ao usar uma carteira de hardware OneKey em um sistema Linux Mint, é necessário instalar regras UDEV para que o aplicativo consiga conectar-se corretamente ao dispositivo.

  1. Abra o terminal com Ctrl + Alt + T.

  2. Instale as regras UDEV (Ubuntu).

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

  3. Solicite ao UDEV que recarregue as regras, em seguida desconecte o dispositivo e conecte-o novamente.

    sudo udevadm control --reload-rules


    Não altere manualmente as permissões de arquivos de dispositivo em /dev, como usando chmod ou chown.


    Tais alterações são temporárias e não persistirão após uma reinicialização ou ao reconectar o dispositivo, e afrouxar permissões pode introduzir riscos de segurança.

Respondeu à sua pergunta?