如何在Ubuntu中使用TigerVNC远程桌面

在 Ubuntu 上使用 TigerVNC 远程桌面的完整步骤

一 环境准备与安装

• 确认系统已安装图形界面；若是 Ubuntu Server，先安装桌面（示例选用 Xfce，轻量稳定）：
  • 更新索引并安装桌面与显示管理器：
    • sudo apt update && sudo apt install -y xfce4 xfce4-goodies
    • sudo apt install -y gdm3 # 或 lightdm
  • 设置默认启动到图形会话：sudo systemctl set-default graphical.target
• 安装 TigerVNC 服务器与常用组件：
  • sudo apt install -y tigervnc-standalone-server tigervnc-common
• 说明：TigerVNC 是跨平台的高性能 VNC 实现，适合在 Linux 上提供远程桌面会话。

二 配置 VNC 密码与会话

• 为当前用户设置 VNC 登录密码（仅用于 VNC，非系统密码）：
  • vncpasswd
• 首次运行会自动创建 ~/.vnc 目录；如需手动创建配置文件也可先行生成会话：
  • vncserver
• 端口规则：显示号 :1 对应端口 5901，:2 对应 5902，以此类推（5900 + 显示号）。

三 配置桌面环境与 xstartup

• 编辑会话启动脚本 ~/.vnc/xstartup，根据所用桌面选择其一（务必赋予可执行权限：chmod +x ~/.vnc/xstartup）：
  • Xfce（推荐，轻量稳定）：

    #!/bin/sh
    unset SESSION_MANAGER
    unset DBUS_SESSION_BUS_ADDRESS
    exec startxfce4
    

  • GNOME（Ubuntu 默认，示例为 Ubuntu 会话）：

    #!/bin/sh
    export XKL_XMODMAP_DISABLE=1
    unset SESSION_MANAGER
    unset DBUS_SESSION_BUS_ADDRESS
    [ -x /etc/vnc/xstartup ] && exec /etc/vnc/xstartup
    [ -r $HOME/.Xresources ] && xrdb $HOME/.Xresources
    xsetroot -solid grey
    vncconfig -iconic &
    exec /etc/X11/Xsession ubuntu-xsession
    

• 若之前启动过会话，先终止再启动以加载新配置：
  • vncserver -kill :1
  • vncserver :1

四 启动与连接

• 启动会话（示例：显示号 :1，分辨率 1920x1080，色深 24 位）：
  • vncserver :1 -geometry 1920x1080 -depth 24
• 防火墙放行（UFW 示例）：
  • sudo ufw allow 5901/tcp && sudo ufw reload
• 客户端连接（示例地址）：
  • 直接连接：输入 服务器IP:5901
  • 更安全的 SSH 隧道（推荐）：在本地执行
    • ssh -L 5901:localhost:5901 用户名@服务器IP
    • 然后客户端连接 localhost:5901
• 常用管理：
  • 查看会话：vncserver -list
  • 结束会话：vncserver -kill :1

五 开机自启与常见问题

• 开机自启（systemd 模板，替换 为实际用户名）：
  • 新建服务：sudo nano /etc/systemd/system/vncserver@.service

    [Unit]
    Description=Start TigerVNC server at startup
    After=syslog.target network.target
    
    [Service]
    Type=forking
    User=<USER>
    Group=<USER>
    WorkingDirectory=/home/<USER>
    PIDFile=/home/<USER>/.vnc/%H:590%i.pid
    ExecStartPre=-/usr/bin/vncserver -kill :%i > /dev/null 2>&1
    ExecStart=/usr/bin/vncserver -depth 24 -geometry 1920x1080 -localhost no :%i
    ExecStop=/usr/bin/vncserver -kill :%i
    
    [Install]
    WantedBy=multi-user.target
    

  • 启用并启动：
    • sudo systemctl daemon-reload
    • sudo systemctl enable --now vncserver@1.service
• 常见问题速解：
  • 只能本机连、外网连不上：启动命令需包含 -localhost no，或确保配置文件中 localhost=no。
  • 灰屏/黑屏/鼠标成 X：检查 ~/.vnc/xstartup 是否启动了正确的桌面（如 startxfce4 或正确的 GNOME 会话），必要时参考上文示例修正后重启会话。
  • 锁屏后无法输入密码解锁：通过 SSH 登录后执行 loginctl unlock-session ，或重启该用户的 VNC 会话。