ubuntu如何配置tigervnc远程桌面

Ubuntu配置TigerVNC远程桌面完整步骤

1. 前置准备：更新系统

在安装软件前，先更新系统软件包索引，确保后续安装的软件是最新版本，避免依赖冲突。
打开终端（Ctrl+Alt+T），执行以下命令：

sudo apt update

2. 安装TigerVNC Server

通过Ubuntu官方软件源安装TigerVNC Server（支持GNOME、XFCE等多种桌面环境）：

sudo apt install tigervnc-standalone-server -y

3. 设置VNC访问密码

运行vncpasswd命令设置VNC连接密码（密码长度建议6-8位，包含字母和数字）：

vncpasswd

• 输入密码（不显示），按回车确认；
• 当提示“是否设置仅查看密码”时，输入n并回车（避免限制操作权限）。
  密码会保存在~/.vnc/passwd文件中，后续可通过vncpasswd修改。

4. 配置桌面环境启动文件（关键步骤）

TigerVNC启动时需要加载桌面环境配置，需手动创建或编辑~/.vnc/xstartup文件（指定使用Ubuntu默认的GNOME桌面）：

nano ~/.vnc/xstartup

将以下内容完整复制到编辑器中（注意不要遗漏或修改任何一行）：

#!/bin/sh
unset SESSION_MANAGER
unset DBUS_SESSION_BUS_ADDRESS
export GNOME_SHELL_SESSION_MODE=ubuntu
export XDG_CURRENT_DESKTOP=ubuntu:GNOME
export XDG_CONFIG_DIRS=/etc/xdg/xdg-ubuntu:/etc/xdg
exec gnome-session

• 说明：
  • unset SESSION_MANAGER和unset DBUS_SESSION_BUS_ADDRESS：清除会话管理器和DBus地址，避免桌面环境冲突；
  • export GNOME_SHELL_SESSION_MODE=ubuntu和export XDG_CURRENT_DESKTOP=ubuntu:GNOME：指定使用Ubuntu默认的GNOME桌面环境；
  • exec gnome-session：启动GNOME会话。

保存并退出编辑器（Ctrl+O保存，Ctrl+X退出）。
为xstartup文件添加执行权限：

chmod +x ~/.vnc/xstartup

5. 启动TigerVNC Server

使用以下命令启动VNC服务器（:1表示显示编号，对应端口5901，即5900+1）：

vncserver :1

• 首次启动会提示“是否设置仅查看密码”，输入n并回车；
• 启动成功后，会显示类似以下信息（记录PID，后续停止服务时需要）：

  New 'X' desktop is ubuntu:1 (192.168.1.100:1)
  Starting applications specified in ~/.vnc/xstartup
  Log file is /home/your_username/.vnc/ubuntu:1.log
  

6. 配置开机自启（可选但推荐）

为了让VNC服务器在系统启动时自动运行，需创建Systemd服务文件：

sudo cp /lib/systemd/system/vncserver@.service /etc/systemd/system/vncserver@:1.service

编辑服务文件（将your_username替换为实际用户名）：

sudo nano /etc/systemd/system/vncserver@:1.service

修改以下内容（重点修改User、Group和WorkingDirectory）：

[Unit]
Description=Remote desktop service (VNC)
After=syslog.target network.target

[Service]
Type=forking
User=your_username
Group=your_username
WorkingDirectory=/home/your_username
ExecStartPre=/usr/bin/vncserver -kill :%i > /dev/null 2>&1 || :
ExecStart=/usr/bin/vncserver :%i -depth 24 -geometry 1280x800
ExecStop=/usr/bin/vncserver -kill :%i
Restart=on-success
RestartSec=15

[Install]
WantedBy=multi-user.target

保存并退出编辑器。
重新加载Systemd配置，启用并启动服务：

sudo systemctl daemon-reload
sudo systemctl enable vncserver@:1.service
sudo systemctl start vncserver@:1.service

7. 配置防火墙（允许VNC流量）

如果系统启用了防火墙（如ufw），需允许VNC端口（默认5901，对应:1）的流量：

sudo ufw allow 5901/tcp
sudo ufw enable  # 若未启用防火墙，可跳过此步

验证端口是否开放：

sudo ufw status

应显示5901/tcp为ALLOW。

8. 连接VNC服务器

在另一台计算机上，使用VNC客户端（如TigerVNC Viewer、RealVNC Viewer）连接：

• 输入服务器IP地址和端口号（格式：<服务器IP>:1，例如192.168.1.100:1）；
• 输入之前设置的VNC密码，点击“连接”即可看到远程桌面。

常见问题解决

• 问题1：连接被拒绝（Connection refused）
  原因：VNC服务器未启动或防火墙阻止。
  解决：检查VNC服务状态（sudo systemctl status vncserver@:1.service），确保服务已启动；确认防火墙已开放5901端口。

• 问题2：远程桌面黑屏/灰屏
  原因：xstartup文件配置错误。
  解决：删除~/.vnc/xstartup文件，重新按照步骤4配置（确保包含exec gnome-session）。

• 问题3：无法设置仅查看密码
  原因：vncpasswd命令选项错误。
  解决：vncpasswd不支持“仅查看”密码设置，无需额外操作（默认允许操作）。

通过以上步骤，即可在Ubuntu上成功配置TigerVNC远程桌面，实现图形化远程管理。