怎样排查debian tigervnc故障

下面按从易到难、从客户端到服务端的顺序，系统地说一下 Debian + TigerVNC 故障排查方法。你可以对照自己的现象逐步查。

一、先确认基本信息

cat /etc/os-release
apt show tigervnc-standalone-server

确认：

• Debian 版本
• tigervnc 是否安装成功

二、服务是否启动（最常见问题）

1. 查看服务状态

systemctl status tigervncserver@:1.service

或（旧方式）：

ps aux | grep vnc

2. 常见错误

• Unit not found → 服务名写错
• failed to start → 看日志
• 端口没监听 → VNC 没起来

三、端口与防火墙

1. 查看监听端口

ss -tlnp | grep 59

默认：

• :1 → 5901
• :2 → 5902

2. 防火墙（如果有）

iptables -L -n
# 或
ufw status

需要放行：

ufw allow 5901/tcp

四、日志排查（最关键）

1. TigerVNC 日志位置

~/.vnc/*.log

例如：

~/.vnc/debian:1.log

2. 常见日志错误

• Permission denied
• X startup failed
• Could not open display

五、用户与桌面环境

1. 是否安装了桌面

which startxfce4
which gnome-session
which mate-session

2. ~/.vnc/xstartup 是否正确

示例（XFCE）：

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

赋予权限：

chmod +x ~/.vnc/xstartup

六、systemd 配置检查（Debian 推荐方式）

1. 服务文件示例

/etc/systemd/system/tigervncserver@.service

关键内容：

User=youruser
ExecStart=/usr/bin/vncserver :%i -geometry 1280x720

2. 重载并启动

systemctl daemon-reload
systemctl start tigervncserver@:1

七、客户端连接问题

1. 能连但黑屏

• xstartup 错
• 没装桌面环境

2. 连接被拒绝

• 服务没起
• 防火墙
• IP/端口错

3. 超时

• 网络不通
• 云服务器安全组未放行

八、常见坑总结

九、快速自检清单

systemctl status tigervncserver@:1
ss -tlnp | grep 5901
cat ~/.vnc/*.log
cat ~/.vnc/xstartup

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

• Debian 版本
• 报错日志
• 是本地还是云服务器
• 黑屏 / 连不上 / 启动失败

我可以直接帮你定位具体问题。