One-KVM

基于 PiKVM 的 DIY IP-KVM 解决方案

📖 详细文档 • 🚀 在线演示 • ⚡ 快速开始 • 📊 功能介绍

---

📋 目录

• 项目概述
• 功能介绍
• 快速开始
• 贡献指南
• 其他

📖 项目概述

One-KVM 是基于开源 PiKVM 项目进行二次开发的 DIY IP-KVM 解决方案。该方案利用成本较低的硬件设备，实现 BIOS 级别的远程服务器或工作站管理功能。

应用场景

• 家庭实验室主机管理 - 远程管理服务器和开发设备
• 服务器远程维护 - 无需物理接触即可进行系统维护
• 系统故障处理 - 远程解决系统启动和 BIOS 相关问题

📊 功能介绍

核心特性

特性	描述	优势
无侵入性	无需在目标机器上安装软件或驱动	不依赖操作系统，可访问 BIOS/UEFI 设置
成本效益	利用常见硬件设备（如电视盒子、开发板等）	降低 KVM over IP 的实现成本
功能扩展	在 PiKVM 基础上增加实用功能	Docker 部署、视频录制、中文界面
部署方式	支持 Docker 部署和硬件整合包	为特定硬件平台提供预配置方案

项目限制

本项目为个人维护的开源项目，资源有限，无商业运营计划

• 不提供内置免费内网穿透服务，相关问题请自行解决
• 不提供24×7小时技术支持服务
• 不承诺系统稳定性和合规性，使用风险需自行承担
• 尽力优化用户体验，但仍需要一定的技术基础

功能对比

💡 说明： 以下表格展示了 One-KVM 与其他基于 PiKVM 项目的功能对比，仅供参考。如有遗漏或错误，欢迎联系更正。

功能特性	One-KVM	PiKVM	ArmKVM	BLIKVM
简体中文 WebUI	✅	❌	✅	✅
远程视频流	MJPEG/H.264	MJPEG/H.264	MJPEG/H.264	MJPEG/H.264
H.264 视频编码	CPU	GPU	未知	GPU
远程音频流	✅	✅	✅	✅
远程鼠键控制	OTG/CH9329	OTG/CH9329/Pico/Bluetooth	OTG	OTG
VNC 控制	✅	✅	✅	✅
ATX 电源控制	GPIO/USB 继电器	GPIO	GPIO	GPIO
虚拟存储驱动器挂载	✅	✅	✅	✅
网页终端	✅	✅	✅	✅
Docker 部署	✅	❌	❌	❌
商业化运营	❌	✅	✅	✅

⚡ 快速开始

方式一：Docker 镜像部署（推荐）

Docker 版本支持 OTG 或 CH9329 作为虚拟 HID，兼容 amd64、arm64、armv7 架构的 Linux 系统。

一键脚本部署

curl -sSL https://one-kvm.mofeng.run/quick_start.sh -o quick_start.sh && bash quick_start.sh

手动部署

使用 OTG 作为虚拟 HID：

sudo docker run --name kvmd -itd --privileged=true \
    -v /lib/modules:/lib/modules:ro -v /dev:/dev \
    -v /sys/kernel/config:/sys/kernel/config -e OTG=1 \
    -p 8080:8080 -p 4430:4430 -p 5900:5900 -p 623:623 \
    silentwind0/kvmd

使用 CH9329 作为虚拟 HID：

sudo docker run --name kvmd -itd \
    --device /dev/video0:/dev/video0 \
    --device /dev/ttyUSB0:/dev/ttyUSB0 \
    --device /dev/snd:/dev/snd \
    -p 8080:8080 -p 4430:4430 -p 5900:5900 -p 623:623 \
    silentwind0/kvmd

方式二：直刷 One-KVM 整合包

针对特定硬件平台，提供了预配置的 One-KVM 打包镜像，简化部署流程，实现开箱即用。

固件下载

GitHub 下载：

• GitHub Releases： https://github.com/mofeng-git/One-KVM/releases

其他下载方式：

• 免登录下载： https://pan.huang1111.cn/s/mxkx3T1 （由 Huang1111公益计划 提供）
• 百度网盘： https://pan.baidu.com/s/166-2Y8PBF4SbHXFkGmFJYg?pwd=o9aj （提取码：o9aj）

支持的硬件平台

固件型号	固件代号	硬件配置	最新版本	状态
玩客云	Onecloud	USB 采集卡、OTG	241018	✅
私家云二代	Cumebox2	USB 采集卡、OTG	241004	✅
Vmare	Vmare-uefi	USB 采集卡、CH9329	241004	✅
Virtualbox	Virtualbox-uefi	USB 采集卡、CH9329	241004	✅
s905l3a 通用包	E900v22c	USB 采集卡、OTG	241004	✅
我家云	Chainedbox	USB 采集卡、OTG	241004	✅
龙芯久久派	2k0300	USB 采集卡、CH9329	241025	✅

🤝 贡献指南

欢迎各种形式的贡献！

如何贡献

1. Fork 本仓库
2. 创建功能分支： git checkout -b feature/AmazingFeature
3. 提交更改： git commit -m 'Add some AmazingFeature'
4. 推送到分支： git push origin feature/AmazingFeature
5. 提交 Pull Request

报告问题

如果您发现了问题，请：

1. 使用 GitHub Issues 报告
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

• ......

赞助商

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

CDN 加速及安全防护：

• Tencent EdgeOne - 提供 CDN 加速及安全防护服务

文件存储服务：

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

📚 其他

使用的开源项目

本项目基于以下优秀开源项目进行二次开发：

• PiKVM - 开源的 DIY IP-KVM 解决方案