YuerKey

深色模式

固件说明 ​

YuerKey 设备出厂时已预装最新稳定版固件，开箱即可使用，无需手动安装固件。

固件更新 ​

后续固件更新通过 OTA（空中升级） 方式完成，只需 WiFi 连接即可自动下载并安装新版本。

详细的更新操作请参见 固件更新。

需要安装驱动吗？ ​

大多数情况下不需要。YuerKey 使用标准的 USB HID 和 CCID 协议，以下操作系统均原生支持，即插即用：

  • Windows 10 及以上版本
  • macOS
  • Linux（需要安装 udev 规则，见下方说明）
  • Chrome OS

Linux udev 规则 ​

Linux 用户需要安装 udev 规则，才能以普通用户身份访问 YuerKey 的 FIDO2、智能卡等功能。

安装步骤：

  1. 将规则文件复制到系统目录：
bash
sudo cp scripts/69-yuerkey.rules /etc/udev/rules.d/
  1. 重新加载 udev 规则：
bash
sudo udevadm control --reload-rules && sudo udevadm trigger
  1. 重新插拔 YuerKey 设备。

如果你的发行版不使用 systemd（如 Devuan、某些嵌入式 Linux），还需要将用户加入 plugdev 组：

bash
sudo usermod -aG plugdev $USER

执行后需要注销并重新登录才能生效。

提示

大多数现代 Linux 发行版（Ubuntu 22.04+、Fedora 38+、Arch Linux 等）使用 systemd，规则文件中的 TAG+="uaccess" 会自动为登录用户授权，无需额外操作。

常见问题 ​

设备连接后电脑没有反应？ ​

检查 USB 线：最常见的原因是使用了纯充电线。换一根确认支持数据传输的 USB-C 线再试。

换一个 USB 口：优先使用电脑背面的 USB 口（台式机）或直连口（笔记本），避免使用 USB Hub。

重新插拔：拔出设备等待 5 秒后重新插入。

准备就绪后，继续阅读 首次启动 完成设备初始配置。