One-KVM

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

简体中文 | English

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

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

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

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

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

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

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

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

推荐使用 --net=host 网络模式以获得更好的 wol 功能和 webrtc 通信支持。

docker host 网络模式：

端口 8080：HTTP Web 服务
端口 4430：HTTPS Web 服务
端口 5900：VNC 服务
端口 623：IPMI 服务
端口 20000-40000：WebRTC 通信端口范围，用于低延迟视频传输
端口 9（UDP）：Wake-on-LAN（WOL）唤醒功能

docker host 模式：

使用 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 \
    --net=host \
    silentwind0/kvmd

使用 CH9329 作为虚拟 HID：

sudo docker run --name kvmd -itd \
    --device /dev/video0:/dev/video0 \
    --device /dev/ttyUSB0:/dev/ttyUSB0 \
    --net=host \
    silentwind0/kvmd

docker bridge 模式：

使用 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 \
    -p 8080:8080 -p 4430:4430 -p 5900:5900 -p 623:623 \
    silentwind0/kvmd

针对特定硬件平台，提供了预配置的 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）

欢迎各种形式的贡献！

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. 包含您的硬件配置和系统信息

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

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

CDN 加速及安全防护：

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

文件存储服务：

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

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

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