현재 사용 중인 플랫폼과 연결 방식에 따라 문제 해결 단계를 진행해 주세요.
🌄 최신 버전의 OneKey 앱 플러그인에서는 하드웨어 지갑 연결을 위해 더 이상 OneKey Bridge가 필요하지 않습니다. 기존의 OneKey Bridge 연결 방식은 서비스가 종료되었습니다.
Windows
USB 연결 문제 해결
하드웨어 지갑의 USB 드라이버 누락
기기가 최신 펌웨어로 업데이트되었는지 확인하세요. 업데이트 지침은 "OneKey 하드웨어 지갑 펌웨어 업데이트" 문서를 참조하세요.
Windows "장치 관리자"를 열고 "범용 직렬 버스 컨트롤러" 항목에서 "OneKey"로 시작하는 장치가 있는지 확인하세요. 장치에 느낌표가 표시되어 있다면 아래 방법을 사용하여 Windows 드라이버를 업데이트하세요.
해결 방법
https://zadig.akeo.ie/에 접속하여 "Zadig 2.9" 설치 프로그램을 다운로드하세요.
설치 프로그램을 실행한 후, "WinUSB"를 선택하여 설치하세요.
설치 후 변경 사항을 적용하려면 컴퓨터를 다시 시작하세요.
블루투스 연결 문제 해결
버전 및 권한 확인
OneKey 앱(버전 5.12 이상)을 사용하면 컴퓨터와 블루투스를 통해 하드웨어 지갑을 연결할 수 있습니다. OneKey 하드웨어 지갑도 최신 펌웨어 버전인지 확인하세요. 업데이트 지침은 "OneKey 하드웨어 지갑 펌웨어 업데이트" 문서를 참조하세요.
하드웨어 지갑에서 블루투스가 비활성화되어 있는지 확인하세요. OneKey Pro의 경우, 에어갭(Air-Gap) 모드도 비활성화해야 합니다. 이후 하드웨어 지갑을 잠그고 다시 잠금을 해제한 뒤 블루투스 연결을 시도해 보세요.
"설정(Settings)" - "환경 설정(Preferences)"에서 OneKey 앱의 블루투스 기능이 활성화되어 있는지 확인하세요.
참고: 브라우저 확장 프로그램에서는 블루투스 연결을 지원하지 않습니다. USB를 사용해 주세요.
macOS
USB 연결 문제 해결
USB 액세서리 연결을 위한 시스템 권한 누락
기기가 최신 펌웨어로 업데이트되었는지 확인하세요. 업데이트 지침은 "OneKey 하드웨어 지갑 펌웨어 업데이트" 문서를 참조하세요.
USB-C를 연결하여 사용할 때 나타나는 승인 메시지에서 "허용(Allow)"을 클릭하세요.
이전에 승인을 거부하여 더 이상 메시지가 표시되지 않는 경우, "시스템 설정(System Settings)" - "개인정보 보호 및 보안(Privacy & Security)" - "보안(Security)" - "액세서리(Accessories)"로 이동하여 설정을 "항상 확인(Always ask)"으로 변경하세요. 이 옵션은 주로 Apple Silicon(M1/M2/M3 등)이 탑재된 MacBook에서 제공됩니다.
블루투스 연결 문제 해결
버전 및 권한 확인
OneKey 앱(버전 5.12 이상)을 사용하면 컴퓨터와 블루투스를 통해 하드웨어 지갑을 연결할 수 있습니다. OneKey 하드웨어 지갑도 최신 펌웨어 버전인지 확인하세요. 업데이트 지침은 "OneKey 하드웨어 지갑 펌웨어 업데이트" 문서를 참조하세요.
하드웨어 지갑에서 블루투스가 비활성화되어 있는지 확인하세요. OneKey Pro의 경우, 에어갭(Air-Gap) 모드도 비활성화해야 합니다. 이후 하드웨어 지갑을 잠그고 다시 잠금을 해제한 뒤 블루투스 연결을 시도해 보세요.
"설정(Settings)" - "환경 설정(Preferences)"에서 OneKey 앱의 블루투스 기능이 활성화되어 있는지 확인하세요.
참고: 브라우저 확장 프로그램에서는 블루투스 연결을 지원하지 않습니다. USB를 사용해 주세요.
Linux
USB 연결 문제 해결
udev 규칙이 설정되지 않음
기기가 최신 펌웨어로 업데이트되었는지 확인하세요. 업데이트 지침은 "OneKey 하드웨어 지갑 펌웨어 업데이트" 문서를 참조하세요.
https://data.onekey.so/onekey.rules에 접속하여 udev 규칙을 복사하세요.
/etc/udev/rules.d/99-onekey.rules에 새 파일을 생성하고 복사한 규칙을 붙여넣으세요.
터미널에 다음을 입력하세요:
sudo udevadm control --reload-rules
Android
블루투스 연결 문제 해결
권한이 활성화되지 않음
기기가 최신 펌웨어로 업데이트되었는지 확인하세요. 업데이트 지침은 "OneKey 하드웨어 지갑 펌웨어 업데이트" 문서를 참조하세요.
OneKey 앱과 OneKey 하드웨어 장치를 다시 시작하고, "시스템 설정(System Settings)"에서 OneKey 앱에 대한 GPS 및 블루투스 권한을 각각 활성화하세요.
참고: OneKey Pro 모델을 사용 중이고 에어갭(AirGap) 모드가 활성화되어 있다면, 장치의 USB 및 블루투스 기능은 사용할 수 없습니다. 에어갭 모드를 비활성화해야 사용할 수 있습니다.
iOS
블루투스 연결 문제 해결
권한이 활성화되지 않음
기기가 최신 펌웨어로 업데이트되었는지 확인하세요. 업데이트 지침은 "OneKey 하드웨어 지갑 펌웨어 업데이트" 문서를 참조하세요.
비행기 모드를 한 번 켰다가 끄세요. 이렇게 하면 휴대폰의 모든 무선 모듈(Wi-Fi 및 블루투스)이 재설정됩니다.
설정(Settings) -> 개인정보 보호 및 보안(Privacy & Security) -> 블루투스(Bluetooth)로 이동하여 OneKey 앱의 토글이 켜짐(녹색) 상태인지 확인하세요.
Chrome 확장 프로그램
WebUSB 연결 방식 사용
Hardware Bridge에서 WebUSB로 전환
기기가 최신 펌웨어로 업데이트되었는지 확인하세요. 업데이트 지침은 "OneKey 하드웨어 지갑 펌웨어 업데이트" 문서를 참조하세요.
OneKey 앱을 열고 설정(Settings) > 네트워크(Network) > 하드웨어 통신(Hardware communication)으로 이동하여 연결 방식을 "WebUSB"로 전환하세요.
참고: OneKey는 Hardware Bridge를 직접적인 WebUSB 연결 방식으로 업그레이드했으므로 별도의 설치가 필요하지 않습니다.
여전히 문제가 있으신가요?
💁♀️ 여전히 하드웨어 지갑을 연결할 수 없다면, 웹사이트 우측 하단에 있는 원형 고객 센터 버튼을 클릭하여 온라인 지원팀에 문의해 주세요.