常见问题

---

客户端无法连接服务端

检查 vhdmonter_config.ini 中的 ServerBaseUrl 是否与服务端实际地址一致。若使用 Docker Compose 默认端口映射，应为 http://127.0.0.1:8082。

---

VHD 挂载失败

确保客户端以管理员身份运行。VHD 挂载需要管理员权限。

---

Maimoller 设备未识别

检查设备是否正确连接，且驱动已安装。在设备管理器中确认 HID 设备状态正常。

---

服务端初始化后无法登录

确认已完成初始化流程的第三步（POST /api/init/complete），且管理客户端或服务端返回了成功状态。

---

更新失败

离线更新需要：

1. 准备 manifest.json 和 manifest.sig
2. 放入卷标为 NX_INS 的可移动设备
3. 客户端启动时会自动检测并执行更新

---

高敏操作总是被弹出 OTP 验证窗

这是预期行为。证书管理、生成证书、机台审批 / 重置、EVHD 明文读取、部署管理、TOTP 密钥管理、日志导出、密码修改等高敏操作均要求 OTP step-up；管理客户端会在 OTP 未验证或会话过期时自动弹出验证窗，验证成功后透明地重试原始操作。

---

注销 TOTP 密钥被服务端拒绝（last_authenticator）

服务端要求至少保留一个 authenticator 类型密钥，最后一个不可被注销。如果当前只剩一个 authenticator，请先添加另一个 authenticator 后再注销旧的。