debian tigervnc如何调试

下面按常见排查思路 + 具体命令给你一份 Debian 上 TigerVNC 的调试指南，适合从“连不上 / 黑屏 / 闪退 / 权限问题”等场景入手。

一、确认安装与版本

dpkg -l | grep tigervnc
vncserver --version

常见包：

tigervnc-standalone-server
tigervnc-common
tigervnc-xorg-extension（可选）

二、前台启动（最关键）

不要直接 vncserver 后台跑，先前台看日志：

vncserver :1 -fg -verbose

或指定分辨率：

vncserver :1 -geometry 1280x720 -depth 24 -fg

观察：

是否报错（端口、权限、X 启动失败）
是否卡在 Starting applications specified in ...

三、查看日志文件

TigerVNC 日志位置：

~/.vnc/<hostname>:<display>.log

例如：

cat ~/.vnc/debian:1.log

常见错误：

XStartup failed
Permission denied
Could not open display

四、xstartup 调试（黑屏/无桌面）

编辑：

~/.vnc/xstartup

最小可用示例（XFCE）：

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

或 GNOME：

exec gnome-session

改完：

chmod +x ~/.vnc/xstartup

调试技巧：在 xstartup 里加日志

exec >> ~/.vnc/xstartup.log 2>&1
set -x

五、端口与防火墙

查看监听：

ss -tlnp | grep 590

VNC 端口规则：

:1 → 5901
:2 → 5902

防火墙：

ufw allow 5901

六、系统服务方式（systemd）

若用 tigervnc 系统用户：

sudo systemctl status vncserver@:1.service
sudo journalctl -u vncserver@:1.service -e

服务文件示例：

[Unit]
Description=TigerVNC

[Service]
Type=forking
User=youruser
ExecStart=/usr/bin/vncserver :1
ExecStop=/usr/bin/vncserver -kill :1

[Install]
WantedBy=multi-user.target

七、常见坑速查

现象	原因
黑屏	xstartup 没启动桌面
连接立即断开	用户 home 权限不对
无法绑定端口	已有 vncserver 在跑
登录后无菜单	DBUS/SESSION 未清空
root 无法启动	安全限制，建议普通用户

八、高级调试

加 -SecurityTypes none 临时测试（不安全）
用 xtigervnc 替代 vncserver
开 X 日志：

vncserver :1 -log *:std:100

如果你愿意，可以贴：

vncserver :1 -fg 输出
~/.vnc/*.log
你用的桌面环境（GNOME / XFCE / KDE）

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