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