Debian如何配置TigerVNC

下面以 Debian（10/11/12 均适用） 为例，介绍 TigerVNC 的安装与配置步骤，包括 无桌面 / 有桌面 / systemd 服务方式 的常见用法。

一、安装 TigerVNC

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

可选（推荐）：

sudo apt install dbus-x11

二、设置 VNC 密码

任意用户执行（不要用 root 直接跑桌面）：

vncpasswd

密码保存在：

~/.vnc/passwd

三、配置 VNC 启动脚本（非常关键）

1️⃣ 创建配置文件

mkdir -p ~/.vnc
nano ~/.vnc/xstartup

2️⃣ 常用桌面配置示例

✅ GNOME（Debian 默认桌面）

#!/bin/sh
unset SESSION_MANAGER
unset DBUS_SESSION_BUS_ADDRESS
exec /etc/X11/xinit/xinitrc

或：

#!/bin/sh
export XDG_SESSION_TYPE=x11
exec gnome-session

✅ XFCE（推荐，轻量）

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

✅ MATE

#!/bin/sh
mate-session &

3️⃣ 赋予执行权限

chmod +x ~/.vnc/xstartup

四、手动启动 VNC Server（测试）

vncserver :1

含义：

:1 → 端口 5901
:2 → 端口 5902

停止：

vncserver -kill :1

五、配置 systemd（推荐服务器使用）

1️⃣ 复制模板

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

2️⃣ 修改配置

sudo nano /etc/systemd/system/vncserver@.service

修改关键行（示例为用户 debian）：

User=debian
Group=debian
WorkingDirectory=/home/debian

ExecStart=/usr/bin/vncserver -geometry 1920x1080 -depth 24 :%i

3️⃣ 重载并启动

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

查看状态：

systemctl status vncserver@1

六、防火墙（如有）

sudo ufw allow 5901/tcp

七、客户端连接

Windows：RealVNC Viewer / TigerVNC Viewer
Linux：vncviewer
macOS：Screen Sharing

连接地址：

IP:1
或
IP:5901

八、常见问题

❌ 黑屏

xstartup 没执行权限
没有安装桌面环境
dbus 未启动

❌ 端口被占用

ss -lntp | grep 590

❌ 中文输入法异常

建议用 XFCE / MATE

九、推荐方案（稳定）

场景	建议
服务器	XFCE + TigerVNC
桌面	GNOME + :1
多用户	systemd 多实例

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

Debian 版本
是否有桌面环境
是否 root / 多用户

我可以给你 完全定制的一步到位配置方案 ✅