如何在Ubuntu上搭建TigerVNC服务器

在 Ubuntu 上搭建 TigerVNC 服务器

一 准备与安装

• 更新系统并安装桌面环境（若尚未安装）：
  • 更新索引：sudo apt update
  • 安装桌面（任选其一）：sudo apt install ubuntu-desktop gnome-session 或 sudo apt install xfce4 xfce4-goodies
• 安装 TigerVNC 组件：
  • 安装命令：sudo apt install tigervnc-standalone-server tigervnc-common
• 说明：TigerVNC 需要图形会话支持，未安装桌面会导致 VNC 会话无法正常进入桌面环境。

二 配置 VNC 密码与会话脚本

• 设置 VNC 连接密码（首次会创建 ~/.vnc 目录）：
  • 执行：vncpasswd
• 配置会话启动脚本 ~/.vnc/xstartup（决定进入哪种桌面）：
  • 使用 Xfce（轻量稳定，推荐）：

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

  • 使用 GNOME（Ubuntu 默认）：

    #!/bin/sh
    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 &
    gnome-session &
    

• 赋予执行权限：chmod +x ~/.vnc/xstartup
• 提示：若文件或目录不存在，可先执行一次 vncserver 自动生成后再编辑。

三 启动与连接

• 手动启动会话（显示编号 :1 对应端口 5901）：
  • 启动：vncserver :1 -geometry 1920x1080 -depth 24
  • 关闭：vncserver -kill :1
  • 查看会话：vncserver -list
• 防火墙放行（如使用 UFW）：sudo ufw allow 5901/tcp
• 客户端连接：在 VNC Viewer 中输入 服务器IP:5901（或 IP:1），随后输入第 2 步设置的 VNC 密码。

四 配置 systemd 开机自启（推荐）

• 创建服务文件：sudo nano /etc/systemd/system/vncserver@.service
• 写入以下内容（将 替换为实际用户名，例如 ubuntu）：

  [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:%i.pid
  ExecStartPre=-/usr/bin/vncserver -kill :%i > /dev/null 2>&1
  ExecStart=/usr/bin/vncserver :%i -geometry 1280x800 -depth 24
  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
  • 查看状态：sudo systemctl status vncserver@1.service
• 说明：如需从外部网络直连，可在启动参数中加入 -localhost no；若仅内网访问，保持默认更安全。

五 常见问题与优化

• 桌面环境不匹配导致黑屏或退回登录界面：确认 xstartup 中调用的桌面命令与系统已安装桌面一致（如 startxfce4 或 gnome-session），并确保已安装对应桌面包。
• 端口与显示编号：显示编号 :N 对应端口 5900+N（例如 :1 → 5901）。使用 vncserver -list 核对会话与端口占用。
• 权限与路径：确保 ~/.vnc/xstartup 具备可执行权限，且 ~/.vnc 归属正确用户；必要时用 chown -R : ~/.vnc 修正。
• 云服务器或公网环境：若需外网直连，启动参数加入 -localhost no 并在安全组/防火墙放行 5901/tcp；更安全的做法是仅放通内网，通过 SSH 隧道转发 VNC 端口（例如本地端口 5901 转发到远端 127.0.0.1:5901）。