跳转至

玩客云 Pro

玩客云 Pro 采用了 S912 八核 CPU，搭配 2GB 内存和 8GB 内部储存空间。它配备了一个千兆网络接口、2个 USB 2.0接口，并提供 TF 卡槽和 HDMI 输出。

已有 Docker 和 DEB 软件包两种部署方式，两者操作较为简单。若选择整合包部署方式，需要赞助作者并联系作者获取镜像。

整合包介绍

玩客云 Pro 最新整合包名称如下：

  • One-KVM-RUST_by-SilentWind_Onecloud-Pro_v0.2.8_261007-82148deaa.img.xz

优势：

  • 应用了 PiKVM MSD 内核补丁，支持大于 2.2G 的 ISO 挂载和虚拟媒体设备名称自定义；
  • 内置独家 V4L2M2M 编码驱动，支持 1080p30fps H.264/H.265 编码，远程视频更流畅。

整合包部署

  1. 准备 SD 卡启动介质：将 One-KVM 整合包写入 SD 卡，再将 SD 卡插入玩客云 Pro 的卡槽。
  2. 从 SD 卡引导：在原厂系统下首次刷机时，先按住 Reset 按钮再接通电源；看到玩客云 Logo 消失后，松开 Reset 按钮。之后如需再次刷机，接通电源即可自动启动 SD 卡中的系统。
  3. 将系统安装至 eMMC：SD 卡中的系统成功启动后，通过HDMI、串口或 SSH 登录终端，执行 armbian-install。选择与主板版本对应的型号：V1.1 主板选择 201，V1.2 主板选择 213。

下图为 armbian-install 安装过程：

玩客云 Pro armbian-install 安装过程

使用说明

系统首次启动后，约有 4.5 GB 可用存储空间。

硬件连接

  1. 将 USB HDMI 采集卡插入网口旁的普通 USB 接口，再使用 HDMI 线连接采集卡和被控机的 HDMI 输出接口。
  2. 将 USB 双公线的一端插入二维码旁的 USB OTG 接口，另一端插入被控机的 USB 接口。
  3. 确保所有连接稳固，再接入网线和电源。

硬件安全警告

为避免潜在风险（如被控设备无法正常启动或识别设备，甚至极少数情况下造成硬件损坏），强烈建议在使用 USB 双公线前采取以下任一安全措施：

方案一：剪断或移除 USB 线中的红色 5V 电源线（VCC），仅保留数据线（D+/D−）和地线（GND），以切断供电路径；

方案二：在 USB 链路中串接一个带独立电源开关的 USB HUB，并确保在连接时关闭其电源开关。

部分低功耗设备可能在未通主电源的情况下，通过 USB OTG 接口从 KVM 设备反向取电，导致进入异常状态——即使后续接通主电源也可能无法正常启动。

除非您明确了解操作后果，否则请务必采用上述防护措施以保障设备安全。

HDMI 终端

通过 HDMI 输出终端可以查看设备 IP 地址和软件版本。

玩客云 Pro HDMI 终端

SSH 远程登录

Armbian 系统默认开启 SSH 服务，初始用户名和密码为 root / 1234。请尽快修改默认密码。

系统升级警告

不建议使用 apt upgrade 升级内核和设备树，可能会出现系统异常，OTG 功能无法使用。

MAC 地址修改

当前镜像通过 /etc/one-kvm-image/eth0.mac 持久化网卡 MAC 地址。SSH 登录设备后，执行以下命令：

1
2
3
mkdir -p /etc/one-kvm-image
echo '02:11:22:33:44:55' | tee /etc/one-kvm-image/eth0.mac
reboot

如需使用其他 MAC 地址，请替换示例中的 02:11:22:33:44:55。

USB 功能组合

组合 结果
键盘（含状态灯） + 相对鼠标 + 绝对鼠标 + 多媒体键 通过
键盘（含状态灯） + 相对鼠标 + 绝对鼠标 + 多媒体键 + MSD 通过
键盘（含状态灯） + 相对鼠标 + 绝对鼠标 + 多媒体键 + MSD + NCM/ECM 不支持
键盘（含状态灯） + 相对鼠标 + 绝对鼠标 + 多媒体键 + RNDIS 不支持
键盘（含状态灯） + 相对鼠标 + 绝对鼠标 + 多媒体键 + MSD + RNDIS 不支持
键盘（含状态灯） + 相对鼠标 + 绝对鼠标 + RNDIS 通过
键盘（含状态灯） + 相对鼠标 + 绝对鼠标 + MSD + RNDIS 不支持
键盘（含状态灯） + 相对鼠标 + 绝对鼠标 + MSD + NCM/ECM 通过

OTG 模式

在设备树 dtb 中定义。

相关命令如下： 

1
2
3
4
5
6
7
8
# 查看 OTG 模式
cat /sys/devices/platform/soc/d0078080.usb/usb_role/d0078080.usb-role-switch/role

# 使能 OTG 端口模式，修改 usb@d0078080 节点 dr_mode 属性为 peripheral 或 host
dtc -I dtb -O dts /boot/dtb/amlogic/meson-gxm-octopus-planet.dtb -o /boot/dtb/amlogic/meson-gxm-octopus-planet.dts
nano /boot/dtb/amlogic/meson-gxm-octopus-planet.dts
dtc -I dts -O dtb /boot/dtb/amlogic/meson-gxm-octopus-planet.dts -o /boot/dtb/amlogic/meson-gxm-octopus-planet.dtb
reboot

编解码驱动说明

驱动为作者根据晶晨 3.x、4.x BSP 内核驱动代码指挥 AI 改写，在移植到新内核的同时把调用方式改为了 V4L2M2M。当有有一些特性尚未完全实现，如指定编码码率。 。 玩客云 Pro 支持 NV12/YUYV 输入编码为 H.264/H265 流。One-KVM MJPEG-->H.264/H.265 路径为 MJPEG 软解为 NV12 ，再由 NV12 硬件编码为 H.264/H265，前者受 CPU 性能影响，整合包默认 CPU 频率下此路径性能为 1080p30fps。

性能测试报告

测试用整合包： One-KVM-RUST_by-SilentWind_Onecloud-Pro_v0.2.5_260722-da20d8b.img.xz

  • 运行编号：20260722-222014-7f19dd
  • 测试设备：玩客云 Pro（onecloud-pro）
  • 视频设备：/dev/video1（1080p@50fps MJPEG、1080p@10fps YUYV）
  • HID 设备：OTG
  • HTTP 延迟：p50=3.1ms，p95=3.8ms，max=4.0ms

视频性能

视频输入参数 测试帧率 延迟统计（中位数 p50 / 95%分位 p95 / 最大值 max）
1080p@50fps MJPEG → MJPEG 50fps p50=76.0ms，p95=94.2ms，max=97.1ms
1080p@50fps MJPEG → H.264 25.2fps p50=298.7ms，p95=319.8ms，max=323.2ms
1080p@50fps MJPEG → H.265 3.9fps p50=779.9ms，p95=858.5ms，max=867.1ms
1080p@10fps YUYV → MJPEG 9.5fps p50=326.5ms，p95=368.4ms，max=378.4ms
1080p@10fps YUYV → H.264 9.5fps p50=635.2ms，p95=702.1ms，max=718.0ms
1080p@10fps YUYV → H.265 2.7fps p50=1391.4ms，p95=2091.3ms，max=2259.4ms

HID 性能

输入方式 延迟统计（中位数 p50 / 95%分位 p95 / 最大值 max）
OTG p50=2.6ms，p95=3.0ms，max=3.0ms

MSD 性能

操作 数据
写 10.03 MiB/s
读 14.59 MiB/s