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