이 가이드는 Ubuntu 22.04.3LTS 시스템을 예로 들어 설치 과정을 설명합니다.
방법 1: Snap 방법
snap 설치:
sudo apt install snapd다른 Linux 배포판에서 snap을 설치하는 방법은 다음 링크를 참조하세요: 참고
OneKey 앱을 두 가지 방법으로 설치할 수 있습니다:
다음 링크를 열어 snap 스토어에서 직접 설치하세요: https://snapcraft.io/onekey-wallet
명령줄로 설치:
sudo snap install onekey-wallet
bridge를 다운로드하고 설치합니다 (다운로드 링크)
다운로드한 후 bridge가 있는 디렉터리로 이동하여 다음 명령을 실행해 설치하세요:
sudo dpkg -i onekey-bridge-2.2.0-amd64.deb
브라우저에서 http://127.0.0.1:21320/status/ 주소에 접속하여 페이지가 열리고 "Connected devices: 1"로 표시되는지 확인하세요.
설치를 완료합니다. OneKey 앱을 열고 "Connect Hardware Wallet"을 선택하세요.
방법 2: AppImage 파일 직접 다운로드 및 실행
필요한 의존성을 다음 명령으로 설치합니다:
sudo apt-get install fuse libfuse. (다른 시스템에서 의존성 및 설치 방법에 대해 더 알고 싶다면 링크를 참조하세요)AppImage 파일이 있는 디렉터리로 이동한 뒤 파일에 실행 권한을 부여하세요:
chmod +x OneKey-Wallet-4.18.0-linux-x86_64.AppImage현재 사용자(루트가 아님)로 실행하여 설치합니다:
./OneKey-Wallet-4.18.0-linux-x86_64.AppImage
실행 중 "Missing X Server or $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사용 금지.
이러한 변경은 일시적이며 재부팅하거나 장치를 재연결하면 유지되지 않으며, 권한을 느슨하게 하는 것은 보안 위험을 초래할 수 있습니다.