YuerKey

深色模式

安装 YuerKey App ​

YuerKey App 是 YuerKey 硬件安全密钥的配套管理应用，基于 Flutter 开发，支持 Android、iOS 以及桌面平台。通过 App，你可以管理 OTP 令牌、密码保险库、设备设置等。

Android ​

从 Google Play 安装（推荐） ​

  1. 在手机上打开 Google Play 商店
  2. 搜索「YuerKey」
  3. 找到 YuerKey 官方应用（认准开发者名称 Yuerchu）
  4. 点击「安装」
  5. 安装完成后打开应用

Google Play 安装的优势：自动更新、安全审核、版本管理。

APK 直接安装 ​

如果无法访问 Google Play，可以从官方渠道下载 APK 文件手动安装：

  1. 在手机浏览器中访问 YuerKey 官方发布页面
  2. 下载最新版本的 APK 文件
  3. 下载完成后点击 APK 文件
  4. 如果提示「不允许安装未知来源应用」，按照系统提示开启权限：
    • Android 8.0+：设置 → 应用 → 特殊权限 → 安装未知应用 → 允许浏览器安装
  5. 确认安装

安全提示

请只从官方渠道下载 APK 文件。从非官方来源下载可能存在安全风险。

系统要求 ​

要求最低版本
Android 版本8.0（API 26）及以上
蓝牙BLE 4.2+
存储空间约 50 MB

iOS ​

从 App Store 安装 ​

  1. 在 iPhone/iPad 上打开 App Store
  2. 搜索「YuerKey」
  3. 找到 YuerKey 官方应用
  4. 点击「获取」
  5. 通过 Face ID / Touch ID 确认安装
  6. 安装完成后打开应用

系统要求 ​

要求最低版本
iOS 版本14.0 及以上
设备iPhone 8 及以上 / iPad（第 5 代）及以上
蓝牙BLE 4.2+
存储空间约 80 MB

桌面端 ​

YuerKey App 也提供桌面版本，方便在电脑上管理设备。桌面端通过 USB 或蓝牙连接设备。

提示

桌面端的功能可能与移动端略有差异，部分功能（如扫码添加 OTP）在桌面端不可用。

Windows ​

  1. 从官方发布页面下载 Windows 安装包（.exe 或 .msix）
  2. 双击安装包，按照提示完成安装
  3. 从开始菜单或桌面快捷方式启动

系统要求：Windows 10（1903）及以上，支持 BLE 的蓝牙适配器。

macOS ​

  1. 从官方发布页面下载 DMG 文件
  2. 打开 DMG 文件，将 YuerKey App 拖入「应用程序」文件夹
  3. 首次打开时，可能需要在「系统偏好设置 → 安全性与隐私」中允许运行

系统要求：macOS 11.0（Big Sur）及以上。

Linux ​

  1. 从官方发布页面下载 AppImage 或 .deb 包
  2. 安装或运行：
    • AppImage：赋予执行权限后双击运行（chmod +x YuerKey-*.AppImage）
    • deb 包：sudo dpkg -i yuerkey_*.deb

系统要求：Ubuntu 20.04 及以上或同级发行版，BlueZ 5.50+。

权限说明 ​

YuerKey App 需要以下系统权限才能正常工作：

权限平台用途必要性
蓝牙全平台与 YuerKey 设备进行 BLE 通信必需
位置AndroidAndroid 系统要求：BLE 扫描需要位置权限必需
相机全平台扫描 OTP 二维码添加令牌可选
生物识别全平台App 启动时的身份验证保护可选
通知全平台推送设备连接状态、更新提示等通知可选

关于 Android 位置权限 ​

Android 系统从 6.0 开始，要求 BLE 扫描必须获取位置权限。这是 Android 系统的限制，YuerKey App 不会收集或使用你的位置信息。App 仅在扫描 BLE 设备时使用该权限。

Android 12 及以上版本可以仅授予「附近设备」权限，无需授予精确位置权限。

权限被拒绝怎么办？ ​

如果你不小心拒绝了必要权限，可以在系统设置中手动授予：

  • Android：设置 → 应用 → YuerKey → 权限
  • iOS：设置 → YuerKey → 逐项开启权限

首次启动 ​

安装完成后首次打开 App：

  1. App 显示欢迎页面和简要介绍
  2. 请求必要权限（蓝牙、位置等）
  3. 可选：设置生物识别锁定
  4. 进入主界面
  5. 开始 配对设备

更新 App ​

自动更新 ​

  • Google Play / App Store：默认自动更新，或在商店中手动更新
  • 桌面端：App 启动时自动检查更新，提示下载新版本

手动更新 ​

从官方发布页面下载最新版本覆盖安装即可，用户数据不受影响。

常见问题 ​

App 闪退或无法启动？ ​

  • 确认系统版本满足最低要求
  • 尝试卸载后重新安装
  • 清除 App 缓存：设置 → 应用 → YuerKey → 存储 → 清除缓存

没有蓝牙怎么办？ ​

YuerKey App 依赖 BLE 蓝牙与设备通信。如果你的手机/电脑不支持 BLE 4.2+，将无法使用 App 连接设备。但 YuerKey 设备的 USB 功能（智能卡、OTP、自动输入等）不需要 App 也能正常使用。

App 支持哪些语言？ ​

目前支持简体中文和英文，会自动匹配系统语言。也可以在 App 设置中手动切换。