Debian 上 TigerVNC 连接后黑屏,这是最常见也最容易踩坑的问题,通常不是 VNC 本身坏了,而是桌面环境没正确启动。下面按「原因 → 解决办法」给你捋清楚。
TigerVNC 只是“显示服务”,不会自动给你开桌面。
如果你 ~/.vnc/xstartup 里是空的,或者只有:
#!/bin/sh
那连上去就是黑屏。
✅ 正确示例(GNOME):
#!/bin/sh
unset SESSION_MANAGER
unset DBUS_SESSION_BUS_ADDRESS
exec /etc/X11/xinit/xinitrc
或(更稳):
#!/bin/sh
export XDG_SESSION_TYPE=x11
exec dbus-launch gnome-session
如果是 XFCE(Debian 默认轻量桌面推荐):
#!/bin/sh
exec startxfce4
改完记得:
chmod +x ~/.vnc/xstartup
然后杀掉旧会话重连:
vncserver -kill :1
vncserver :1
Debian 12 + GNOME 默认 Wayland,TigerVNC 不支持。
✅ 解决:
很多人只装了 tigervnc-server,没装桌面。
检查:
which gnome-session
which startxfce4
没有就装:
sudo apt install task-xfce-desktop
.Xauthority 权限错误黑屏 + 日志里有:
Authentication failed
解决:
rm ~/.Xauthority
vncserver :1
如果你用:
sudo systemctl start vncserver@1
但当前用户已经手动起过 VNC,会黑屏。
✅ 建议:
vncserver 命令云服务器、虚拟机常见。
✅ 用:
vncserver -geometry 1280x720 -depth 24
避免:
-depth 32
你连上去黑屏,按这个查:
~/.vnc/xstartup 有 startxfce4 或 gnome-sessionsudo apt install tigervnc-standalone-server xfce4
~/.vnc/xstartup:
#!/bin/sh
exec startxfce4
chmod +x ~/.vnc/xstartup
vncserver :1
如果你愿意,可以贴一下:
~/.vnc/xstartup 内容~/.vnc/*.log)我可以直接帮你改到能连。