ubuntu tigervnc使用教程

Ubuntu 上使用 TigerVNC 的完整教程

一 环境准备与安装

• 确保系统已安装图形桌面（无则先安装）：
  • 完整桌面：sudo apt install ubuntu-desktop
  • 轻量替代：sudo apt install xfce4 xfce4-goodies
• 安装 TigerVNC 服务端：
  • sudo apt update && sudo apt install tigervnc-standalone-server tigervnc-common
• 为当前用户初始化 VNC 密码（仅首次）：
  • vncpasswd（是否创建只读密码选 n）
  • 如需修改密码，可再次执行 vncpasswd

二 首次启动与端口说明

• 启动第一个桌面（显示号 :1，对应端口 5901）：
  • 示例：vncserver :1 -geometry 1920x1080 -localhost no
  • 常用参数：
    • :n 指定显示号，端口为 5900+n
    • -geometry WxH 设置分辨率
    • -localhost no 允许来自非本机的连接（默认只监听 127.0.0.1）
• 查看与关闭会话：
  • 查看：vncserver -list
  • 关闭指定：vncserver -kill :1
  • 关闭全部：vncserver -kill :*
• 若启动时提示缺少 ~/.vnc/xstartup，先运行一次 vncserver 自动生成目录与文件，再按下一节配置桌面启动脚本

三 配置桌面环境 xstartup

• 使用 Xfce（轻量稳定，推荐）：
  • 编辑：nano ~/.vnc/xstartup
  • 内容：

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

  • 赋权：chmod +x ~/.vnc/xstartup
• 使用 GNOME（Ubuntu 默认）：
  • 安装会话组件（如未安装）：sudo apt install gnome-session gnome-terminal ubuntu-desktop
  • 编辑：nano ~/.vnc/xstartup
  • 内容：

    #!/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 -kill :1 && vncserver :1

四 连接与安全加固

• 直连方式（仅在内网或对公网开放时谨慎使用）：
  • 客户端输入：服务器IP:5901
  • 防火墙放行（UFW）：sudo ufw allow 5901/tcp
• SSH 隧道加密（推荐，更安全）：
  • 本地端口转发：ssh -L 5901:127.0.0.1:5901 用户名@服务器IP -N -C
  • 客户端连接：localhost:5901
• 证书加密（可选，进一步增强安全性）：
  • 生成证书（在服务器上）：

    openssl req -x509 -newkey rsa -days 3650 -nodes \
      -config /usr/lib/ssl/openssl.cnf \
      -keyout ~/.vnc/vnc-server-private.pem \
      -out ~/.vnc/vnc-server.pem \
      -subj '/CN=你的服务器名称' \
      -addext "subjectAltName=IP:x.x.x.x,IP:y.y.y.y"
    

  • 配置 ~/.vnc/config：

    session=ubuntu
    geometry=1600x900
    localhost=no
    depth=24
    X509Cert=/home/你的用户名/.vnc/vnc-server.pem
    X509Key=/home/你的用户名/.vnc/vnc-server-private.pem
    SecurityTypes=X509Vnc
    

  • 重启会话后使用支持证书的客户端连接（如 TigerVNC Viewer）

五 开机自启与常见问题

• systemd 用户服务（推荐，便于开机自启与集中管理）：
  • 新建：sudo nano /etc/systemd/system/vncserver@.service
  • 内容（按需修改用户名、分辨率、色彩深度）：

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

  • 启用与启动：
    • sudo systemctl daemon-reload
    • sudo systemctl enable --now vncserver@1.service
    • 查看状态：sudo systemctl status vncserver@1.service
• 常见问题速解：
  • 连接被拒绝或 10061：服务可能只监听 127.0.0.1。重启并加上 -localhost no，或检查云服务器安全组/本机防火墙是否放行 5901。
  • 灰屏/黑屏或只有光标：检查 ~/.vnc/xstartup 是否按桌面环境正确配置，并确认已安装对应桌面（如 xfce4 或 gnome 组件）。
  • 看不到状态栏/菜单：多因未使用正确的桌面会话或权限问题，优先使用 Xfce 或按上文 GNOME 完整配置；必要时以目标用户启动 VNC。