請根據您目前的平台和連線方式,遵循疑難排解步驟。
🌄 在最新版本的 OneKey App 外掛程式中,連接您的硬體錢包不再需要 OneKey Bridge。舊的 OneKey Bridge 連線方式已停用。
Windows
USB 連線疑難排解
遺失硬體錢包的 USB 驅動程式
檢查您的設備是否已升級到最新的韌體。請參閱「更新 OneKey 硬體錢包韌體」以取得升級說明。
開啟 Windows「裝置管理員」,並在「通用序列匯流排控制器」下查看開頭為「OneKey」的裝置。如果裝置顯示驚嘆號,請使用以下方法更新 Windows 驅動程式。
解決方法
前往 https://zadig.akeo.ie/ 下載「Zadig 2.9」安裝程式套件。
開啟安裝程式後,選擇「WinUSB」進行安裝。
安裝後重新啟動電腦以套用變更。
藍牙連線疑難排解
版本與權限檢查
使用 OneKey App (5.12 或以上版本),您可以透過藍牙將硬體錢包連接到電腦。請確保您的 OneKey 硬體錢包也運行著最新的韌體版本。請參閱「更新 OneKey 硬體錢包韌體」以取得升級說明。
檢查您的硬體錢包上的藍牙是否已停用。對於 OneKey Pro,也請停用 Air-Gap 模式。然後,鎖定並解鎖您的硬體錢包,然後再嘗試透過藍牙進行連線。
在「設定」-「偏好設定」中,請務必啟用 OneKey App 的藍牙功能。
注意:瀏覽器外掛程式不支援藍牙連線。請使用 USB。
macOS
USB 連線疑難排解
USB 配件連接的系統授權遺失
檢查您的設備是否已升級到最新的韌體。請參閱「更新 OneKey 硬體錢包韌體」以取得升級說明。
使用 USB-C 連線時,請點選授權提示上的「允許」。
如果您先前拒絕了授權且提示不再出現,請前往「系統設定」-「隱私權與安全性」-「安全性」-「配件」,然後將設定變更為「一律詢問」。此選項主要適用於配備 Apple Silicon (M1/M2/M3 等) 的 MacBook。
藍牙連線疑難排解
版本與權限檢查
使用 OneKey App (5.12 或以上版本),您可以透過藍牙將硬體錢包連接到電腦。請確保您的 OneKey 硬體錢包也運行著最新的韌體版本。請參閱「更新 OneKey 硬體錢包韌體」以取得升級說明。
檢查您的硬體錢包上的藍牙是否已停用。對於 OneKey Pro,也請停用 Air-Gap 模式。然後,鎖定並解鎖您的硬體錢包,然後再嘗試透過藍牙進行連線。
在「設定」-「偏好設定」中,請務必啟用 OneKey App 的藍牙功能。
注意:瀏覽器外掛程式不支援藍牙連線。請使用 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 App 和 OneKey 硬體設備,並分別在「系統設定」中為 OneKey App 啟用 GPS 與藍牙權限。
注意:如果您的錢包型號是 OneKey Pro 且已啟用 AirGap 模式,硬體設備的 USB 和藍牙將無法使用。停用 AirGap 模式後即可使用。
iOS
藍牙連線疑難排解
權限未啟用
檢查您的設備是否已升級到最新的韌體。請參閱「更新 OneKey 硬體錢包韌體」以取得升級說明。
開啟再關閉一次飛航模式。這將重設您手機的所有無線模組 (Wi-Fi 和藍牙)。
前往設定 -> 隱私權與安全性 -> 藍牙,並確保 OneKey App 的開關顯示為開啟 (綠色)。
Chrome 外掛程式
使用 WebUSB 連線方式
從 Hardware Bridge 切換至 WebUSB
檢查您的設備是否已升級到最新的韌體。請參閱「更新 OneKey 硬體錢包韌體」以取得升級說明。
開啟 OneKey App,前往設定 > 網路 > 硬體通訊,然後將連線方式切換為「WebUSB」。
注意:OneKey 已將 Hardware Bridge 升級為直接 WebUSB 連線,因此無需額外安裝。
仍有問題?
💁♀️ 如果您仍然無法連接您的硬體錢包,請點擊網站右下角的圓形客服按鈕,與我們的線上支援聯繫。







