初始设置向导¶
首次访问未初始化的 One-KVM 时会进入初始设置向导。向导共有 4 步,顶部的步骤条会显示当前进度。设置完成后会自动登录并进入控制台。
1. 账号设置¶
创建管理员账户:
- 用户名至少 2 个字符;
- 密码至少 4 个字符,并输入两次确认;
- 输入密码后页面会显示密码强度。
2. 音视频设置¶
选择远程主机的采集设备和输入参数:
- 视频设备;
- 输入格式、分辨率和帧率;
- 音频设备,也可以选择不使用音频;
- 高级选项:编码器后端 默认为 自动(推荐),需要时可以选择硬件或软件编码。
设备列表为空时,先连接采集设备,再使用页面提供的刷新操作重新获取设备。
3. 鼠键设置¶
选择 HID 驱动及对应设备:
- USB OTG:选择 USB 设备控制器(UDC),由设备直接模拟 HID;
- CH9329:选择串口设备并设置波特率;
- 蓝牙:选择蓝牙适配器并设置广播名称;
- 禁用:不启用 HID。
选择完成后点击 使用此配置。如果当前驱动所需设备不可用,向导会显示错误并阻止继续。
4. 扩展设置¶
选择是否自动启动 Web 终端(ttyd)。该选项只有在设备安装 ttyd 时可用,完成向导后仍可在设置页面调整。
完成设置¶
点击 完成设置 后,系统会保存账户、音视频、HID 和扩展配置,初始化服务并跳转到控制台。后续可在设置页面修改这些选项。
如需重新运行向导,停止 One-KVM 后删除 /etc/one-kvm/one-kvm.db,再启动服务并重新打开网页。



