Vui lòng làm theo các bước khắc phục sự cố dựa trên nền tảng và phương thức kết nối hiện tại của bạn.
🌄 Trong phiên bản mới nhất của plugin OneKey App, OneKey Bridge không còn cần thiết để kết nối ví phần cứng của bạn nữa. Phương thức kết nối OneKey Bridge cũ đã bị loại bỏ.
Windows
Khắc phục sự cố kết nối USB
Thiếu trình điều khiển USB cho ví phần cứng
Kiểm tra xem thiết bị của bạn đã được nâng cấp lên firmware mới nhất chưa. Tham khảo "Cập nhật Firmware Ví phần cứng OneKey" để biết hướng dẫn nâng cấp.
Mở "Device Manager" (Trình quản lý thiết bị) trên Windows và kiểm tra trong mục "Universal Serial Bus controllers" để tìm các thiết bị bắt đầu bằng "OneKey". Nếu thiết bị hiển thị dấu chấm than, hãy cập nhật trình điều khiển Windows bằng phương pháp dưới đây.
Giải pháp
Truy cập https://zadig.akeo.ie/ và tải xuống trình cài đặt "Zadig 2.9".
Sau khi mở trình cài đặt, hãy chọn "WinUSB" để cài đặt.
Khởi động lại máy tính của bạn sau khi cài đặt để áp dụng các thay đổi.
Khắc phục sự cố kết nối Bluetooth
Kiểm tra phiên bản và quyền
Sử dụng OneKey App (phiên bản 5.12 trở lên), bạn có thể kết nối ví phần cứng với máy tính qua Bluetooth. Đảm bảo ví phần cứng OneKey của bạn cũng đang chạy phiên bản firmware mới nhất. Tham khảo "Cập nhật Firmware Ví phần cứng OneKey" để biết hướng dẫn nâng cấp.
Kiểm tra xem Bluetooth có bị tắt trên ví phần cứng của bạn không. Đối với OneKey Pro, cũng cần tắt chế độ Air-Gap. Sau đó, khóa và mở khóa ví phần cứng của bạn và thử kết nối lại qua Bluetooth.
Trong phần "Settings" (Cài đặt) - "Preferences" (Tùy chọn), đảm bảo chức năng Bluetooth cho OneKey App đã được bật.
Lưu ý: Kết nối Bluetooth không được hỗ trợ bởi tiện ích mở rộng trình duyệt. Vui lòng sử dụng USB.
macOS
Khắc phục sự cố kết nối USB
Thiếu ủy quyền hệ thống cho kết nối phụ kiện USB
Kiểm tra xem thiết bị của bạn đã được nâng cấp lên firmware mới nhất chưa. Tham khảo "Cập nhật Firmware Ví phần cứng OneKey" để biết hướng dẫn nâng cấp.
Khi sử dụng kết nối USB-C, hãy nhấp vào "Allow" (Cho phép) trên thông báo ủy quyền.
Nếu trước đó bạn đã từ chối ủy quyền và thông báo không còn xuất hiện, hãy đi tới "System Settings" (Cài đặt hệ thống) - "Privacy & Security" (Quyền riêng tư & Bảo mật) - "Security" (Bảo mật) - "Accessories" (Phụ kiện) và thay đổi cài đặt thành "Always ask" (Luôn hỏi). Tùy chọn này chủ yếu có sẵn trên MacBook chạy Apple Silicon (M1/M2/M3, v.v.).
Khắc phục sự cố kết nối Bluetooth
Kiểm tra phiên bản và quyền
Sử dụng OneKey App (phiên bản 5.12 trở lên), bạn có thể kết nối ví phần cứng với máy tính qua Bluetooth. Đảm bảo ví phần cứng OneKey của bạn cũng đang chạy phiên bản firmware mới nhất. Tham khảo "Cập nhật Firmware Ví phần cứng OneKey" để biết hướng dẫn nâng cấp.
Kiểm tra xem Bluetooth có bị tắt trên ví phần cứng của bạn không. Đối với OneKey Pro, cũng cần tắt chế độ Air-Gap. Sau đó, khóa và mở khóa ví phần cứng của bạn và thử kết nối lại qua Bluetooth.
Trong phần "Settings" - "Preferences", đảm bảo chức năng Bluetooth cho OneKey App đã được bật.
Lưu ý: Kết nối Bluetooth không được hỗ trợ bởi tiện ích mở rộng trình duyệt. Vui lòng sử dụng USB.
Linux
Khắc phục sự cố kết nối USB
Chưa thiết lập quy tắc udev
Kiểm tra xem thiết bị của bạn đã được nâng cấp lên firmware mới nhất chưa. Tham khảo "Cập nhật Firmware Ví phần cứng OneKey" để biết hướng dẫn nâng cấp.
Truy cập https://data.onekey.so/onekey.rules để sao chép các quy tắc udev.
Tạo một tệp mới tại /etc/udev/rules.d/99-onekey.rules và dán các quy tắc đã sao chép vào đó.
Trong terminal, nhập:
sudo udevadm control --reload-rules
Android
Khắc phục sự cố kết nối Bluetooth
Quyền chưa được bật
Kiểm tra xem thiết bị của bạn đã được nâng cấp lên firmware mới nhất chưa. Tham khảo "Cập nhật Firmware Ví phần cứng OneKey" để biết hướng dẫn nâng cấp.
Khởi động lại OneKey App và thiết bị ví phần cứng OneKey, đồng thời bật riêng quyền GPS và Bluetooth cho OneKey App trong "System Settings" (Cài đặt hệ thống).
Lưu ý: Nếu mẫu ví của bạn là OneKey Pro và chế độ AirGap đã bật, USB và Bluetooth của thiết bị phần cứng sẽ không khả dụng. Chúng sẽ có thể sử dụng sau khi bạn tắt chế độ AirGap.
iOS
Khắc phục sự cố kết nối Bluetooth
Quyền chưa được bật
Kiểm tra xem thiết bị của bạn đã được nâng cấp lên firmware mới nhất chưa. Tham khảo "Cập nhật Firmware Ví phần cứng OneKey" để biết hướng dẫn nâng cấp.
Bật và tắt Chế độ máy bay một lần. Thao tác này sẽ đặt lại tất cả các mô-đun không dây trên điện thoại của bạn (Wi-Fi và Bluetooth).
Đi tới Settings (Cài đặt) -> Privacy & Security (Quyền riêng tư & Bảo mật) -> Bluetooth và đảm bảo nút gạt cho OneKey App đang ở trạng thái Bật (màu xanh lá).
Tiện ích mở rộng Chrome
Sử dụng phương thức kết nối WebUSB
Chuyển từ Hardware Bridge sang WebUSB
Kiểm tra xem thiết bị của bạn đã được nâng cấp lên firmware mới nhất chưa. Tham khảo "Cập nhật Firmware Ví phần cứng OneKey" để biết hướng dẫn nâng cấp.
Mở OneKey App, đi tới Settings (Cài đặt) > Network (Mạng) > Hardware communication (Giao tiếp phần cứng), và chuyển phương thức kết nối sang "WebUSB".
Lưu ý: OneKey đã nâng cấp Hardware Bridge thành kết nối WebUSB trực tiếp, vì vậy bạn không cần cài đặt thêm bất kỳ phần mềm nào.
Vẫn gặp sự cố?
💁♀️ Nếu bạn vẫn không thể kết nối ví phần cứng của mình, vui lòng nhấp vào nút dịch vụ khách hàng hình tròn ở góc dưới bên phải trang web để liên hệ với bộ phận hỗ trợ trực tuyến của chúng tôi.







