Debian怎么配置TigerVNC

下面以 Debian 11/12 为例，说明如何安装和配置 TigerVNC，包括 普通用户 VNC 和 systemd 自动启动 的常见做法。

一、安装 TigerVNC

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

可选（桌面环境）：

sudo apt install xfce4 xfce4-goodies

如果你已有 GNOME / KDE / MATE，可以跳过桌面安装，只装 VNC Server 即可。

二、为当前用户配置 VNC（推荐方式）

1️⃣ 设置 VNC 密码

vncpasswd

密码保存在：

~/.vnc/passwd

2️⃣ 创建 VNC 启动脚本

nano ~/.vnc/xstartup

示例（XFCE）：

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

如果是 GNOME：

exec gnome-session

如果是 MATE：

exec mate-session

赋予执行权限：

chmod +x ~/.vnc/xstartup

3️⃣ 手动启动 VNC（测试）

vncserver :1 -geometry 1920x1080 -depth 24

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

停止：

vncserver -kill :1

三、使用 systemd 管理 VNC（推荐）

1️⃣ 复制示例 service 文件

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

2️⃣ 修改 service 文件

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

修改 User / Home 目录（示例用户 debian）：

[Unit]
Description=Remote desktop service (VNC)
After=syslog.target network.target

[Service]
Type=forking
User=debian
Group=debian
WorkingDirectory=/home/debian

PIDFile=/home/debian/.vnc/%H:%i.pid
ExecStartPre=-/usr/bin/vncserver -kill :%i > /dev/null 2>&1
ExecStart=/usr/bin/vncserver -depth 24 -geometry 1920x1080 :%i
ExecStop=/usr/bin/vncserver -kill :%i

[Install]
WantedBy=multi-user.target

3️⃣ 启动 VNC 服务

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

查看状态：

systemctl status vncserver@1

四、防火墙配置（如果有）

sudo ufw allow 5901/tcp

五、客户端连接

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

连接地址：

服务器IP:5901

六、常见问题

❌ 灰屏 / 黑屏

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

❌ 端口被占用

ss -lntp | grep 590

七、安全建议（非常重要）

✅ 推荐：

使用 SSH 隧道：

ssh -L 5901:localhost:5901 user@server

然后连接 localhost:5901

❌ 不建议：

直接暴露 VNC 到公网

如果你愿意，我可以按 “无桌面 → XFCE / GNOME / KDE” 或 “root 用户 / 普通用户” 给你写一个 完全定制版配置教程。