Merge pull request #892 from Z2Z-GuGu/main

Update NanoKVM Doc
This commit is contained in:
BuGu
2025-11-27 09:58:57 +08:00
committed by GitHub
8 changed files with 67 additions and 6 deletions

View File

@@ -1,4 +1,13 @@
# Access NanoKVM over the Internet with Cloudflare Tunnel (`cloudflared`)
---
title: Access NanoKVM over the Internet with Cloudflare Tunnel (`cloudflared`)
keywords: NanoKVM, Remote desktop, Lichee, PiKVM, RISCV, tool
update:
- date: 2025-11-16
version: v0.1
author: Johnnybyzhang
content:
- Release docs
---
Cloudflare Tunnel lets NanoKVM establish a secure **outboundonly** connection to Cloudflare, so you dont need public IPs, portforwarding, or inbound firewall holes. PiKVM documents a systemd flow; NanoKVM uses BusyBox `init`, so service setup differs.

View File

@@ -263,6 +263,25 @@ The TF card is mounted by default under the NanoKVM system's `/sdcard` directory
> The first batch of Desk versions does not support TF card hot-plugging. Please insert the TF card when the device is powered off.
> The Virtual U Disk and image mounting functions cannot be enabled simultaneously.
## How to Perform Remote OS Installation
+ In addition to simulating keyboard and mouse devices, the USB-C port of NanoKVM Pro also emulates a USB drive device. This can be used to mount specified ISO files for tasks like OS installation. ISO files can be uploaded to the NanoKVM-Pro, which offers approximately 21GB of available space.
+ Unlike a regular USB drive, NanoKVM's virtual USB drive can store multiple ISO files simultaneously. Before powering on the target host, you can select which system ISO to mount via the options on the web interface.
After connecting the remote host and Nano KVM as described in the previous steps, log into the system via your browser. Click the CD-ROM icon and select the target system ISO to mount it.
![](./../../../assets/NanoKVM/guide/imgsl.png)
Next, begin the OS installation process. Click `Power On (Short Press)`, then quickly press the F11 key (the key may vary for different hosts; please refer to your host's manual). Select the corresponding bootable ISO to start and complete the installation.
![](./../../../assets/NanoKVM/guide/install.png)
Note:
+ All uploaded ISO files are stored in the `/data` directory of the NanoKVM-Pro. Users can directly read and write this partition from within the NanoKVM terminal.
+ If you encounter issues mounting the ISO, try ejecting the ISO from the host first, then click to mount it again.
## How to Set a Static IP
NanoKVM-Pro introduced static IP configuration for Ethernet cards in version `1.1.6` and above. You can assign a static IP by configuring the `/boot/eth.nodhcp` file. The detailed setup method is as follows:

View File

@@ -1,5 +1,5 @@
---
title: NanoKVM Desk mini UI
title: NanoKVM Desk Screen & Knob
keywords: NanoKVM, Auxiliary Screen
update:
- date: 2025-10-10

View File

@@ -538,6 +538,8 @@ items:
file: kvm/NanoKVM/network/frp.md
- label: Static IP
file: kvm/NanoKVM/network/static_ip.md
- label: Cloudflare
file: kvm/NanoKVM/network/cloudflared.md
- label: System
items:
- label: System Introduction
@@ -572,7 +574,7 @@ items:
file: kvm/NanoKVM_Pro/desk_start.md
- label: Advanced Applications
file: kvm/NanoKVM_Pro/extended.md
- label: Mini UI
- label: Screen & Knob
file: kvm/NanoKVM_Pro/lcd.md
- label: DIY Applications
file: kvm/NanoKVM_Pro/app_diy.md

View File

@@ -1,4 +1,14 @@
# 使用 Cloudflare Tunnelcloudflared让 NanoKVM 安全远程访问
---
title: 使用 Cloudflare Tunnelcloudflared让 NanoKVM 安全远程访问
keywords: NanoKVM, Remote desktop, Lichee, PiKVM, RISCV, tool
update:
- date: 2025-11-16
version: v0.1
author: Johnnybyzhang
content:
- Release docs
---
Cloudflare Tunnel 能让 NanoKVM 通过 **仅出站连接** 安全地接入 Cloudflare无需公网 IP、端口转发或开放入站防火墙规则。PiKVM 文档主要介绍 systemd 方案,而 NanoKVM 基于 BusyBox `init`,服务管理方式不同。

View File

@@ -210,6 +210,25 @@ TF卡默认挂载与 NanoKVM 系统 `/sdcard` 目录下,当开启`虚拟U盘`
> 首批Desk版本TF卡无法热拔插请在关机状态下插入TF卡
> 虚拟U盘和镜像挂载功能不可同时开启
## 如何远程装机
+ NanoKVM Pro 的 USB-C 端口除模拟键鼠设备外还模拟了一个U盘设备可挂载指定的镜像用于装机等需求镜像可以上传至NanoKVM-Pro中可用空间约21G。
+ 与普通U盘不同NanoKVM的虚拟U盘内可同时存放多个镜像开机之前可以通过 web 页面的选项选择要安装的系统镜像进行挂载。
按上述步骤连接远程主机与Nano KVM在浏览器登录系统后点击光盘图标选中待安装的系统即可实现ISO挂载
![](./../../../assets/NanoKVM/guide/imgsl.png)
接下来开始装机操作,点击`开机(短按)`迅速按键盘上的F11键不同主机按键可能不同请参照主机说明选择对应的镜像启动并完成装机流程。
![](./../../../assets/NanoKVM/guide/install.png)
注:
+ 所有上传的镜像将储存于NanoKVM-Pro的 `/data` 目录,用户可在 NanoKVM 终端内直接读写该分区
+ 若挂载镜像出现问题,可以尝试在主机上弹出镜像后再点击挂载
## 如何设置静态IP
NanoKVM-Pro 在`1.1.6`及以上版本中加入了以太网卡的静态IP设置功能通过配置`/boot/eth.nodhcp`文件来主动赋予IP详细设置方法如下

View File

@@ -1,5 +1,5 @@
---
title: NanoKVM Desk 迷你UI
title: NanoKVM Desk 触摸屏&旋钮
keywords: NanoKVM, Auxiliary Screen
update:
- date: 2025-10-10

View File

@@ -508,6 +508,8 @@ items:
file: kvm/NanoKVM/network/frp.md
- label: 静态 IP
file: kvm/NanoKVM/network/static_ip.md
- label: Cloudflare
file: kvm/NanoKVM/network/cloudflared.md
- label: 系统
items:
- label: 系统介绍
@@ -570,7 +572,7 @@ items:
file: kvm/NanoKVM_Pro/desk_start.md
- label: 高级应用
file: kvm/NanoKVM_Pro/extended.md
- label: 迷你UI
- label: 触摸屏&旋钮
file: kvm/NanoKVM_Pro/lcd.md
- label: DIY 应用
file: kvm/NanoKVM_Pro/app_diy.md