YuerKey

深色模式

配对与连接 ​

YuerKey App 通过 BLE（低功耗蓝牙）与 YuerKey 设备通信。首次使用需要进行一次配对操作，之后每次打开 App 会自动连接已配对的设备。

首次配对 ​

准备工作 ​

在开始配对前，请确认：

  • YuerKey 设备已通过 USB 供电并开机
  • 手机蓝牙已开启
  • YuerKey App 已安装并完成首次启动引导
  • 手机与 YuerKey 设备的距离在 10 米以内

配对步骤 ​

  1. 打开 App：启动 YuerKey App，进入主界面

  2. 开始扫描：点击首页的「扫描设备」按钮，App 开始搜索附近的 YuerKey 设备

  3. 发现设备：扫描列表中会显示发现的 YuerKey 设备：

    • 设备名称显示为 YuerKey-XXXX（XXXX 为设备标识）
    • 旁边显示信号强度（RSSI），数值越大表示距离越近
    • 如果有多个设备，通过信号强度或设备名称区分

  4. 选择设备：点击你要配对的设备名称

  5. 建立安全连接：App 与设备进行 ECDH 密钥交换，建立加密通信通道。这个过程自动完成，耗时约 2-3 秒

  6. 设备端确认：

    • YuerKey 屏幕显示配对请求，包含 App 的公钥指纹
    • 核对 App 上显示的指纹与设备上显示的指纹是否一致
    • 确认一致后，在设备上按下确认键

  7. 配对完成：App 显示「已连接」，设备屏幕也显示连接成功

安全说明 ​

配对过程的安全性至关重要，YuerKey 采用了以下安全措施：

安全措施说明
ECDH 密钥交换使用椭圆曲线 Diffie-Hellman 算法协商加密密钥
AES-GCM 加密配对后的所有通信使用 AES-GCM 认证加密
设备端确认配对必须在设备上物理按键确认，防止未授权配对
公钥指纹验证双向显示指纹，防止中间人攻击

重要

请务必核对 App 和设备上显示的公钥指纹是否一致。如果不一致，请拒绝配对并检查周围是否有可疑设备。

日常连接 ​

配对完成后，日常使用非常简单：

自动连接 ​

  1. 打开 YuerKey App
  2. App 自动搜索并连接已配对的设备
  3. 连接成功后，主页显示设备状态信息：
    • 设备名称
    • 连接状态（已连接/未连接）
    • 电池状态（如果有电池）

手动连接 ​

如果自动连接失败：

  1. 下拉刷新主页，触发重新搜索
  2. 或点击设备卡片上的「重新连接」按钮
  3. 等待连接建立

连接状态指示 ​

状态说明
已连接设备在线，可以正常操作
连接中正在建立连接，请稍候
未连接设备不在范围内或未开机
已断开连接中断，尝试重新连接

多设备管理 ​

YuerKey App 支持同时管理多个 YuerKey 设备。

添加新设备 ​

  1. 进入 设备管理 页面
  2. 点击「添加设备」
  3. 按照 首次配对 的步骤操作
  4. 新设备出现在设备列表中

切换设备 ​

如果你有多个 YuerKey 设备：

  1. 在设备列表中查看所有已配对的设备
  2. 点击要操作的设备
  3. App 断开当前设备，连接选中的设备
  4. 切换完成后，所有操作都针对新选中的设备

设置默认设备 ​

你可以设置一个默认设备，App 启动时优先连接该设备：

  1. 在设备列表中长按目标设备
  2. 选择「设为默认设备」
  3. 该设备旁边会显示默认标识

设备备注 ​

为每个设备设置备注名，方便区分：

  1. 在设备列表中点击设备
  2. 点击设备名称旁的编辑按钮
  3. 输入备注名（如「工作用」「个人用」）
  4. 备注名仅保存在 App 中，不会修改设备本身的名称

断开与取消配对 ​

断开连接 ​

以下操作会断开当前连接：

  • 关闭 YuerKey App
  • 关闭手机蓝牙
  • YuerKey 设备断电或超出蓝牙范围（约 10 米）
  • 在 App 中手动点击「断开连接」

断开连接后，配对信息仍然保留，下次可以直接重新连接。

取消配对 ​

如果你不再使用某个设备，或需要将设备配对给其他人：

  1. 进入 设备管理 页面
  2. 找到要取消配对的设备
  3. 左滑或长按，选择「取消配对」
  4. 确认操作

注意

取消配对会清除 App 中该设备的所有配对信息。如果要重新使用，需要再次执行完整的配对流程。设备端也需要在配对管理中删除对应的配对记录。

连接问题排查 ​

扫描不到设备 ​

可能原因解决方法
设备未开机确认 YuerKey 通过 USB 供电且已开机
蓝牙未开启检查手机蓝牙是否已开启
距离过远将手机靠近设备，保持在 10 米以内
权限未授予检查 App 是否获得蓝牙和位置权限（Android）
设备正在连接其他手机YuerKey 一次只能连接一个 App，断开其他连接后重试

连接频繁断开 ​

  • 确保手机和设备之间没有大型金属障碍物
  • 减小手机与设备的距离
  • 检查是否有其他蓝牙设备干扰
  • 尝试在 App 中取消配对后重新配对

配对时设备无响应 ​

  • 确认设备屏幕是否亮起（可能处于锁屏状态，需要先解锁）
  • 确认设备没有在执行其他操作
  • 尝试重启设备后重新配对

Android 12+ 权限问题 ​

Android 12 及以上版本引入了新的蓝牙权限模型。如果遇到问题：

  1. 进入系统设置 → 应用 → YuerKey → 权限
  2. 确认「附近设备」权限已授予
  3. 如果之前选择了「仅在使用时允许」，尝试改为「始终允许」

iOS 蓝牙权限问题 ​

如果 iOS 提示「YuerKey 想使用蓝牙」：

  1. 点击「好」允许
  2. 如果之前拒绝了，进入系统设置 → YuerKey → 开启蓝牙权限