跳转到主要内容

UKey Wallet 官方安装和环境兼容性指南

U
作者:UKey Wallet

欢迎使用 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 可用磁盘空间。

这是否解答了您的问题?