温馨提示×

ubuntu vnc如何排错

小樊
69
2026-10-12 22:06:39
栏目: 智能运维

在 Ubuntu 上使用 VNC 经常会遇到“连不上 / 黑屏 / 闪退 / 权限问题”等情况。下面按常见故障 → 排查思路 → 解决办法来整理一份排错指南。


一、先确认基本环境

1. 确认 VNC 服务是否已安装

常见 VNC 服务:

  • tigervnc
  • tightvnc
  • x11vnc
  • Ubuntu 自带 vino(仅桌面共享)
which vncserver
which x11vnc

如果都没有,先安装(示例):

sudo apt update
sudo apt install tigervnc-standalone-server

二、连不上(Connection refused / Timeout)

2.1 服务是否真的在运行

ps aux | grep vnc
ss -lntp | grep 590

正常应看到:

5900(:0)
5901(:1)

如果没有:

vncserver :1

2.2 防火墙问题

sudo ufw status

允许 VNC:

sudo ufw allow 5901/tcp

云服务器还要检查安全组。


三、连接后黑屏(最常见)

3.1 没有正确启动桌面环境

编辑 ~/.vnc/xstartup:

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

或 GNOME:

exec gnome-session

然后:

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

3.2 重复桌面会话冲突

如果你已经在物理桌面登录,再用 VNC 会黑屏。

解决:

  • 用 x11vnc 共享当前桌面
  • 或 VNC 用独立会话

四、x11vnc 专属问题

4.1 无法打开显示

x11vnc -display :0

若报错:

Unable to open display

确认:

echo $DISPLAY

通常是 :0

4.2 需要 sudo

sudo x11vnc -display :0

五、认证 / 密码问题

5.1 密码错误

vncpasswd

5.2 view-only 模式

连接后只能看不能操作:

vncserver -viewonly

去掉该参数重启。


六、日志排错(非常重要)

~/.vnc/*.log

常见错误:

  • could not open default font
  • session exited
  • permission denied

七、systemd 方式排错(推荐服务器)

示例 service:

[Unit]
Description=VNC Server

[Service]
User=ubuntu
ExecStart=/usr/bin/vncserver :1
Restart=on-failure

[Install]
WantedBy=multi-user.target

查看状态:

journalctl -u vncserver

八、快速自检清单 ✅

  • [ ] VNC 服务在运行
  • [ ] 端口开放
  • [ ] xstartup 正确
  • [ ] 桌面环境已安装
  • [ ] 日志无致命错误

如果你愿意,可以告诉我:

  • Ubuntu 版本
  • 用的 VNC(tigervnc / x11vnc / vino)
  • 报错信息或日志

我可以一步一步帮你定位。

0 踩