为何Ubuntu VNC黑屏

Ubuntu 下 VNC 黑屏是一个非常常见的问题，通常不是“VNC 坏了”，而是桌面环境 / 会话 / 权限 / 配置没对。下面按最常见原因 → 对应解决办法给你系统梳理（适用于 Ubuntu 20.04 / 22.04 / 24.04）。

一、最常见原因总结（先看这个）

二、先确认几个关键信息（非常重要）

请在 Ubuntu 上执行：

echo $XDG_SESSION_TYPE

结果说明：

• ✅ x11 → 正常
• ❌ wayland → VNC 黑屏几乎必然

三、Wayland 导致的黑屏（最常见）

Wayland 的问题

• Ubuntu 默认使用 Wayland
• VNC 基本不支持 Wayland
• 结果：连接后黑屏 / 灰屏 / 鼠标能动但无桌面

✅ 解决方案：切换到 X11

1️⃣ 编辑配置

sudo nano /etc/gdm3/custom.conf

2️⃣ 取消注释这一行

WaylandEnable=false

3️⃣ 重启

sudo reboot

4️⃣ 登录时确认

登录界面右上角 ⚙️
选择 Ubuntu on Xorg

四、VNC 没有启动桌面会话（第二常见）

症状

• 能连上
• 黑屏 / 灰屏 / 只有一个鼠标

原因

VNC 启动后 没有执行桌面环境

✅ 正确配置 ~/.vnc/xstartup

示例（Ubuntu + GNOME）

#!/bin/sh
unset SESSION_MANAGER
unset DBUS_SESSION_BUS_ADDRESS

export XDG_SESSION_TYPE=x11
export XDG_RUNTIME_DIR=/run/user/$(id -u)

[ -x /etc/vnc/xstartup ] && exec /etc/vnc/xstartup
[ -r $HOME/.Xresources ] && xrdb $HOME/.Xresources

exec gnome-session

然后：

chmod +x ~/.vnc/xstartup

如果是 Ubuntu Server（无 GNOME）

建议安装轻量桌面：

sudo apt install xfce4 xfce4-goodies

xstartup 改为：

startxfce4 &

五、VNC Server 没启动在正确用户下

常见错误

• 用 root 启动 VNC
• 实际桌面是普通用户

✅ VNC 必须在你要登录的用户下启动

vncserver :1

或（TigerVNC）：

vncserver

六、端口 / 显示器理解错误

✅ 客户端应连接：

IP:5901

七、缺少桌面环境（Server 版常见）

检查：

ls /usr/share/xsessions

如果为空：

sudo apt install ubuntu-desktop

八、快速排查清单（照着做）

# 1. 看 session 类型
echo $XDG_SESSION_TYPE

# 2. 关闭 Wayland
sudo nano /etc/gdm3/custom.conf

# 3. 重启
sudo reboot

# 4. 检查 VNC 配置
cat ~/.vnc/xstartup

# 5. 重启 VNC
vncserver -kill :1
vncserver :1

九、我可以进一步精准定位

你可以直接把下面信息发我，我可以一步到位给你解决方案：

1. Ubuntu 版本（lsb_release -a）
2. 用的是哪种 VNC（TigerVNC / RealVNC / x11vnc / 自带）
3. 是 桌面版 还是 Server
4. 黑屏时：
   • 有鼠标吗？
   • 灰屏 / 黑屏 / 闪退？
5. echo $XDG_SESSION_TYPE 输出

我可以直接给你可用的 xstartup 配置。