One-KVM

Rust 编写的开放轻量 IP-KVM 解决方案，实现 BIOS 级远程管理

简体中文 · English

---

项目概述

One-KVM Rust 是一个用 Rust 编写的轻量级 IP-KVM 解决方案，可通过网络远程管理服务器和工作站，实现 BIOS 级远程控制。

项目目标：提供一个开放、轻量、易用的 IPKVM 解决方案。

• 开放：不绑定特定硬件配置，可在各类硬件环境中稳定运行。
• 轻量：以二进制文件形式分发，无繁杂的依赖项，部署过程简单。
• 易用：无需手动编辑配置文件，参数设置均可通过网页界面完成。

更多内容可访问 One-KVM Rust 文档站点。

One-KVM Python 已停止开发，如有需要可访问 https://github.com/mofeng-git/One-KVM/tree/python。

功能介绍

核心功能

功能	能力说明
视频采集与传输	支持 USB HDMI 采集卡、MIPI CSI 和 RK3588 HDMI IN，提供 MJPEG / WebRTC（H.264 / H.265 / VP8 / VP9）视频流
视频编码	支持 VAAPI / QSV / NVENC / AMF / RKMPP / V4L2 M2M 硬件编码，以及软件编码兜底
键鼠控制	支持 USB OTG HID、CH340 + CH9329 串口 HID 和蓝牙 HID；USB / 串口支持绝对与相对鼠标模式，蓝牙支持相对鼠标模式
虚拟媒体	通过 USB Mass Storage 挂载 ISO / IMG 镜像，支持虚拟光驱、虚拟 U 盘和 Ventoy 多镜像启动
ATX 电源控制	支持 GPIO、USB HID / 串口继电器，实现开关机、强制关机和重启；GPIO 可检测电源与硬盘活动指示灯
网络唤醒	支持 Wake-on-LAN（WOL），可选择发送网卡并保存唤醒历史
音频传输	支持 Linux ALSA / Windows WASAPI 采集与 Opus 编码，通过 WebSocket / WebRTC 传输被控机音频
USB 麦克风	通过 USB OTG UAC 将浏览器麦克风音频传入被控机
USB 网络共享	支持 NCM / ECM / RNDIS 虚拟网卡，将被控机通过 USB 桥接到有线网络
远程客户端接入	内置 RustDesk 与 VNC 服务；RustDesk 支持 ID 服务与 IP 直连，VNC 支持 Tight JPEG / H.264
RTSP 视频流	提供 H.264 / H.265 RTSP 视频流，支持用户名与密码认证

具体功能可用性取决于运行平台、硬件与驱动。

安装使用

构建产物见 GitHub Releases。以下为常见安装方式的简要步骤；系统要求、硬件准备、Docker 环境变量与 USB OTG 等完整说明请查阅 One-KVM Rust 文档站点。

使用 deb 安装（Debian / Ubuntu）

从 Releases 下载与本机架构匹配的 one-kvm_*.deb，在包所在目录执行：

sudo apt update
sudo apt install ./one-kvm_0.x.x_<arch>.deb

将文件名中的版本号与架构替换为实际下载的包名。

使用 Docker

镜像分为 one-kvm（One-KVM 主程序 + ttyd）与 one-kvm-full（另含 gostc、easyfrpc、easytier-core、easytier-cli、frpc 等可选扩展），按需选用。

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

拉取较慢时，可将镜像名替换为阿里云加速，例如 registry.cn-hangzhou.aliyuncs.com/silentwind/one-kvm-full（one-kvm 镜像同理，将 silentwind0/one-kvm 换为 registry.cn-hangzhou.aliyuncs.com/silentwind/one-kvm）。

飞牛 NAS

One-KVM 已上架飞牛 应用市场，在 NAS 上直接搜索安装即可。

访问 Web 与首次配置

浏览器访问 http://<设备 IP>:8080（飞牛 NAS 安装后为 8420 端口）。首次访问将引导完成初始配置。

报告问题

如果您发现了问题，请：

1. 使用 GitHub Issues 报告，或加入 QQ 群聊反馈。
2. 提供有帮助的错误信息和复现步骤
3. 包含您使用的软件版本、硬件配置和系统信息

赞助支持

本项目基于多个优秀开源项目进行二次开发，作者投入了大量时间进行测试和维护。如果您觉得这个项目有价值，欢迎通过 为爱发电 支持项目发展。

感谢名单

点击查看感谢名单

• 浩龙的电子嵌入式之路

• Tsuki

• H_xiaoming

• 0蓝蓝0

• fairybl

• Will

• 自.知

• 观棋不语٩ ི۶

• 爱发电用户_a57a4

• 爱发电用户_2c769

• 霜序

• 远方（闲鱼用户名：小远技术店铺）

• 爱发电用户_399fc

• 斐斐の

• 爱发电用户_09451

• 超高校级的錆鱼

• 爱发电用户_08cff

• guoke

• mgt

• 姜沢掵

• ui_beam

• 爱发电用户_c0dd7

• 爱发电用户_dnjK

• 忍者胖猪

• 永遠の願い

• 爱发电用户_GBrF

• 爱发电用户_fd65c

• 爱发电用户_vhNa

• 爱发电用户_Xu6S

• moss

• woshididi

• 爱发电用户_a0fd1

• 爱发电用户_f6bH

• 码农

• 爱发电用户_6639f

• jeron

• 爱发电用户_CN7y

• 爱发电用户_Up6w

• 爱发电用户_e3202

• 一语念白

• 云边

• 爱发电用户_5a711

• 爱发电用户_9a706

• T0m9ir1SUKI

• 爱发电用户_56d52

• 爱发电用户_3N6F

• DUSK

• 飘零

• .

• 饭太稀

• 葱

• MaxZ

• 爱发电用户_c5f33

• 爱发电用户_09386

• 爱发电用户_JT6c

• 爱发电用户_d3d9c

• 爱发电用户_97b41

• 偶然

• 爱发电用户_dba45

• 爱发电用户_d4f8b

• 故人。

• WindowsHao

• 爱发电用户_d4f8b

• 爱发电用户_59f5a

• 爱发电用户_96f28

• 孤星赏月

• t316161070

• 爱发电用户_f5gW

• 爱发电用户_5fb5c

• 爱发电用户_86d54

• 爱发电用户_maRx

• nb

• 爱发电用户_0aa4a

• 爱发电用户_f75a7

• 爱发电用户_b4646

• n1k0

• Yeskf

• 魔力回旋彪

• 泡面

• 中看台的杰森

• LWF

• 爱发电用户_b38fb

• 丨拒绝啦丶

• 爱发电用户_rGYn

• 爱发电用户_XU9y

• 爱发电用户_ec19b

• 爱发电用户_A4dE

• 爱发电用户_eYRC

• Aleo

• 淼

• 爱发电用户_5d06d

• Ghost_chu

• 爱发电用户_1fa21

• 爱发电用户_a7072

• 爱发电用户_9HrC

• 飒歼外寒

• Resucdueff

• Gentisan

• 爱发电用户_MGAx

• 爱发电用户_bce93

• 爱发电用户_60f87

• Bottling3748

• 爱发电用户_7cbeb

• 爱发电用户_6c721

• 哦哦哦哦

• 盒子先生

• 似水流年

• chnxan

• ......

赞助商

本项目得到以下赞助商的支持：

文件存储服务：

• Huang1111公益计划 - 提供免登录下载服务

云服务商

• 林枫云 - 赞助了本项目服务器

  

  林枫云主营国内外地域的精品线路业务服务器、高主频游戏服务器和大带宽服务器。

• 贝塔网络 - 赞助了本项目服务器

  

  远程电脑、消费级GPU服务器、独服物理机，全自动在线交付。