欢迎使用 UKey 硬件钱包。为确保您的数字资产管理环境满足安全要求,并保证 UKey 硬件设备与终端之间通信稳定,请在部署客户端前确认以下官方环境兼容性要求。
1. 桌面端运行环境
UKey Wallet 桌面端客户端原生支持多个平台。请确认您的操作系统满足以下最低版本要求:
操作系统 | 最低系统要求 | 推荐系统要求 | 架构说明 |
macOS | 10.15 Catalina | 13 Ventura 及以上 | 原生兼容 Intel 和 Apple Silicon (M1/M2/M3) 芯片 |
Windows | Windows 10(版本 1809) | Windows 11 | 推荐使用标准 x86/x64 架构处理器 |
Linux | Ubuntu 18.04 / Debian 10 / Fedora 32 / RHEL 8 | Ubuntu 22.04 LTS 及以上 | 兼容主流发行版 |
2. 移动端运行环境
操作系统 | 最低系统要求 | 推荐系统要求 |
iOS / iPadOS | iOS 15.5 | iOS 17 及以上 |
Android | Android 7.0 | Android 13 及以上 |
UKey 官方安全政策声明:
为防止底层系统权限被滥用并导致关键数据(例如私钥缓存)泄露,UKey Wallet 会进行严格的运行环境检测。本应用禁止在已越狱的 iOS 设备或已 root 的 Android 设备上运行。尝试强制运行可能会触发安全锁定机制,或导致应用异常终止。
3. 浏览器扩展与 WebUSB 硬件通信支持
通过网页或浏览器扩展与 DApp 交互时,UKey 硬件需要依赖浏览器的 WebUSB API 建立安全的 HTTPS 直连数据通道。由于各大浏览器厂商对底层 API 的支持策略不同,请参考以下兼容性矩阵:
3.1 官方推荐并支持的浏览器(Chromium 内核)
Google Chrome:完全支持(版本 61 及以上)
Microsoft Edge:完全支持(版本 79 及以上)
官方建议:请始终将浏览器更新到最新版本,以获得最新安全补丁。
3.2 不支持的浏览器(无法调用硬件 API)
由于内核限制,以下浏览器无法识别并连接 UKey 硬件设备。请避免使用它们进行硬件交互:
Firefox
Safari
Opera
Samsung Internet
QQ Browser
Internet Explorer (IE)
UC Browser(⚠️ 已知风险:在 UC Browser 环境中调用硬件接口可能导致浏览器进程异常崩溃。)
3.3 移动端 Web 交互限制
Android 环境:在 Android 上使用 Chromium 内核浏览器(例如移动端 Chrome/Edge)可以正常进行 WebUSB 硬件通信。
iOS 环境(受限):受 Apple 官方底层安全策略限制,iOS 平台上的所有 Web 浏览器(包括 Chrome 和 iOS 版 Edge)均不支持 WebUSB 接口。需要管理资产和签署交易的 iOS 用户必须直接使用官方 UKey App。请勿尝试通过 iOS 移动端浏览器连接硬件。
4. 物理接口与设备通信规范
为确保硬件设备能够稳定、安全地向客户端传输加密签名指令,请确认以下物理连接条件:
有线连接:请使用设备附带的原装 USB-A 或 USB-C 数据线,并直接连接到计算机主板端口。不建议使用第三方低质量 USB 集线器或扩展坞,以避免因电源电压不稳定或信号衰减造成数据丢包。
移动端通信:
直接有线连接:Android 手机必须在系统设置中启用 OTG 数据传输功能。
无线连接:请确认移动设备已启用蓝牙,并已向 UKey App 授予必要的蓝牙通信权限。
5. 系统资源预留
为确保客户端顺利部署、本地加密数据安全存储,以及未来 UKey 硬件的 OTA 固件更新顺利进行,建议终端设备至少预留 500 MB 可用磁盘空间。
