mirror of https://github.com/mofeng-git/One-KVM.git synced 2026-04-29 17:36:35 +08:00

Files

tedaimeng c484580b8f Update README with CQUMirror details

Added CQUMirror information and links to the README.

2026-04-29 13:09:23 +08:00

5.9 KiB

Raw Blame History

One-KVM

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

简体中文 · English

📖 项目概述

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

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

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

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

📊 功能介绍

核心功能

功能	能力说明
视频采集	HDMI USB /MIPI CSI/RK3588 HDMI IN 采集支持，提供 MJPEG / WebRTC（H.264/H.265/VP8/VP9）视频流
视频编码	VAAPI/QSV/RKMPP/V4L2M2M 硬件编码支持，以及软件编码兜底
键鼠控制	USB OTG HID 或 CH340 + CH9329 HID，支持绝对/相对鼠标模式
虚拟媒体	USB Mass Storage，支持 ISO/IMG 镜像挂载和 Ventoy 虚拟U盘模式
ATX 电源控制	GPIO /USB 继电器，支持控制电源、重启按钮
音频传输	ALSA 采集 + Opus 编码（HTTP/WebRTC）

此外提供基于 Web UI 的可视化配置与中英文界面；并集成 Web 终端（ttyd）、内网穿透（gostc）、P2P 组网（EasyTier）、RustDesk 协议（扩展跨平台远程访问）以及 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、easytier-core 等可选扩展），按需选用。

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 端口）。首次访问将引导完成初始配置。

报告问题

如果您发现了问题，请：

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

赞助支持

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

感谢名单

点击查看感谢名单

浩龙的电子嵌入式之路
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
......

赞助商

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

镜像下载服务：

重庆大学开源软件镜像站 - 提供镜像站下载服务

文件存储服务：

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

云服务商

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

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

5.9 KiB Raw Blame History Unescape Escape