如何使用Ubuntu TigerVNC远程控制

Ubuntu 上使用 TigerVNC 远程控制的完整步骤

一 准备与安装

• 确认已安装图形桌面（无则先安装，例如 Xfce 或 GNOME）。
• 更新索引并安装 TigerVNC：
  sudo apt update
  sudo apt install tigervnc-standalone-server tigervnc-common
• 为当前用户设置 VNC 访问密码（不要用 sudo，否则会设置到 root）：
  vncpasswd
  提示是否创建“只读密码”，一般选 n。

二 配置桌面会话

• 创建或编辑会话启动脚本：
  mkdir -p ~/.vnc
  nano ~/.vnc/xstartup
• 根据桌面环境写入以下内容（二选一或按实际环境调整）：
  • Xfce（轻量稳定，推荐远程）：
    #!/bin/sh
    unset SESSION_MANAGER
    unset DBUS_SESSION_BUS_ADDRESS
    exec startxfce4
  • GNOME（若原生 GNOME 兼容性不佳，可用 GNOME Flashback）：
    #!/bin/sh
    export XKL_XMODMAP_DISABLE=1
    export XDG_CURRENT_DESKTOP=“GNOME-Flashback:GNOME”
    export XDG_MENU_PREFIX=“gnome-flashback-”
    gnome-session --session=gnome-flashback-metacity --disable-acceleration-check
• 赋予执行权限：
  chmod +x ~/.vnc/xstartup。

三 启动与连接

• 启动 VNC 会话（示例为显示编号 :1，分辨率 1920x1080，允许远程主机连接）：
  vncserver :1 -geometry 1920x1080 -depth 24 -localhost no
  说明：显示编号 :X 对应端口 5900+X（:1→5901，:2→5902）。
• 查看与关闭会话：
  vncserver -list
  vncserver -kill :1
• 客户端连接：
  • 直接连接（公网或同网段）：在 VNC Viewer 输入 服务器IP:5901。
  • 通过 SSH 隧道加密（更安全）：
    ssh -L 5901:127.0.0.1:5901 用户名@服务器IP
    然后在客户端连接 localhost:5901。

四 防火墙与开机自启

• 防火墙放行（示例为 UFW）：
  sudo ufw allow 5901/tcp
  sudo ufw enable
  如使用 firewalld：
  sudo firewall-cmd --permanent --add-port=5901/tcp && sudo firewall-cmd --reload
• 开机自启（systemd 模板，替换 为实际用户名）：
  sudo nano /etc/systemd/system/vncserver@.service
  写入：
  [Unit]
  Description=Start TigerVNC server at startup
  After=syslog.target network.target
  [Service]
  Type=forking
  User=
  ExecStartPre=/bin/sh -c ‘/usr/bin/vncserver -kill :%i > /dev/null 2>&1 || :’
  ExecStart=/usr/bin/vncserver -geometry 1920x1080 -localhost no :%i
  ExecStop=/usr/bin/vncserver -kill :%i
  [Install]
  WantedBy=multi-user.target
  启用服务：
  sudo systemctl daemon-reload
  sudo systemctl enable vncserver@1.service
  sudo systemctl start vncserver@1.service。

五 常见问题与排查

• 连接被拒绝或“Connection refused”：检查服务是否运行（vncserver -list）、端口是否监听（ss -lntp | grep 5901），以及云服务器安全组/本机防火墙是否放行 5901。
• 只能本机连：启动时未加 -localhost no，或仅监听 127.0.0.1。用 vncserver -kill :1 后改为：
  vncserver :1 -localhost no -geometry 1920x1080
• 黑屏/灰屏/桌面缺失：多半是 xstartup 未正确启动桌面，按第二部分替换为对应桌面环境的脚本并 chmod +x。
• GNOME 兼容性问题：优先尝试 GNOME Flashback + Metacity（见第二部分脚本）。
• 注销后无法重连：退出 VNC 会话请用“断开/关闭窗口”，不要点“注销”，否则会话与进程会结束。
• 分辨率/色彩：启动参数 -geometry 1920x1080 -depth 24 可调整清晰度与色深。