ubuntu tigervnc为何黑屏

Ubuntu 上 TigerVNC 连接后黑屏（或只剩灰底/X 背景）是非常常见的问题，通常不是 VNC 本身坏了，而是 桌面会话没起来。下面按“原因 → 解决”给你梳理。

一、最常见原因（90% 情况）

1️⃣ 没有正确启动桌面环境（GNOME / XFCE）

TigerVNC 不会自动启动 Ubuntu 的登录管理器（gdm），如果你 ~/.vnc/xstartup 写错了，就只剩黑屏。

✅ 正确做法（GNOME 桌面）

编辑：

~/.vnc/xstartup

内容示例（Ubuntu 20.04 / 22.04 / 24.04）：

#!/bin/sh
unset SESSION_MANAGER
unset DBUS_SESSION_BUS_ADDRESS
exec /etc/X11/Xsession

或 GNOME 明确一点：

#!/bin/sh
export XKL_XMODMAP_DISABLE=1
exec gnome-session

然后：

chmod +x ~/.vnc/xstartup

重启 VNC：

vncserver -kill :1
vncserver :1

2️⃣ 用了 Wayland（Ubuntu 默认）

TigerVNC 不支持 Wayland

检查：

echo $XDG_SESSION_TYPE

如果是 wayland → 黑屏正常

✅ 解决

编辑：

sudo nano /etc/gdm3/custom.conf

取消注释：

WaylandEnable=false

重启：

sudo reboot

二、推荐方案（最稳）

✅ 用 XFCE（强烈推荐服务器用）

sudo apt install xfce4 xfce4-goodies

~/.vnc/xstartup：

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

三、常见错误写法（会导致黑屏）

❌ 只写：

twm &

（没有桌面环境）

❌：

gnome-session &

（少了 exec，会话会退出）

四、日志怎么看（关键）

看真正原因：

~/.vnc/*.log

黑屏常见日志：

• dbus failed
• gnome-session not found
• Permission denied

五、最小可用配置示例（Ubuntu 22.04+）

sudo apt install tigervnc-standalone-server xfce4
vncserver
# 编辑 ~/.vnc/xstartup

六、如果你愿意，我可以更精准帮你

你可以直接贴：

1. Ubuntu 版本
2. 用的桌面（GNOME / XFCE / 无界面）
3. ~/.vnc/xstartup 内容
4. VNC 日志最后 20 行

我可以一步一步帮你修到“不黑屏”。