2026-07-08 08:22:27 +08:00
2026-07-08 00:04:59 +08:00
2026-07-05 21:30:11 +08:00
2026-07-08 00:06:33 +08:00
2025-12-28 18:19:16 +08:00
2026-05-24 09:44:41 +00:00
2026-07-08 00:04:59 +08:00
2026-07-08 00:06:33 +08:00
2026-04-29 10:38:30 +08:00
2026-07-08 08:22:27 +08:00
2026-07-08 08:22:27 +08:00
2026-07-08 00:06:33 +08:00

One-KVM

An open, lightweight IP-KVM stack in Rust — remote management down to BIOS level

简体中文 · English

GitHub Release GitHub stars GitHub forks GitHub issues


Overview

One-KVM (Rust) is a lightweight IP-KVM solution written in Rust. It lets you manage servers and workstations over the network, including at BIOS level.

Goals: an open, lightweight, easy-to-use IP-KVM stack.

  • Open: not tied to one hardware recipe; runs across many setups.
  • Lightweight: shipped as a binary with minimal moving parts for deployment.
  • Easy to use: no hand-edited config files required; settings are done in the web UI.

For more information, see the One-KVM Rust documentation.

One-KVM (Python) is no longer maintained. If you still need it, see https://github.com/mofeng-git/One-KVM/tree/python.

One-KVM web console

Features

Core

Area Capabilities
Video capture HDMI USB / MIPI CSI / RK3588 HDMI IN; MJPEG and WebRTC (H.264 / H.265 / VP8 / VP9)
Video encoding VAAPI / QSV / RKMPP / V4L2 M2M hardware paths, with software fallback
Keyboard & mouse USB OTG HID or CH340 + CH9329 HID; absolute / relative mouse
Virtual media USB mass storage; ISO/IMG mount and Ventoy-style virtual USB
ATX power GPIO or USB relay; power control
Audio ALSA capture + Opus (HTTP / WebRTC)

Installation

Release artifacts are on GitHub Releases. Below are short paths for common setups. For system requirements, hardware, Docker env vars, USB OTG, and full troubleshooting, see the One-KVM documentation (Chinese; use a translator if needed).

Debian / Ubuntu (.deb)

Download a one-kvm_*.deb matching your CPU architecture from Releases, then from the directory containing the package:

sudo apt update
sudo apt install ./one-kvm_0.x.x_<arch>.deb

Replace the version and architecture in the filename with your actual file name.

Docker

Images:

  • one-kvm — main app + ttyd
  • one-kvm-full — same plus optional extras (e.g. gostc, easytier-core)

Example:

docker run --name one-kvm -itd \
  --privileged=true --restart unless-stopped \
  -v /dev:/dev -v /sys:/sys \
  --net=host \
  silentwind0/one-kvm-full

If pulls are slow, use the Aliyun mirror, e.g. registry.cn-hangzhou.aliyuncs.com/silentwind/one-kvm-full (and registry.cn-hangzhou.aliyuncs.com/silentwind/one-kvm for the slim image).

fnOS NAS (Feiniu / 飞牛)

One-KVM is listed in the fnOS app store; search and install on your NAS.

Web UI and first run

Open http://<device-ip>:8080 in a browser (8420 after fnOS install). The first visit runs initial setup.

Reporting issues

If something breaks:

  1. Open GitHub Issues or report in the project QQ group.
  2. Include useful error messages and steps to reproduce.
  3. Mention software version, hardware, and OS details.

Sponsorship

One-KVM builds on many great open-source projects; a lot of time goes into testing and maintenance. If you find it useful, you can support development on Afdian (为爱发电).

Thanks

Supporter list
  • 浩龙的电子嵌入式之路

  • 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

  • 爱发电用户_97b41

  • 偶然

  • 爱发电用户_dba45

  • 爱发电用户_d4f8b

  • 故人。

  • ......

Sponsors

File hosting

Cloud

林枫云

林枫云 offers premium network routes, high-frequency game servers, and high-bandwidth servers in China and abroad.

BTBT

Remote computers, consumer GPU servers, and dedicated physical machines with fully automated online delivery.

Description
One-KVM 是基于廉价计算机硬件和 PiKVM 软件二次开发的 BIOS 级远程控制项目。
Readme GPL-3.0 58 MiB
Languages
Rust 56.8%
Vue 16.1%
C 10.5%
TypeScript 6.7%
C++ 3.3%
Other 6.5%