如何安装Debian TigerVNC

下面以 Debian 11/12（Bullseye / Bookworm） 为例，介绍 TigerVNC 的安装与基本配置。如果你用的是其他版本，步骤也基本一致。

一、安装 TigerVNC

1. 更新软件源

sudo apt update

2. 安装 TigerVNC 服务器

sudo apt install tigervnc-standalone-server tigervnc-common

可选（推荐）：

sudo apt install tigervnc-xorg-extension

二、配置 VNC 用户

1. 切换到要使用 VNC 的普通用户

su - youruser

或

sudo -iu youruser

2. 设置 VNC 密码

vncpasswd

会生成：

~/.vnc/passwd

三、创建 VNC 启动脚本（关键）

1. 创建配置目录

mkdir -p ~/.vnc

2. 创建 ~/.vnc/xstartup

nano ~/.vnc/xstartup

示例（XFCE 桌面）：

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

示例（GNOME）：

#!/bin/sh
unset SESSION_MANAGER
unset DBUS_SESSION_BUS_ADDRESS
exec gnome-session

示例（MATE）：

#!/bin/sh
exec mate-session

3. 赋予执行权限

chmod +x ~/.vnc/xstartup

四、启动 VNC Server

1. 启动 VNC（显示号 :1）

vncserver :1 -geometry 1920x1080 -depth 24

常用参数：

• :1 → 端口 5901
• :2 → 端口 5902
• -geometry → 分辨率
• -depth → 颜色深度

查看端口：

ss -lntp | grep 59

五、设置 systemd 自动启动（推荐）

1. 创建服务文件

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

内容示例（替换 youruser）：

[Unit]
Description=TigerVNC Server (%i)
After=network.target

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

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

[Install]
WantedBy=multi-user.target

2. 启用并启动

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

查看状态：

systemctl status vncserver@1

六、防火墙设置（如有）

sudo ufw allow 5901/tcp

七、客户端连接

使用任意 VNC 客户端连接：

服务器IP:5901

推荐客户端：

• Windows / macOS：RealVNC Viewer、TigerVNC Viewer
• Linux：Remmina、TigerVNC Viewer

八、常见问题

黑屏

• xstartup 没有执行权限
• 桌面环境未安装
• 未 unset SESSION_MANAGER

连接被拒绝

• VNC 未启动
• 防火墙未放行端口

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

• Debian 版本
• 使用的桌面环境（GNOME / XFCE / MATE / 无桌面）

我可以给你 完全定制化的安装方案。