初始化 VNC 远程接入（Linux 客户端）

Linux 客户端在 10888 WEB 控制台（参见如何更新数据：Linux 客户端）登录后会出现「初始化 VNC」卡片。点击即可一键完成 VNC 配置并上报控制台，控制台随后即可远程接入该客户机。绝大多数情况下全自动、无需任何手动设置；仅当自动流程被环境阻断（缺 x11vnc、桌面是 Wayland 等）时，才需要按下文「手动处理」一节操作。

一键初始化做了什么

点击「初始化 VNC」后，客户端（vdclient，以 root 运行）会依次自动完成：

关闭 Apport 崩溃弹窗（仅 Ubuntu/Debian）：避免安装 x11vnc 出错时弹出"检测到系统程序错误"窗口，挡住即将被接管的桌面。
检查桌面会话类型：若是 Wayland 会话，x11vnc 无法抓屏，会引导切换到 Xorg（见下文情况二）。
确保 x11vnc 已安装：缺失则按发行版自动联网安装（apt / dnf / yum / zypper / pacman）。
生成 8 位动态随机密码，写入 VNC 口令文件。
自动发现图形会话的 DISPLAY 与 XAUTHORITY，在 :0 上以端口 9015 启动 x11vnc。
把 IP、端口 9015、动态密码自动上报启动服务器，控制台据此远程接入——全程无需用户填写密码。
写入开机自启标记：以后该客户机每次开机，vdclient 会在桌面与服务器就位后自动拉起 VNC，无需再点一次。

VNC 端口固定为 9015；控制密码为每次初始化动态生成的随机口令，由客户端自动上报控制台，无需也无法手动设置。

自动初始化步骤

在客户机本机浏览器打开 http://localhost:10888，用管理员账号登录（默认 admin / 123456）。
在「初始化 VNC」卡片点击 「初始化 VNC」 按钮。
提示「VNC 已初始化」即成功，控制台已可远程接入。

软件无法自动处理时的手动处理

点击后若提示失败，按下面对应情况处理。处理完后回到控制台再点一次「初始化 VNC」——务必通过按钮重试，按钮才会把 VNC 信息上报控制台；单独手工启动 x11vnc 不会上报，控制台连不进来。

情况一：未找到 x11vnc 且自动安装失败

多见于客户机无法联网或没有配置软件源，提示类似「未找到 x11vnc 且自动安装失败，请手动安装：apt-get install -y x11vnc」。

请在客户机终端按系统类型手动安装 x11vnc（vdclient 以 root 运行，手动安装同样需 root 权限）：

系统	安装命令
Ubuntu / Debian / 麒麟 / 统信 UOS（deb 系）	`apt-get install -y x11vnc`
欧拉 openEuler / 龙蜥 Anolis / RHEL / CentOS（新）	`dnf install -y x11vnc`
RHEL / CentOS（旧）	`yum install -y x11vnc`
openSUSE	`zypper install x11vnc`
Arch	`pacman -S x11vnc`

若软件源里没有 x11vnc，需先配置好可用的软件源（或离线下载 x11vnc 及其依赖手动安装）。装好后回到控制台再点一次「初始化 VNC」。

情况二：桌面是 Wayland，VNC 无法抓屏

GNOME 等桌面默认采用 Wayland 合成器，而 x11vnc 基于 X11 截屏，在 Wayland 下无法捕获桌面。需切换到 Xorg 会话。

控制台自动切换（推荐）：点击「初始化 VNC」后若检测到 Wayland，会弹出确认框：

当前是 Wayland 桌面，VNC 无法抓屏。切换到 Xorg 会重启显示管理器并注销当前桌面会话（约 15 秒后自动回到 Xorg）。是否继续？

点击「确定」后，客户端会自动修改 GDM 配置（写入 WaylandEnable=false，原文件备份为 *.osvbak）并重启显示管理器切到 Xorg。等桌面回到 Xorg（约 15 秒）后，再点一次「初始化 VNC」即可。

自动切换失败时手动处理：若提示找不到 GDM 配置、重启显示管理器失败、或切换后仍是 Wayland，请在客户机终端手动操作：

编辑 GDM 配置（Debian/Ubuntu/麒麟/UOS 为 /etc/gdm3/custom.conf，红帽系为 /etc/gdm/custom.conf），在 [daemon] 段加入或改为：
ini
```
[daemon]
WaylandEnable=false
```
重启显示管理器（会注销当前桌面，请先保存工作）：
bash
```
systemctl restart display-manager
```
也可直接重启客户机；或在 GDM 登录界面右下角齿轮处选择「在 Xorg 上」(on Xorg) 后登录。
确认已进入 Xorg 会话后，回到控制台再点一次「初始化 VNC」。

已设 WaylandEnable=false 但仍是 Wayland：通常是当前会话未重新登录，重启客户机或重新登录到 Xorg 后再初始化。

情况三：切到 Xorg 后需再点一次

自动切换 Xorg 会注销并重登桌面（约 15 秒），此时本次初始化会中断。等桌面回来后，**回到控制台再点一次「初始化 VNC」**完成启动与上报。

验证与排错

在客户机查看 x11vnc 是否已在 9015 端口运行：
bash
```
pgrep -a x11vnc
ss -lntp | grep 9015
```
启动日志在 vdclient 程序目录下的 log/x11vnc.log，失败时可据此定位（如 DISPLAY/XAUTHORITY 未找到、端口占用、抓屏 BadMatch 等）。
控制台侧能看到该客户机可远程接入，即表示上报成功。

注意事项

该功能仅 Linux 客户端可用；Windows 客户端走独立的 TightVNC 链路，没有此按钮。
需要客户机有正在运行的图形桌面会话（X/Xorg）；纯字符终端、未登录桌面时无法初始化。
初始化过一次后会开机自启，重启客户机不必再点；每次（含自启）都会重新生成动态密码并上报控制台。
信创客户端（麒麟、统信 UOS、欧拉、龙蜥等）流程完全一致：deb 系按麒麟 / UOS 那一行处理，红帽系按欧拉 / 龙蜥那一行处理。

初始化 VNC 远程接入（Linux 客户端） ​

一键初始化做了什么 ​

自动初始化步骤 ​

软件无法自动处理时的手动处理 ​

情况一：未找到 x11vnc 且自动安装失败 ​

情况二：桌面是 Wayland，VNC 无法抓屏 ​

情况三：切到 Xorg 后需再点一次 ​

验证与排错 ​

注意事项 ​