常见问题

客户端无法连接服务端

检查 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. 客户端启动时会自动检测并执行更新