Ubuntu 下 TigerVNC 的“插件”使用说明

概念澄清

• 在 TigerVNC 语境中，“插件”通常指两类能力：
  1. VNC 扩展/编码插件（如 Tight、ZRLE、Hextile、CopyRect 等），由服务器在握手阶段自动通告，客户端按需启用，一般不需要手工安装；
  2. 桌面会话的“插件/小程序”（如 Xfce 面板插件），它们属于桌面环境的一部分，需要在桌面启动脚本中显式启动或在会话里启用。
• 若你只是想“用上插件”，通常意味着：启用合适的 VNC 编码（多数情况下默认已足够），以及确保桌面环境自启动你需要的面板/小程序。

启用或检查 VNC 扩展编码

• 查看当前会话启用的编码（在 VNC 会话内执行）：
  • 命令：x11vnc -display :1 -list
  • 或在桌面终端执行：x11vnc -list（若已安装 x11vnc）
• 在客户端启用更高效的编码（以常见客户端为例）：
  • TigerVNC Viewer：连接前在“Options → Security/Encoding”勾选/优先 Tight、ZRLE、Hextile 等；多数客户端会自动协商，无需手动强制。
• 服务器端通常无需额外“装插件”，只要安装了 tigervnc-standalone-server 等基础包即可，扩展由服务器自动提供并在协商时告知客户端。若遇到花屏/卡顿，可优先选择 Tight/ZRLE 编码进行对比测试。

在桌面环境中使用“插件”（以 Xfce 面板插件为例）

• 适用场景：你使用 Xfce 作为 VNC 桌面，想在面板上添加如 xfce4-menu-plugin、xfce4-clipman-plugin 等“插件”。
• 步骤：
  1. 确保已安装对应插件包（示例）：
     • sudo apt install xfce4-clipman-plugin xfce4-systemload-plugin
  2. 配置启动脚本 ~/.vnc/xstartup，在启动桌面后启动面板与所需插件（示例）：
     • 文件内容（示例）： #!/bin/sh unset SESSION_MANAGER unset DBUS_SESSION_BUS_ADDRESS xrdb $HOME/.Xresources startxfce4 &

       可选：显式启动面板插件（多数情况下面板会自动加载已安装插件）

       xfce4-panel --restart &
     • 赋权：chmod +x ~/.vnc/xstartup
  3. 重启 VNC 会话：
     • vncserver -kill :1
     • vncserver :1 -geometry 1920x1080 -depth 24
  4. 进入桌面后，通过面板右键 → 面板 → 添加新项目，选择并添加你需要的插件（如剪贴板管理器、系统负载监视器等）。
• 说明：不同桌面（GNOME、MATE 等）的“插件”形态不同，思路一致——安装对应组件并在会话启动脚本中确保桌面与插件被拉起。

常见故障与排查要点

• 连接被拒绝或只能本机连：默认仅监听 127.0.0.1。启动会话时加上 -localhost no，或改用 SSH 隧道：ssh -L 5901:localhost:5901 user@server。
• 黑屏/灰屏：多半是 ~/.vnc/xstartup 内容不匹配桌面环境。请按所用桌面（Xfce/GNOME）使用对应的最小可用脚本并确保有执行权限。
• 端口不对：会话号 :1 对应端口 5901，:2 对应 5902，以此类推。
• 编码导致的花屏/卡顿：在客户端优先启用 Tight/ZRLE，并适当调整色深（如 -depth 24）以平衡清晰度与带宽。