怎样调试debian tigervnc

下面按**从“起不来”到“能连上但显示异常”**的常见场景，给你一份 Debian 上 TigerVNC 的调试清单（含命令和排错思路）。

一、先确认安装和基本环境

sudo apt update
sudo apt install tigervnc-standalone-server tigervnc-common

确认版本：

vncserver --version

二、用「用户级 vncserver」先调通（最推荐）

1. 初始化配置

vncserver

首次会让你设置 VNC 密码，并生成：

~/.vnc/
├── xstartup
├── localhost.localdomain:1.log
└── localhost.localdomain:1.pid

2. 杀掉再重启，便于调试

vncserver -kill :1
vncserver :1

3. 看日志（最重要）

cat ~/.vnc/*.log

常见问题：

• Xinit: unable to connect → 显示环境没起来
• Session startup failed → xstartup 错
• Permission denied → 家目录权限问题

三、xstartup 是最容易出问题的地方

正确示例（Debian + XFCE）

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

或 GNOME：

exec /etc/X11/Xsession

改完：

chmod +x ~/.vnc/xstartup

四、连接问题调试

1. 端口是否在监听

ss -tlnp | grep 59

• :1 → 5901
• :2 → 5902

2. 本地先测

vncviewer localhost:1

3. 远程连不上

检查：

sudo ufw status

允许端口：

sudo ufw allow 5901

如果是云服务器：

• 安全组必须放通 5901

五、只监听 localhost（安全但远程连不上）

TigerVNC 默认：

vncserver -localhost

远程连：

• SSH 隧道

ssh -L 5901:localhost:5901 user@server

然后本地：

vncviewer localhost:1

六、systemd 方式（服务器常驻）

1. 创建服务

sudo cp /lib/systemd/system/vncserver@.service /etc/systemd/system/

编辑：

[Service]
User=youruser
ExecStart=/usr/bin/vncserver :1

sudo systemctl daemon-reload
sudo systemctl start vncserver@1
sudo systemctl enable vncserver@1

2. 看 systemd 日志

journalctl -u vncserver@1 -b

七、黑屏 / 只看到灰背景

原因通常是：

• xstartup 没 exec 桌面
• 没有安装桌面环境

检查：

which startxfce4
which gnome-session

八、常见坑速查表

九、最小排错流程（记住这个）

vncserver -kill :1
vncserver :1
cat ~/.vnc/*.log
vncviewer localhost:1

如果你愿意，可以贴：

• Debian 版本
• 桌面环境
• ~/.vnc/xstartup
• 日志报错

我可以直接帮你定位。