Docker 安装

本文介绍如何使用 Docker 部署 One-KVM。

前提条件

• 系统要求：Linux 操作系统（推荐 Debian/Ubuntu），安装好 Docker 软件。
• 硬件准备：启用 USB OTG 或插好 CH340+CH9329 HID 线（用于 HID 模拟），插好 USB 视频采集卡。

启动容器

docker run --name one-kvm -itd --privileged=true \
  -v /dev:/dev  -v /sys/:/sys \
  --net=host \
  silentwind0/one-kvm

访问 Web 界面

打开浏览器访问 http://<设备IP>:8080

首次访问

首次访问时，系统会引导您完成初始配置，包括创建管理员账户。

配置选项

环境变量

变量名	默认值	说明
TZ	UTC	时区设置
HTTP_PORT	8080	HTTP 端口
HTTPS_PORT	8443	HTTPS 端口
ENABLE_HTTPS	false	是否启用 HTTPS 服务（值：true/false）
DATA_DIR	/data	数据目录
VERBOSE	0	日志详细程度：1（-v）、2（-vv）、3（-vvv），数值越大日志越详细

说明

• 启用 HTTPS 时，无需额外挂载证书文件，系统使用默认自签名证书。
• --privileged=true 和 -v /dev:/dev -v /sys:/sys 是硬件访问必需的配置，目前不可省略。后面会支持细化目录和权限。
• --net=host 模式确保端口映射直接生效，无需额外配置 -p 参数映射端口。

继续阅读：用户界面