From 02fa7696c832c4ba476852f93a3831bee9b61a4a Mon Sep 17 00:00:00 2001 From: mofeng-git Date: Thu, 26 Sep 2024 22:53:49 +0800 Subject: [PATCH] =?UTF-8?q?=E6=9B=B4=E6=96=B0=E8=AF=B4=E6=98=8E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 85 ++++++++++++++++++++----------------------------------- 1 file changed, 30 insertions(+), 55 deletions(-) diff --git a/README.md b/README.md index 16bee0e5..6eafe1b7 100644 --- a/README.md +++ b/README.md @@ -4,77 +4,45 @@ ### 介绍 -One-KVM 是基于廉价计算机硬件和PiKVM软件的硬件级远程控制项目。KVM over IP 可以远程管理服务器或工作站,实现无侵入式控制,无论被控机为什么操作系统或是否安装了操作系统,具有更广泛的适用性。此项目基于 [PiKVM](https://github.com/pikvm/pikvm),和基于远控软件的远程管理方式不同,无需在被控电脑安装任何软件,实现无侵入式控制。 +One-KVM 是基于廉价计算机硬件和 [PiKVM]((https://github.com/pikvm/pikvm)) 软件二次开发的 BIOS 级远程控制项目。可以实现远程管理服务器或工作站,无需在被控机安装软件调整设置,实现无侵入式控制,适用范围广泛。 + +演示网站:[https://kvmd-demo.mofeng.run](https://kvmd-demo.mofeng.run) + ### 快速开始 **方式一:Docker 镜像部署(推荐)** -目前 Docker 版只能使用 CH9329 作为虚拟 HID ,支持 amd64、arm64、armv7 架构的 Linux 系统安装。 +Docker 版本可以使用 OTG 或 CH9329 作为虚拟 HID ,支持 amd64、arm64、armv7 架构的 Linux 系统安装。 -当前只有dev分支,尚未发布稳定版本,演示网站(账号密码:admin/admin):https://kvmd-demo.mofeng.run/ -部署命令: +如果使用 OTG 作为虚拟 HID,可以使用如下部署命令: ```bash -sudo docker run --name kvmd -itd \ - --device /dev/video0:/dev/kvmd-video \ - --device /dev/ttyUSB0:/dev/kvmd-hid \ +sudo docker run --name kvmd -itd --privileged=true \ + -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 \ - registry.cn-hangzhou.aliyuncs.com/silentwind/kvmd:dev + silentwind0/kvmd ``` -部署完成访问 http://IP:8080 即可开始使用,默认密码:admin/admin。如无法访问可以使用 `sudo docker logs kvmd` 命令查看日志尝试修复、提交 issue 或在 QQ 群内寻求帮助。 - -如果暂时相关没有 USB 设备或只想要查看新版特性,可以使用以下命令启动一个无 USB 硬件的应用(演示模式): +如果使用 CH9329,可以使用如下部署命令: ```bash sudo docker run --name kvmd -itd \ - --device /dev/tty10:/dev/kvmd-hid \ + --device /dev/video0:/dev/video0 \ + --device /dev/ttyUSB0:/dev/ttyUSB0 \ -p 8080:8080 -p 4430:4430 -p 5900:5900 -p 623:623 \ - registry.cn-hangzhou.aliyuncs.com/silentwind/kvmd:dev + silentwind0/kvmd ``` -详细内容可以参照 [One-KVM文档](https://one-kvm.mofeng.run/)。 +部署完成访问 https://IP:4430 ,点击信任自签证书,即可开始使用,默认账号密码:admin/admin。 + +如无法访问可以使用 `sudo docker logs kvmd` 命令查看日志尝试修复、提交 issue 或在 QQ 群内寻求帮助。 + +详细内容可以查阅 [One-KVM文档](https://one-kvm.mofeng.run/)。 **方式二:直刷 One-KVM 镜像** 对于玩客云设备,本项目 Releases 页可以找到适配玩客云的 One-KVM 预编译镜像。镜像名称带 One-KVM 前缀、burn 后缀的为线刷镜像,可使用 USB_Burning_Tool 软件线刷至玩客云。预编译线刷镜像为开箱即用,刷好后启动设备就可以开始使用 One-KVM。 -**方式三:One-KVM 脚本安装**(暂停维护) - -**作者目前只是个人业余开发者,能力有限,难以覆盖和测试多种多样硬件设备和系统,故此一键脚本暂时停止维护。** - -目前已将开发中心转移至 Docker 平台,推荐使用 Docker 方式部署。若仍有需要可通过 Releases 页找到项目历史存档。 - -### 功能特性 - -**Docker 版本中以下特性尚未全部实现,但包含在将来的开发计划中** - -主要功能比较,TinyPilot 社区版本、PiKVMv3 版本出现在这里仅做比较目的。 -| 功能 | One-KVM | TinyPilot 社区版本 | PiKVMv3版本 | -| :------------: | :---------------------: | :----------------: | :----------: | -| HTML5界面语言 | 简体中文 | 英文 | 英文 | -| BIOS控制 | √ | √ | √ | -| 视频捕捉 | √ | √ | √ | -| 音频捕捉 | × | √ | √ | -| 鼠键捕获类型 | OTG CH9329 | OTG | OTG CH9329 | -| 从剪贴板粘贴 | √ | √ | √ | -| OCR识别 | √ | × | √ | -| LAN唤醒 | √ | × | √ | -| VNC支持 | √ | × | √ | -| HDMI环出 | √(含HDMI设备初步支持) | × | × | -| 虚拟存储驱动器 | √(仅含OTG设备支持) | × | √ | -| ATX开关机 | √(仅含GPIO设备支持) | × | √ | -| 板载WiFi | × | √ | √ | -| 视频流格式 | MJPEG H.264(软编码) | MJPEG, H.264 | MJPEG, H.264 | -| 最大视频分辨率 | 1920x1080 | 1920x1080 | 1920x1080 | - -### 已测试设备 - - - 玩客云 - - X64 主机 - - Vmare 虚拟机 - - VPS(仅演示模式) - **赞助** @@ -110,13 +78,20 @@ Will [远方](https://runyf.cn/) +- 爱发电用户_399fc + +- [斐斐の](https://www.mmuaa.com/) + ...... - -**Star历史** - -[![Star 历史](https://api.star-history.com/svg?repos=mofeng-git/One-KVM&type=Date)](https://star-history.com/#mofeng-git/One-KVM&Date) - 本项目使用了下列开源项目: 1. [pikvm/pikvm: Open and inexpensive DIY IP-KVM based on Raspberry Pi (github.com)](https://github.com/pikvm/pikvm) + +**状态** + +[![Star History Chart](https://api.star-history.com/svg?repos=mofeng-git/One-KVM&type=Date)](https://star-history.com/#mofeng-git/One-KVM&Date) + +![Github](https://repobeats.axiom.co/api/embed/7cfaab47e31073107771a7179078aa2a6c3f1108.svg "Repobeats analytics image") + +