Skip to main content

5 分钟跑通 KVM

1. 硬件准备​

  • KVM 设备：FriendlyElec NanoPC-T6（RK3588 8GB RAM 64GB eMMC 推荐版本）
  • HDMI 桥接：从目标机的 HDMI OUT → KVM 的 HDMI IN（设备内部走 V4L2 capture）
  • USB Gadget 线：KVM 的 USB-C OTG 口 → 目标机的 USB-A 口（仿 HID 设备）
  • 网络：KVM 连同一 LAN（默认 DHCP，可改静态 IP）

2. 烧录系统​

下载预制 Debian 镜像（含所有依赖 + kvm-server 服务）：

# 详见 https://github.com/qiurui144/KVM/releases
wget https://github.com/qiurui144/KVM/releases/download/v2.0.4/nanopc-t6-kvm-v2.0.4.img.xz
xz -dk nanopc-t6-kvm-v2.0.4.img.xz
sudo dd if=nanopc-t6-kvm-v2.0.4.img of=/dev/sdX bs=4M status=progress conv=fdatasync

启动后 eth0 上 DHCP 拿 IP，串口 / dmesg 可看到 kvm-server listening on :8080。

3. 浏览器打开​

https://<KVM-IP>:8080

首次登录：用户名 admin / 密码 admin（首次登录后必改，详见 安全 & 合规）。

HTTPS 自签证书提示：开发期默认自签 cert，浏览器会弹 "证书无效"。 生产部署请在 KVM 内 /etc/kvm/certs/ 放正式证书 + 改 config.json。

4. 第一次远程控制​

  1. 登录后默认进 控制台 页
  2. 右上 "HDMI: ✓ 已连接" / "视频: ✓ 运行中" 说明捕获正常
  3. 中央视频区显示目标机屏幕
  4. 鼠标 / 键盘直接操作 — KVM 通过 USB Gadget 注入给目标机

5. 调分辨率（避坑）​

侧栏 "分辨率" 区按需切：

  • 720p — 弱网（< 4 Mbps）或低延迟优先
  • 1080p — 默认（兼顾画质 + 带宽）
  • 1080p 60 — 游戏 / 60Hz 源（需 > 6 Mbps 带宽）
  • 4K — 仅 RK3588 NPU + > 15 Mbps 带宽

切换是热切换，无需重启。v2.0.4 之前曾有切换 hang 15s 的 bug，已修复（见 架构 §视频管线）。

下一步​

  • 想批量提取屏幕数据当 AI 训练样本 → API 文档
  • 想开本地 AI Agent 替你点鼠标 → 见 架构 §Agent 治理（v2.1 新功能）
  • 想做合规审计 → 安全 & 合规