mirror of
https://github.com/mofeng-git/One-KVM.git
synced 2026-04-29 17:36:35 +08:00
234 lines
5.9 KiB
Markdown
234 lines
5.9 KiB
Markdown
<div align="center">
|
||
<h1>One-KVM</h1>
|
||
<p><strong>Rust 编写的开放轻量 IP-KVM 解决方案，实现 BIOS 级远程管理</strong></p>
|
||
|
||
<p><a href="README.md">简体中文</a> · <a href="README.en.md">English</a></p>
|
||
|
||
[](https://github.com/mofeng-git/One-KVM/releases)
|
||
[](https://github.com/mofeng-git/One-KVM/stargazers)
|
||
[](https://github.com/mofeng-git/One-KVM/network/members)
|
||
[](https://github.com/mofeng-git/One-KVM/issues)
|
||
</div>
|
||
|
||
---
|
||
|
||
## 📖 项目概述
|
||
|
||
**One-KVM Rust** 是一个用 Rust 编写的轻量级 IP-KVM 解决方案，可通过网络远程管理服务器和工作站，实现 BIOS 级远程控制。
|
||
|
||
项目目标：提供一个开放、轻量、易用的 IPKVM 解决方案。
|
||
|
||
- **开放**：不绑定特定硬件配置，可在各类硬件环境中稳定运行。
|
||
- **轻量**：以二进制文件形式分发，无繁杂的依赖项，部署过程简单。
|
||
- **易用**：无需手动编辑配置文件，参数设置均可通过网页界面完成。
|
||
|
||
> **One-KVM Python** 已停止开发，如有需要可访问 <https://github.com/mofeng-git/One-KVM/tree/python>。
|
||
|
||
<div align="center">
|
||
|
||
|
||
|
||
</div>
|
||
|
||
## 📊 功能介绍
|
||
|
||
### 核心功能
|
||
|
||
| 功能 | 能力说明 |
|
||
|------|------|
|
||
| 视频采集 | 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](https://github.com/mofeng-git/One-KVM/releases)。以下为常见安装方式的简要步骤；**系统要求、硬件准备、Docker 环境变量与 USB OTG 等完整说明**请查阅 [One-KVM Rust 文档站点](https://docs.one-kvm.cn/)。
|
||
|
||
### 使用 deb 安装（Debian / Ubuntu）
|
||
|
||
从 Releases 下载与本机架构匹配的 `one-kvm_*.deb`，在包所在目录执行：
|
||
|
||
```bash
|
||
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 等可选扩展），按需选用。
|
||
|
||
```bash
|
||
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](https://github.com/mofeng-git/One-KVM/issues) 报告，或加入 QQ 群聊反馈。
|
||
2. 提供有帮助的错误信息和复现步骤
|
||
3. 包含您使用的软件版本、硬件配置和系统信息
|
||
|
||
## 赞助支持
|
||
|
||
本项目基于多个优秀开源项目进行二次开发，作者投入了大量时间进行测试和维护。如果您觉得这个项目有价值，欢迎通过 **[为爱发电](https://afdian.com/a/silentwind)** 支持项目发展。
|
||
|
||
### 感谢名单
|
||
|
||
<details>
|
||
<summary><strong>点击查看感谢名单</strong></summary>
|
||
|
||
- 浩龙的电子嵌入式之路
|
||
|
||
- 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
|
||
|
||
- ......
|
||
|
||
</details>
|
||
|
||
### 赞助商
|
||
|
||
本项目得到以下赞助商的支持：
|
||
|
||
**镜像下载服务：**
|
||
- **[重庆大学开源软件镜像站](https://mirrors.cqu.edu.cn/)** - 提供镜像站下载服务
|
||
|
||
**文件存储服务：**
|
||
- **[Huang1111公益计划](https://pan.huang1111.cn/s/mxkx3T1)** - 提供免登录下载服务
|
||
|
||
**云服务商**
|
||
|
||
- **[林枫云](https://www.dkdun.cn)** - 赞助了本项目服务器
|
||
|
||
|
||
|
||
林枫云主营国内外地域的精品线路业务服务器、高主频游戏服务器和大带宽服务器。
|