Ubuntu VNC黑屏怎么解决

Ubuntu 下 VNC 黑屏是比较常见的问题，通常由 桌面环境未正确启动、VNC 配置错误 或 权限问题 引起。下面按「最常见原因 → 解决步骤」来说明。

一、先确认你用的是哪种 VNC

常见组合：

TightVNC / TigerVNC + Ubuntu 桌面
x11vnc
VNC via systemd（如 vncserver@.service）

不同方式配置略有差异，但核心问题基本一致。

二、最常见原因 & 对应解决办法

1️⃣ 没有启动正确的桌面环境（最常见）

VNC 默认不会自动启动 GNOME / XFCE。

✅ 解决（以 TigerVNC / TightVNC 为例）

编辑 ~/.vnc/xstartup：

nano ~/.vnc/xstartup

内容示例（Ubuntu 20.04/22.04）：

#!/bin/bash
xrdb $HOME/.Xresources
export XKL_XMODMAP_DISABLE=1
export GNOME_SHELL_SESSION_MODE=ubuntu
export XDG_CURRENT_DESKTOP=ubuntu:GNOME
exec /usr/bin/gnome-session

或（更轻量，推荐服务器）：

#!/bin/bash
exec startxfce4

然后：

chmod +x ~/.vnc/xstartup

重启 VNC：

vncserver -kill :1
vncserver :1

2️⃣ 使用了不兼容的桌面（Wayland）

Ubuntu 默认使用 Wayland，但 VNC 不支持。

✅ 解决

编辑：

sudo nano /etc/gdm3/custom.conf

取消注释：

WaylandEnable=false

重启：

sudo reboot

3️⃣ VNC 启动但桌面没起来（黑屏无鼠标）

通常是 .vnc/xstartup 没执行。

✅ 检查日志

cat ~/.vnc/*.log

常见错误：

gnome-session not found
permission denied

4️⃣ 用户未登录或 home 目录权限问题

VNC 需要在用户会话下运行。

✅ 确保：

whoami
echo $HOME

home 目录权限应为：

chmod 755 $HOME

5️⃣ 防火墙 / 端口问题（不是黑屏，但连不上）

确认端口（默认 5901）：

ss -tunlp | grep 590

三、推荐稳定方案（新手友好）

如果你只是想远程桌面：

✅ Ubuntu Server + XFCE + TigerVNC

sudo apt install xfce4 xfce4-goodies tigervnc-standalone-server

~/.vnc/xstartup：

#!/bin/bash
exec startxfce4

四、快速自检清单 ✅

[ ] ~/.vnc/xstartup 存在且可执行
[ ] 桌面环境已安装（gnome / xfce）
[ ] Wayland 已关闭
[ ] 查看 .vnc/*.log 无报错

如果你愿意，可以告诉我：

Ubuntu 版本（20.04 / 22.04 / 24.04）
使用的 VNC 软件
是否服务器版

我可以直接给你一份可用配置。