怎样调试Ubuntu VNC错误

调试 Ubuntu 上的 VNC 错误，通常可以按“由外到内、由服务到客户端”的思路来排查。下面是一套实用排查流程，适用于常见场景（TigerVNC / TightVNC / x11vnc / Ubuntu 桌面 VNC）。

一、先确认基本信息

在终端执行：

uname -a
lsb_release -a
which vncserver
which Xvnc

确认你用的是哪种 VNC：

• vncserver（TigerVNC / TightVNC）
• x11vnc
• 桌面自带（GNOME Remote Desktop）

二、查看 VNC 服务是否启动

ps aux | grep -i vnc

或（systemd）：

systemctl status vncserver@:1.service

如果没启动：

vncserver :1
# 或
systemctl start vncserver@:1

三、查看日志（最重要）

1. VNC 日志

~/.vnc/*.log

例如：

cat ~/.vnc/ubuntu:1.log

常见错误：

• Fatal server error
• could not open default font
• Permission denied

2. 系统日志

journalctl -xe
journalctl -u vncserver@:1

四、常见错误及解决方法

1️⃣ 灰屏 / 只有背景，无桌面

通常是 .vnc/xstartup 配置问题。

示例（Ubuntu + GNOME）：

#!/bin/sh
unset SESSION_MANAGER
unset DBUS_SESSION_BUS_ADDRESS
exec gnome-session

或 XFCE：

exec startxfce4

修改后：

chmod +x ~/.vnc/xstartup
vncserver -kill :1
vncserver :1

2️⃣ Connection refused

检查：

ss -tlnp | grep 590

应看到：

5901

防火墙：

sudo ufw allow 5901

云服务器还要放行安全组。

3️⃣ Authentication failure

• 密码错误：

vncpasswd

• 用户不一致（用哪个用户启动就用哪个用户连）

4️⃣ 黑屏 / 闪退

可能是显卡或会话冲突：

export XKL_XMODMAP_DISABLE=1

或尝试：

vncserver -geometry 1280x720 -depth 24

五、推荐更稳的方案（Ubuntu 22.04+）

GNOME 自带：

sudo apt install gnome-remote-desktop

设置 → 共享 → 远程桌面

或使用：

sudo apt install x11vnc
x11vnc -display :0

六、快速自检清单 ✅

• [ ] VNC 服务已启动
• [ ] 端口在监听
• [ ] 防火墙/安全组放行
• [ ] xstartup 正确
• [ ] 日志无 Fatal 错误

如果你愿意，可以把具体报错信息或日志贴出来，我可以直接帮你定位是哪一类问题。