Ubuntu VNC如何快速连接设备

快速连接步骤

• 在目标设备上启动 VNC 会话

  1. 安装服务器（任选其一）：sudo apt update && sudo apt install tightvncserver 或 sudo apt install tigervnc-standalone-server
  2. 启动会话并设置分辨率：vncserver :1 -geometry 1920x1080
  3. 首次会提示设置访问密码；记录下显示的显示号（如 :1）
     提示：若提示 “vncserver: The HOME environment variable is not set.”，执行 export HOME=/home/你的用户名 后再启动

• 在 Ubuntu 客户端快速连接

  1. 安装客户端：sudo apt install remmina 或 sudo apt install tigervnc-viewer
  2. Remmina：新建连接 → 协议选 VNC → 地址填 设备IP:1（例如 192.168.1.50:1）→ 连接并输入密码
  3. TigerVNC：终端执行 vncviewer 设备IP:1
     说明：显示号 :1 对应端口 5901，因此也可用 IP:5901 连接

常见连接方式对照

网络与防火墙要点

• 确认设备与客户端可互通（同一局域网优先），必要时在路由器做端口转发（不建议对公网直接暴露 VNC）
• 若启用防火墙，放行对应端口（示例）：sudo ufw allow 5901:5910/tcp（按实际使用的显示号调整）

常见问题快速排查

• 连接被拒绝或超时：确认服务已启动（vncserver -list）、IP 与端口正确、路由/防火墙未拦截
• 黑屏或桌面未加载：检查 ~/.vnc/xstartup 是否启动了桌面（如 startxfce4 &），必要时 kill 后重启会话
• 加密不兼容（VNC Viewer 报错）：服务端执行 gsettings set org.gnome.Vino require-encryption false 后重连
• “HOME 环境变量未设置”：export HOME=/home/你的用户名 后启动 vncserver，或改用 sudo -E vncserver