docs(nanokvm-go): refactor quick start and align flashing guide (#1022)

* docs(NanoKVM-Go): refactor quick start for a continuous first-use flow

* docs(NanoKVM-Go): rework flashing guide and sync en/zh
This commit is contained in:
梁子月
2026-09-04 14:40:06 +08:00
committed by GitHub
parent 5960699cee
commit 45282d8958
27 changed files with 198 additions and 97 deletions

Binary file not shown.

Before

Width:  |  Height:  |  Size: 21 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 21 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 5.3 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 5.2 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 12 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 12 KiB

After

Width:  |  Height:  |  Size: 8.3 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 11 KiB

After

Width:  |  Height:  |  Size: 7.9 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 12 KiB

View File

Before

Width:  |  Height:  |  Size: 261 KiB

After

Width:  |  Height:  |  Size: 261 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 9.3 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 9.0 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 5.4 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 22 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 20 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 4.4 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 5.3 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 5.4 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 5.1 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 3.0 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 3.5 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 33 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 30 KiB

View File

@@ -9,26 +9,26 @@ keywords: NanoKVM Go, Remote desktop, KVM, USB-C
The NanoKVM Go package includes the NanoKVM Go device, a full-featured USB-C data cable, and a connection guide card. The exact accessories may vary by purchase version.
## Interface Overview
## Ports and Controls
![NanoKVM Go interface overview](./../../../assets/NanoKVM/go/quick_start/nanokvm-go-interface.webp)
![NanoKVM Go USB-C ports, flashing-mode button opening, and silkscreen symbols](./../../../assets/NanoKVM/go/quick_start/nanokvm-go-interfaces.svg)
NanoKVM Go has two Type-C ports and one reset hole on the side:
NanoKVM Go has two USB-C ports and a flashing-mode button opening on the side. Use the silkscreen symbols to identify them:
+ The port with the lightning icon is the Power Port for external power input;
+ The port with the screen icon is the Data Port for connecting to the controlled device;
+ The small hole between the two ports is the Reset Button for resetting the device.
+ **Main USB-C port (display icon, Data Port):** connects to the target and carries DP Alt Mode video and audio, keyboard and mouse emulation, a virtual USB drive, and a virtual network interface.
+ **Auxiliary USB-C port (lightning icon, Power Port):** accepts USB-PD power, provides charging passthrough to the target, and carries the expansion IO used by the Finger Robot.
+ **Flashing-mode button opening:** hold the recessed button with a SIM eject pin while connecting the main USB-C port to enter system flashing mode. This button does not reset or restart the device. See [Flashing](./system/flashing.html) for the full procedure.
## Before You Start
Prepare the following devices and accessories before using NanoKVM Go:
+ A controlled device with a Type-C data port, and the port must support DP Alt Mode video output;
+ A full-featured Type-C data cable for connecting NanoKVM Go to the controlled device;
+ A target device with a USB-C port that supports DP Alt Mode video output;
+ A full-featured USB-C cable for connecting NanoKVM Go to the target device;
+ A control device with a browser, such as a computer, tablet, or phone;
+ If the controlled device cannot provide stable power to NanoKVM Go, prepare an additional USB-C power adapter.
> Type-C ports that only support charging or regular data transfer cannot output video and may not work with NanoKVM Go's remote display feature.
> USB-C ports that only support charging or regular data transfer cannot output video and cannot be used with NanoKVM Go's remote display feature.
## Connect Devices
@@ -36,71 +36,120 @@ Prepare the following devices and accessories before using NanoKVM Go:
Connection steps:
1. Use a full-featured Type-C data cable to connect the NanoKVM Go Data Port to a Type-C port on the controlled device that supports DP Alt Mode.
2. If the controlled device cannot power NanoKVM Go, use the power port to power NanoKVM Go separately.
1. Use a full-featured USB-C cable to connect the main USB-C port (display icon) on NanoKVM Go to a USB-C port on the target that supports DP Alt Mode.
2. If the target cannot power NanoKVM Go reliably, connect a USB-C power adapter to the auxiliary USB-C port (lightning icon).
3. Wait for NanoKVM Go to boot. The screen will show the current status and IP address.
## Network Configuration
NanoKVM Go needs to be connected to the network before first use.
Configure the network the first time NanoKVM Go is used or after changing Wi-Fi networks. Before starting, make sure NanoKVM Go is powered on, the Wi-Fi signal covers the area where NanoKVM Go is located, and the target SSID and password are ready.
1. Open the device Wi-Fi page and make sure the Wi-Fi switch is enabled.
2. Open the configuration method page and choose either `PASSWD` or `QRCODE`.
3. Follow the prompts to enter the Wi-Fi SSID and password, then submit the configuration.
4. After configuration is complete, return to the main screen. If the device IP address is displayed on the main screen, the connection is successful.
> NanoKVM Go supports both 2.4 GHz and 5 GHz Wi-Fi. For a more stable remote-control experience, use a 5 GHz Wi-Fi network when available.
![NanoKVM Go main screen with IP address](./../../../assets/NanoKVM/go/user_guide/nanokvm-go-main-screen.webp)
Swipe left from the NanoKVM Go main screen to open `Settings`, then tap the Wi-Fi icon. On the `WI-FI` page, tap `Connect Wi-Fi`.
For detailed configuration steps, refer to the [Network Configuration section in the User Guide](./user_guide.html#Network-Configuration).
<video src="./../../../assets/NanoKVM/go/quick_start/nanokvm-go-open-wifi.mp4" aria-label="Open the NanoKVM Go Wi-Fi setup page" style="width: 100%; max-width: 360px;" playsinline controls autoplay loop muted preload="metadata"></video>
NanoKVM Go supports two Wi-Fi setup methods: `PASSWD` and `QRCODE`. `PASSWD` is suitable for selecting Wi-Fi and entering the password directly on the NanoKVM Go screen. `QRCODE` is suitable for entering Wi-Fi information from a phone.
![NanoKVM Go Wi-Fi setup methods](./../../../assets/NanoKVM/go/quick_start/nanokvm-go-wifi-via.webp)
### Configure with PASSWD
1. Select `PASSWD` on the `Via` page. NanoKVM Go scans nearby Wi-Fi networks.
2. Swipe through the Wi-Fi list, select the SSID to connect to, then tap `>` in the upper-right corner to open the password page. To enter an SSID manually, select `Manual SSID`.
![NanoKVM Go Wi-Fi SSID selection](./../../../assets/NanoKVM/go/quick_start/nanokvm-go-wifi-ssid.webp)
3. Enter the Wi-Fi password with the on-screen keyboard, then tap `OK`.
![NanoKVM Go Wi-Fi password input](./../../../assets/NanoKVM/go/quick_start/nanokvm-go-wifi-password.webp)
> The on-screen keyboard uses multi-tap input similar to a 9-key keypad. When several letters share one key, tap once for the first letter, tap twice in succession for the second letter, and so on.
### Configure with QRCODE
1. Select `QRCODE` on the `Via` page. NanoKVM Go shows a `Connect to AP` QR code.
2. Scan the `Connect to AP` QR code with a phone and follow the phone prompt to connect to the temporary NanoKVM Go hotspot. After the phone connects, the QR code on NanoKVM Go changes to `Configure WiFi`.
![NanoKVM Go temporary hotspot QR code](./../../../assets/NanoKVM/go/quick_start/nanokvm-go-connect-ap-qr.webp)
3. Scan the `Configure WiFi` QR code with the phone again. The browser opens the Wi-Fi configuration page.
![NanoKVM Go Wi-Fi configuration QR code](./../../../assets/NanoKVM/go/quick_start/nanokvm-go-configure-wifi-qr.webp)
4. Enter the Wi-Fi SSID and password on the page, then tap `Ok`. Keep NanoKVM Go powered on while it connects.
![NanoKVM Go phone Wi-Fi configuration page](./../../../assets/NanoKVM/go/quick_start/nanokvm-go-wifi-config-page-en.webp)
### Confirm the Connection
After setup is complete, the `WI-FI` page shows the current SSID and IP address. Connect the control device to the same network and enter this IP address in a browser to open the web control page.
![NanoKVM Go network connected](./../../../assets/NanoKVM/go/quick_start/nanokvm-go-network-success.webp)
## Basic Remote Control
After network configuration is complete, enter the obtained IP address directly in the browser address bar to open the NanoKVM Go login page. The default username is `admin`, and the default password is `admin`.
After network configuration is complete, choose the access method based on the network where the control device and NanoKVM Go are located.
![NanoKVM Go login page](./../../../assets/NanoKVM/go/quick_start/nanokvm-go-login-page.webp)
### Access on the Same LAN
After logging in, you can view the controlled device screen and perform keyboard and mouse operations. The web control page usually consists of a floating toolbar and a display area: the top floating toolbar is used to access Image Settings, Portrait Mode, Volume Settings, Microphone, On-Screen Keyboard, Mouse Style, Interface Preview, Image Mounting, Custom Scripts, KVM Web Terminal, Settings, Full Screen, and other features. The center display area is used to view and operate the controlled device screen.
If the control device and NanoKVM Go are connected to the same reachable LAN, enter the IP address shown on the `WI-FI` page in the browser address bar to open the NanoKVM Go login page. The default username is `admin`, and the default password is `admin`.
![NanoKVM Go control page after login](./../../../assets/NanoKVM/go/quick_start/nanokvm-go-control-page.webp)
![NanoKVM Go login page](./../../../assets/NanoKVM/go/quick_start/nanokvm-go-login-page-en.webp)
+ The display area is used to view the controlled device screen;
+ The floating toolbar is used to access Image Settings, Portrait Mode, Volume Settings, Microphone, On-Screen Keyboard, Mouse Style, Interface Preview, Image Mounting, Custom Scripts, KVM Web Terminal, Settings, Full Screen, and other features;
+ If no image is displayed, confirm that the controlled device's Type-C port supports DP Alt Mode and that the cable is a full-featured Type-C data cable.
After logging in, you can view and control the target device screen.
### Access from Outside the LAN
If the control device and NanoKVM Go are not on the same LAN, configure Tailscale first. After NanoKVM Go and the control device join the same Tailscale network, enter the Tailscale IP address of NanoKVM Go in the browser on the control device to access NanoKVM Go remotely.
For the complete setup procedure, see [Tailscale Remote Access](./network/tailscale.html).
### Notes for Phone Connections
When using a phone as the controlled device, pay attention to system connection prompts and adjust the relevant settings for the phone system:
When using a phone as the target device, pay attention to system connection prompts and adjust the relevant settings for the phone system.
+ On some Android phones, the first connection may trigger a wired projection, external display, or USB device connection confirmation. Allow the connection as prompted. If no prompt appears and video and control work normally, no additional settings are required. USB debugging is not required for NanoKVM Go;
#### Android Phones
+ When connecting an iPhone, enable AssistiveTouch. Go to `Settings` > `Accessibility` > `Touch` > `AssistiveTouch`, then turn on the `AssistiveTouch` switch;
On some Android phones, the first connection may trigger a wired projection, external display, or USB device connection confirmation. Allow the connection as prompted. If no prompt appears and video and control work normally, no additional settings are required. USB debugging is not required for NanoKVM Go.
#### iPhone
When connecting an iPhone, enable AssistiveTouch first. Go to `Settings` > `Accessibility` > `Touch` > `AssistiveTouch`, then turn on the `AssistiveTouch` switch.
1. Open Accessibility.
![Accessibility in iPhone Settings](./../../../assets/NanoKVM/go/quick_start/nanokvm-go-iphone-open-accessibility-en.webp)
![Accessibility in iPhone Settings](./../../../assets/NanoKVM/go/quick_start/nanokvm-go-iphone-open-accessibility-en.webp)
2. Open Touch.
![Touch in iPhone Accessibility settings](./../../../assets/NanoKVM/go/quick_start/nanokvm-go-iphone-open-touch-en.webp)
![Touch in iPhone Accessibility settings](./../../../assets/NanoKVM/go/quick_start/nanokvm-go-iphone-open-touch-en.webp)
3. Open AssistiveTouch.
![AssistiveTouch in iPhone Touch settings](./../../../assets/NanoKVM/go/quick_start/nanokvm-go-iphone-open-assistive-touch-en.webp)
![AssistiveTouch in iPhone Touch settings](./../../../assets/NanoKVM/go/quick_start/nanokvm-go-iphone-open-assistive-touch-en.webp)
4. Turn on AssistiveTouch.
![AssistiveTouch switch on iPhone](./../../../assets/NanoKVM/go/quick_start/nanokvm-go-iphone-enable-assistive-touch-en.webp)
![AssistiveTouch switch on iPhone](./../../../assets/NanoKVM/go/quick_start/nanokvm-go-iphone-enable-assistive-touch-en.webp)
+ `Relative Mode` works on all platforms;
+ When connecting an Android phone, open Mouse Style from the floating toolbar. To use absolute positioning, select `Absolute Mode (Android)`; the standard `Absolute Mode` does not work on Android;
![NanoKVM Go Android mouse mode](./../../../assets/NanoKVM/go/quick_start/nanokvm-go-android-mouse-mode-en.webp)
+ For iPhone, click `Repair iPhone drag` on the web control page each time after the connection succeeds. If this option is not clicked, the mouse may stay in a pressed state.
For iPhone, click `Repair iPhone drag` on the web control page each time after the connection succeeds. If this option is not clicked, the mouse may stay in a pressed state.
![NanoKVM Go repair iPhone drag](./../../../assets/NanoKVM/go/quick_start/nanokvm-go-fix-iphone-drag-en.webp)
#### Mouse Mode
Click the mouse icon in the top floating toolbar of the web control page, open the `Mouse mode` menu, and select the input mode that matches the target device.
![NanoKVM Go mouse mode menu](./../../../assets/NanoKVM/go/quick_start/nanokvm-go-mouse-mode-en.webp)
+ `Follow Mouse`: suitable for computers and other regular desktop systems. The target pointer follows the pointer in the web page. Do not use this mode when the target device is an Android phone, as control will not work correctly.
+ `Follow Mouse (Better Android Compatibility)`: use this mode when the target device is an Android phone. It is adapted for Android pointer and touch input and provides better compatibility.
+ `Multi-touch Screen`: suitable when using a phone as the control device to operate another phone. It provides touch-style control and smoother interaction.
+ `Exclusive Mouse`: suitable for games, remote desktops, BIOS/UEFI, and other scenarios that need relative pointer movement or pointer lock.
## Security Recommendations
+ Change the default password after the first login. For details, see [User Guide - Change Password](./user_guide.html#Change-Password);

View File

@@ -10,7 +10,7 @@ keywords: NanoKVM Go, Remote desktop, KVM, flashing
Before flashing, prepare the following items:
- NanoKVM Go;
- a SIM eject pin or another tool that can press and hold the Reset button;
- a SIM eject pin or another tool that can press and hold the flashing-mode button;
- a USB data cable;
- a Windows computer;
- the NanoKVM Go image file;
@@ -20,7 +20,7 @@ Before flashing, prepare the following items:
Download the latest NanoKVM Go image from GitHub.
Image download link: TODO
Image download link: [NanoKVM-Go Releases](https://github.com/sipeed/NanoKVM-Go/releases)
## Download the Flashing Tool
@@ -30,21 +30,23 @@ Download and install [ImageUSB](https://www.osforensics.com/tools/write-usb-imag
## Enter Flashing Mode
1. Disconnect the USB cable from NanoKVM Go.
1. Disconnect the USB cable from NanoKVM Go to power off the device.
2. Use the SIM eject pin to press and hold the Reset button on NanoKVM Go.
2. Open ImageUSB on the computer.
![Press and hold the NanoKVM Go Reset button with a SIM eject pin](../../../../assets/NanoKVM/go/system/nanokvm_go_flashing_press_reset.webp)
3. Insert the SIM eject pin through the opening and press and hold the flashing-mode button on NanoKVM Go.
3. Keep holding the Reset button, connect the USB data cable to the NanoKVM Go data port, and connect the other end to the computer.
![Press and hold the NanoKVM Go flashing-mode button with a SIM eject pin](../../../../assets/NanoKVM/go/system/nanokvm_go_flashing_press_reset.webp)
![Hold Reset and connect the NanoKVM Go data port](../../../../assets/NanoKVM/go/system/nanokvm_go_flashing_connect_data_port.webp)
4. Keep holding the flashing-mode button, insert the USB data cable connected to the computer into the NanoKVM Go data port (Data Port).
4. Open ImageUSB and wait until it detects the USB device for NanoKVM Go.
![Hold the flashing-mode button and connect the NanoKVM Go data port](../../../../assets/NanoKVM/go/system/nanokvm_go_flashing_connect_data_port.webp)
![NanoKVM Go device detected in ImageUSB](../../../../assets/NanoKVM/go/system/nanokvm_go_flashing_device_detected.webp)
5. Click the Refresh Drives button in ImageUSB.
5. Release the Reset button after the device is detected.
![NanoKVM Go device detected in ImageUSB](../../../../assets/NanoKVM/go/system/nanokvm_go_flashing_refresh_drives.webp)
6. Release the flashing-mode button after the device is detected.
## Flash the Image with ImageUSB

View File

@@ -11,24 +11,24 @@ NanoKVM Go 包装内包含 NanoKVM Go 主机、全功能 USB-C 数据线和连
## 接口介绍
![NanoKVM Go 接口介绍](./../../../assets/NanoKVM/go/quick_start/nanokvm-go-interface.webp)
![NanoKVM Go USB-C 接口、烧录模式按键孔与丝印标识](./../../../assets/NanoKVM/go/quick_start/nanokvm-go-interfaces.svg)
NanoKVM Go 侧面有两个 Type-C 接口和一个复位孔
NanoKVM Go 侧面有两个 USB-C 接口和一个烧录模式按键孔,请根据机身丝印区分
+ 带闪电标志的接口为 Power Port用于外部供电
+ 带屏幕标志的接口为 Data Port用于连接被控设备
+ 两个接口中间的小孔为 Reset Button用于复位设备
+ **主 USB-C 接口屏幕图标Data Port**:连接被控设备,承载 DP Alt Mode 视频与音频、键盘和鼠标模拟、虚拟 U 盘及虚拟网卡。
+ **辅助 USB-C 接口闪电图标Power Port**:用于 USB-PD 供电和向被控设备充电直通,同时提供手指机器人所需的扩展 IO。
+ **烧录模式按键孔**:使用取卡针按住孔内按键并连接主 USB-C 接口,可使 NanoKVM Go 进入系统烧录模式。该按键不用于复位或重启设备,具体步骤请参考[烧录系统](./system/flashing.html)
## 使用前准备
使用 NanoKVM Go 前,请准备以下设备和配件:
+ 一台带 Type-C 数据接口的被控设备,并确认该接口支持 DP Alt Mode 视频输出;
+ 一根全功能 Type-C 数据线,用于连接 NanoKVM Go 与被控设备;
+ 一台带 USB-C 接口的被控设备,并确认该接口支持 DP Alt Mode 视频输出;
+ 一根全功能 USB-C 数据线,用于连接 NanoKVM Go 与被控设备;
+ 一台可打开浏览器的控制设备,例如电脑、平板或手机;
+ 如被控设备无法为 NanoKVM Go 稳定供电,请额外准备 USB-C 电源适配器。
> 仅支持充电或普通数据传输的 Type-C 接口无法输出画面,可能无法正常使用 NanoKVM Go 的远程显示功能。
> 仅支持充电或普通数据传输的 USB-C 接口无法输出画面,不能用于 NanoKVM Go 的远程显示功能。
## 连接设备
@@ -36,71 +36,120 @@ NanoKVM Go 侧面有两个 Type-C 接口和一个复位孔:
连接步骤如下:
1. 使用全功能 Type-C 数据线,将 NanoKVM Go 的数据接口连接到被控设备支持 DP Alt Mode 的 Type-C 接口。
2. 如果被控设备无法为 NanoKVM Go 供电,使用电源接口为 NanoKVM Go 单独供电
1. 使用全功能 USB-C 数据线,将 NanoKVM Go 的主 USB-C 接口(屏幕图标)连接到被控设备支持 DP Alt Mode 的 USB-C 接口。
2. 如果被控设备无法为 NanoKVM Go 供电,将 USB-C 电源适配器连接到辅助 USB-C 接口(闪电图标)
3. 等待 NanoKVM Go 开机,屏幕显示当前状态和 IP 地址。
## 网络配置
NanoKVM Go 首次使用时,需要先完成网络连接
NanoKVM Go 首次使用或更换 Wi-Fi 环境时,需要先完成配网。开始前请确认 NanoKVM Go 已开机Wi-Fi 信号可覆盖到 NanoKVM Go 所在区域,并准备好要连接网络的 SSID 和密码
1. 进入设备 Wi-Fi 页面,确认 Wi-Fi 开关已打开
2. 进入配置方式选择页面,可选择 `PASSWD``QRCODE` 方式进行配网。
3. 按页面提示输入要连接的 Wi-Fi 名称和密码,并提交配置。
4. 配置完成后,返回主页面。若主页面显示设备的 IP 地址,即为连接成功。
> NanoKVM Go 的 Wi-Fi 支持 2.4G 和 5G 两种频段。为了获得更稳定的远程控制体验,建议优先连接 5G 频段 Wi-Fi
![NanoKVM Go 主界面 IP 地址显示](./../../../assets/NanoKVM/go/user_guide/nanokvm-go-main-screen.webp)
NanoKVM Go 主界面向左滑动到 `Settings` 页面,点击 Wi-Fi 图标。进入 `WI-FI` 页面后,点击 `Connect Wi-Fi`
详细配置请参考 [用户指南的网络配置章节](./user_guide.html#%E7%BD%91%E7%BB%9C%E9%85%8D%E7%BD%AE)。
<video src="./../../../assets/NanoKVM/go/quick_start/nanokvm-go-open-wifi.mp4" aria-label="NanoKVM Go 打开 Wi-Fi 配置页面" style="width: 100%; max-width: 360px;" playsinline controls autoplay loop muted preload="metadata"></video>
NanoKVM Go 提供 `PASSWD``QRCODE` 两种配网方式。`PASSWD` 方式适合直接在 NanoKVM Go 屏幕上选择 Wi-Fi 并输入密码;`QRCODE` 方式适合使用手机填写 Wi-Fi 信息。
![NanoKVM Go Wi-Fi 配置方式](./../../../assets/NanoKVM/go/quick_start/nanokvm-go-wifi-via.webp)
### 使用 PASSWD 配置
1.`Via` 页面选择 `PASSWD`NanoKVM Go 会自动扫描附近的 Wi-Fi。
2. 在 Wi-Fi 列表中上下滑动,选中要连接的 SSID然后点击右上角的 `>` 进入密码输入页面。如需手动输入 SSID可选择 `Manual SSID`
![NanoKVM Go 选择 Wi-Fi](./../../../assets/NanoKVM/go/quick_start/nanokvm-go-wifi-ssid.webp)
3. 使用屏幕键盘输入 Wi-Fi 密码,输入完成后点击 `OK`
![NanoKVM Go 输入 Wi-Fi 密码](./../../../assets/NanoKVM/go/quick_start/nanokvm-go-wifi-password.webp)
> 屏幕键盘使用类似九宫格的多击输入方式。同一个按键上有多个字母时,点击一次输入第一个字母,连续点击两次输入第二个字母,依此类推。
### 使用 QRCODE 配置
1.`Via` 页面选择 `QRCODE`NanoKVM Go 屏幕会显示 `Connect to AP` 二维码。
2. 使用手机扫描 `Connect to AP` 二维码,并按手机提示连接 NanoKVM Go 的临时热点。手机连接成功后NanoKVM Go 屏幕上的二维码会切换为 `Configure WiFi`
![NanoKVM Go 连接临时热点二维码](./../../../assets/NanoKVM/go/quick_start/nanokvm-go-connect-ap-qr.webp)
3. 再次使用手机扫描 `Configure WiFi` 二维码,浏览器会打开 Wi-Fi 配网页面。
![NanoKVM Go 配置 Wi-Fi 二维码](./../../../assets/NanoKVM/go/quick_start/nanokvm-go-configure-wifi-qr.webp)
4. 在页面中填写 Wi-Fi 的 SSID 和密码,点击 `确定` 提交。等待 NanoKVM Go 完成连接,过程中不要断开电源。
![NanoKVM Go 手机端 Wi-Fi 配置页面](./../../../assets/NanoKVM/go/quick_start/nanokvm-go-wifi-config-page-zh.webp)
### 确认连接成功
配置完成后,`WI-FI` 页面会显示当前 SSID 和 IP 地址。控制设备与 NanoKVM Go 连接到同一网络后,在浏览器中输入该 IP 地址即可打开 Web 控制页面。
![NanoKVM Go 网络连接成功](./../../../assets/NanoKVM/go/quick_start/nanokvm-go-network-success.webp)
## 基本远程控制
完成网络配置后,在浏览器地址栏直接输入获取到的 IP进入 NanoKVM Go 登录页面。初始账号为 `admin`,初始密码为 `admin`
完成网络配置后,请根据控制设备与 NanoKVM Go 所在网络选择访问方式
![NanoKVM Go 登录界面](./../../../assets/NanoKVM/go/quick_start/nanokvm-go-login-page.webp)
### 同一局域网访问
登录后即可查看被控设备画面并进行键盘、鼠标操作。网页控制页面通常由悬浮栏和显示区域组成顶部悬浮栏用于进入图像设置、竖屏模式、音量设置、麦克风、屏幕键盘、鼠标样式、界面预览、镜像挂载、自定义脚本、KVM 网页终端、设置和全屏等功能,中间显示区域用于查看和操作被控设备画面
如果控制设备和 NanoKVM Go 连接到同一个可互通的局域网,在浏览器地址栏输入 `WI-FI` 页面显示的 IP 地址,即可进入 NanoKVM Go 登录页面。初始账号为 `admin`,初始密码为 `admin`
![NanoKVM Go 登录后控制页](./../../../assets/NanoKVM/go/quick_start/nanokvm-go-control-page.webp)
![NanoKVM Go 登录](./../../../assets/NanoKVM/go/quick_start/nanokvm-go-login-page-zh.webp)
+ 显示区域用于查看被控设备画面
+ 悬浮栏用于进入图像设置、竖屏模式、音量设置、麦克风、屏幕键盘、鼠标样式、界面预览、镜像挂载、自定义脚本、KVM 网页终端、设置和全屏等功能;
+ 如果画面没有显示,请确认被控设备的 Type-C 接口支持 DP Alt Mode并检查线缆是否为全功能 Type-C 数据线。
登录后即可查看被控设备画面并进行操控。
### 外网访问
如果控制设备和 NanoKVM Go 不在同一个局域网,需要先配置 Tailscale。将 NanoKVM Go 和控制设备加入同一个 Tailscale 网络后,在控制设备浏览器中输入 NanoKVM Go 的 Tailscale IP即可从外网访问 NanoKVM Go。
完整配置步骤请参考 [Tailscale 远程访问](./network/tailscale.html)。
### 手机连接注意事项
连接手机作为被控设备时,请留意系统连接提示,并根据手机系统调整相关设置
连接手机作为被控设备时,请留意系统连接提示,并根据手机系统调整相关设置
+ 部分 Android 手机首次连接外接显示设备时,系统可能弹出有线投屏、外接显示或 USB 设备连接确认请按照系统提示允许连接。如果未出现提示且画面和控制功能正常则无需额外设置NanoKVM Go 无需开启 USB 调试;
#### Android 手机
+ 连接 iPhone 时,需要开启 iPhone 的辅助触控功能。请前往 `设置` > `辅助功能` > `触控` > `辅助触控`,然后打开 `辅助触控` 开关;
部分 Android 手机首次连接外接显示设备时,系统可能弹出有线投屏、外接显示或 USB 设备连接确认请按照系统提示允许连接。如果未出现提示且画面和控制功能正常则无需额外设置。NanoKVM Go 无需开启 USB 调试。
#### iPhone
连接 iPhone 时,需要先开启 iPhone 的辅助触控功能。请前往 `设置` > `辅助功能` > `触控` > `辅助触控`,然后打开 `辅助触控` 开关。
1. 打开“辅助功能”。
![iPhone 设置中的辅助功能入口](./../../../assets/NanoKVM/go/quick_start/nanokvm-go-iphone-open-accessibility-zh.webp)
![iPhone 设置中的辅助功能入口](./../../../assets/NanoKVM/go/quick_start/nanokvm-go-iphone-open-accessibility-zh.webp)
2. 打开“触控”。
![iPhone 辅助功能中的触控入口](./../../../assets/NanoKVM/go/quick_start/nanokvm-go-iphone-open-touch-zh.webp)
![iPhone 辅助功能中的触控入口](./../../../assets/NanoKVM/go/quick_start/nanokvm-go-iphone-open-touch-zh.webp)
3. 打开“辅助触控”。
![iPhone 触控设置中的辅助触控入口](./../../../assets/NanoKVM/go/quick_start/nanokvm-go-iphone-open-assistive-touch-zh.webp)
![iPhone 触控设置中的辅助触控入口](./../../../assets/NanoKVM/go/quick_start/nanokvm-go-iphone-open-assistive-touch-zh.webp)
4. 开启“辅助触控”。
![iPhone 辅助触控开关](./../../../assets/NanoKVM/go/quick_start/nanokvm-go-iphone-enable-assistive-touch-zh.webp)
![iPhone 辅助触控开关](./../../../assets/NanoKVM/go/quick_start/nanokvm-go-iphone-enable-assistive-touch-zh.webp)
+ `相对模式` 适用于所有平台;
+ 连接 Android 手机时,如需使用绝对鼠标模式,请进入悬浮栏中的鼠标样式设置,并选择 `绝对模式Android`。普通的 `绝对模式` 无法在 Android 平台使用;
![NanoKVM Go Android 鼠标模式](./../../../assets/NanoKVM/go/quick_start/nanokvm-go-android-mouse-mode-zh.webp)
+ 连接 iPhone 时,每次连接成功后都需要在网页控制页面中点击 `修复 iPhone 拖拽`。如果没有点击该选项,可能会出现鼠标一直处于按下状态的问题。
连接 iPhone 时,每次连接成功后都需要在网页控制页面中点击 `修复 iPhone 拖拽`。如果没有点击该选项,可能会出现鼠标一直处于按下状态的问题。
![NanoKVM Go 修复 iPhone 拖拽](./../../../assets/NanoKVM/go/quick_start/nanokvm-go-fix-iphone-drag-zh.webp)
#### 鼠标模式选择
在网页控制页面顶部悬浮栏中点击鼠标图标,进入 `鼠标模式` 菜单后选择合适的输入模式。
![NanoKVM Go 鼠标模式菜单](./../../../assets/NanoKVM/go/quick_start/nanokvm-go-mouse-mode-zh.webp)
+ `跟随式鼠标`:适合电脑等普通桌面系统,鼠标位置会跟随网页端指针移动。被控设备为 Android 手机时请勿使用该模式,否则无法正常控制。
+ `跟随式鼠标(更兼容 Android`:被控设备为 Android 手机时使用,适配 Android 的指针和触控输入,兼容性更好。
+ `多点触摸屏`:适合使用手机作为控制设备来操控另一台手机,可进行更接近触摸屏的操作,体验更顺滑。
+ `独占式鼠标`适合游戏、远程桌面、BIOS/UEFI 等需要相对位移输入或锁定鼠标的场景。
## 安全建议
+ 首次登录后请及时修改默认密码,具体流程请参考 [用户指南 - 修改密码](./user_guide.html#%E4%BF%AE%E6%94%B9%E5%AF%86%E7%A0%81)

View File

@@ -10,7 +10,7 @@ keywords: NanoKVM Go, Remote desktop, KVM, flashing
烧录前请先准备:
- NanoKVM Go
- 取卡针或其他可以按住 Reset 按键的工具;
- 取卡针或其他可以按住烧录模式按键的工具;
- USB 数据线;
- Windows 电脑;
- NanoKVM Go 镜像文件;
@@ -20,7 +20,7 @@ keywords: NanoKVM Go, Remote desktop, KVM, flashing
前往 GitHub 下载最新版 NanoKVM Go 镜像。
镜像下载链接:TODO
镜像下载链接:[NanoKVM-Go Releases](https://github.com/sipeed/NanoKVM-Go/releases)
## 下载烧录工具
@@ -31,22 +31,23 @@ keywords: NanoKVM Go, Remote desktop, KVM, flashing
## 进入烧录模式
1. 断开 NanoKVM Go 的 USB 连接;
1. 断开 NanoKVM Go 的 USB 连接,使设备整体处于关机状态
2. 使用取卡针按住 NanoKVM Go 的 Reset 按键
2. 电脑上打开 ImageUSB
![使用取卡针按住 NanoKVM Go Reset 按键](../../../../assets/NanoKVM/go/system/nanokvm_go_flashing_press_reset.webp)
3. 使用取卡针通过按键孔按住 NanoKVM Go 的烧录模式按键;
3. 保持按住 Reset 按键,将 USB 数据线插入 NanoKVM Go 的数据接口(Data Port),并连接到电脑;
![使用取卡针按住 NanoKVM Go 烧录模式按键](../../../../assets/NanoKVM/go/system/nanokvm_go_flashing_press_reset.webp)
![按住 Reset 按键并连接 NanoKVM Go 数据接口](../../../../assets/NanoKVM/go/system/nanokvm_go_flashing_connect_data_port.webp)
4. 保持按住烧录模式按键,将连接电脑的 USB 数据线插入 NanoKVM Go 数据接口(Data Port)
4. 打开 ImageUSB等待软件识别到 NanoKVM Go 对应的 USB 设备;
![按住烧录模式按键并连接 NanoKVM Go 数据接口](../../../../assets/NanoKVM/go/system/nanokvm_go_flashing_connect_data_port.webp)
![ImageUSB 识别到 NanoKVM Go 设备](../../../../assets/NanoKVM/go/system/nanokvm_go_flashing_device_detected.webp)
5. 点击 ImageUSB的 Refresh Drives 按钮;
5. 识别成功后,松开 Reset 按键。
![ImageUSB 识别到 NanoKVM Go 设备](../../../../assets/NanoKVM/go/system/nanokvm_go_flashing_refresh_drives.webp)
6. 识别成功后,松开烧录模式按键。
## 使用 ImageUSB 烧录镜像