VNC 远程

One-KVM 内置 VNC 服务，可通过 TigerVNC 客户端查看和控制当前 KVM 画面。当前实现只保证与支持相应编码的客户端配合使用，建议使用 TigerVNC；RealVNC Viewer、TightVNC Viewer 等客户端可能无法正常连接。

VNC 会锁定所选视频编码。当前支持 Tight JPEG 和 H.264；如果 RTSP 或 RustDesk 已锁定不兼容的编码，保存或启动会失败。

配置项

项目	说明	默认值
开机自启	系统启动后自动启动 VNC 服务	关
监听地址	绑定的本机 IP；0.0.0.0 表示监听所有 IPv4 地址	0.0.0.0
端口	VNC 服务端口	5900
视频编码	Tight JPEG 或 H.264	Tight JPEG
仅允许单客户端	同时只接受一个 VNC 客户端	开
密码	VNCAuth 密码，最多 8 个字符	未设置

首次启动 VNC 前必须设置密码。监听地址只能填写单独的 IP 地址，不能写成带端口的地址（例如 127.0.0.1:5900）。

配置步骤

1. 打开 设置 → 扩展 → 第三方接入 → VNC 远程。
2. 设置监听地址、端口、视频编码和单客户端限制。
3. 设置不超过 8 个字符的 VNC 密码。
4. 点击 保存，再点击 启动。
5. 从 VNC 地址预览 确认客户端连接地址。

运行中修改端口、编码或密码前，先点击 停止；开机自启只影响系统启动后的自动运行。

使用 TigerVNC 连接

在 TigerVNC Viewer 中填写：

设备IP:5900

输入 One-KVM 中设置的密码完成 VNCAuth 认证。

连接成功后即可查看并控制被控机画面。启用“仅允许单客户端”时，新的连接会在已有客户端断开后才能建立。