「 程序🛸技术 」📓Linux 笔记
,
Download PDF

TigerVNC 部署

Catalogue
  1. 1. 安装 TigerVNC 服务端
    1. 1.1. Debain 系
    2. 1.2. RH 系
  2. 2. 启动 vncserver (虚拟桌面)
    1. 2.1. 准备文件
    2. 2.2. 创建服务
    3. 2.3. 启动服务
  3. 3. 启动 x0vncserver (实机画面)
    1. 3.1. 准备文件
    2. 3.2. 创建服务 (systemd)
    3. 3.3. 启动服务
    4. 3.4. (拓展)手动启动的方法
    5. 3.5. (拓展)脚本启动的方法
    6. 3.6. (拓展) Upstart 自启动方案 (2026/04/20 更新)
  4. 4. 配置防火墙
  5. 5. 参考资料

TigerVNC 是一套高性能的 VNC (Virtual Network Computing) 服务端工具。它基于 Xvnc 在 VNC 桌面上启动了一个窗口管理器，并提供两种主要模式：

  • vncserver （虚拟桌面）：允许用户在计算机上并行运行多个虚拟 X 显示会话，实现了多客户端访问该计算机的不同虚拟桌面，适合多用户并行使用；
  • x0vncserver （实机画面共享）：则不创建虚拟显示，而是共享一个现有的 X 服务器，通常被用于实机画面的控制服务。

安装 TigerVNC 服务端

Debain 系

根据需要安装下列包之一：

1
2
apt-get install tigervnc-standalone-server	# 完整安装
apt-get install tigervnc-scraping-server	# 仅 x0vncserver

RH 系

1
yum install tigervnc-server					# 确保以 root 身份登录

提醒： 对于 RH 系 的系统，如果没有连接到 RHN 或卫星服务器，请参考以下文章：

启动 vncserver (虚拟桌面)

准备文件

为需要用于启用 VNC 虚拟桌面服务的用户配置 VNC 密码，在必要时为每个 VNC 用户重复操作：

1
2
su - vncuser1			# 切换至对应用户
vncpasswd				# 为用户设置VNC密码

提醒： 使用 vncpasswd 为用户创建密码后，会在对应用户的 ~/.vnc/ 目录下生成名为 passwd VNC 密码文件，也可使用如下命令在任意位置创建任意名称的 VNC 密码文件：

1
vncpasswd .vncpasswd	# 在当前目录创建名为 .vncpasswd 的 VNC 密码文件

如需为用户配置分辨率，可选择以下两种方法之一：

  1. 统一配置。使用您喜欢的编辑器来编辑 /etc/sysconfig/vncservers 追加以下行：
1
2
3
VNCSERVERS="1:vncuser1 2:vncuser2"		# 将“vncuser1和“vncuser2”替换为正确的用户名
VNCSERVERARGS[1]="-geometry 1024x768"	# 根据需要添加更多用户
VNCSERVERARGS[2]="-geometry 1024x768"	# 根据需要更改分辨率值
  1. 单独配置。单独为某个用户配置分辨率，编辑 ~/.vnc/config 追加以下行：
1
geometry = <WIDTH> x <HEIGHT>

提醒： VNC 虚拟桌面默认分辨率为 1024x768。

创建服务

安装时将自动生成 /usr/lib/systemd/system/vncserver@.service 示例文件，若未找到，可按以下内容手动创建 vncserver@.service 文件：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
[Unit]
Description=Remote desktop service (VNC)
After=syslog.target network.target

[Service]
Type=simple

# Clean any existing files in /tmp/.X11-unix environment
ExecStartPre=/bin/sh -c '/usr/bin/vncserver -kill %i > /dev/null 2>&1 || :'
ExecStart=/usr/bin/vncserver_wrapper <USER> %i
ExecStop=/bin/sh -c '/usr/bin/vncserver -kill %i > /dev/null 2>&1 || :'

[Install]
WantedBy=multi-user.target

将其复制到 /etc/systemd/system/ 目录，单用户保持其原名称即可：

1
2
cp /usr/lib/systemd/system/vncserver@.service \
   /etc/systemd/system/vncserver@.service

多用户则需要分别命名：

1
2
3
4
5
6
7
# vncuser1
cp /usr/lib/systemd/system/vncserver@.service \
   /etc/systemd/system/vncserver-USER_1@.service
# vncuser2
cp /usr/lib/systemd/system/vncserver@.service \
   /etc/systemd/system/vncserver-USER_2@.service
# vncuser(n) ...

编辑 /etc/systemd/system/vncserver@.service 文件，将如下行中的 <USER> 替换为实际用户名，其他行不动：

1
ExecStart=/usr/bin/vncserver_wrapper <USER> %i

为确保变更生效，需执行以下命令：

1
systemctl daemon-reload			# 重载服务

启动服务

启动时需要指定一个非“0”的 <display_number> (“0”为实机画面预留显示号)，并根据系统支持执行以下两组命令之一：

1
2
3
4
5
6
7
# service 命令
service vncserver@:<display_number> start		# 启动服务
chkconfig vncserver@:<display_number> on		# 确保在重新启动时启动服务

# systemctl 命令
systemctl start vncserver@:<display_number>		# 启动服务
systemctl enable vncserver@:<display_number>	# 确保在重新启动时启动服务

启动 x0vncserver (实机画面)

x0vncserver 不创建虚拟桌面，而是共享当前物理显示器（DISPLAY=:0）。 适用于远程控制真实桌面（如 KDE、GNOME、XFCE）。

准备文件

使用 root 用户创建 VNC 密码文件，并将其保存在共享目录 /usr/share/ 下以避免权限问题：

1
2
mkdir /usr/share/.vnc
vncpasswd /usr/share/.vnc/passwd

创建服务 (systemd)

在 /etc/systemd/system/ 目录下手动创建 x0vncserver.service 文件：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
[Unit]
Description=Remote desktop service (X0VNC)
After=syslog.target network.target

[Service]
Type=simple

ExecStart=/usr/bin/x0vncserver \
        -SecurityTypes=VncAuth \
        -AlwaysShared \
        -PasswordFile=/usr/share/.vnc/passwd \
        -rfbport=5900 \
        -display=:0.0
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

为确保变更生效，需执行以下命令：

1
systemctl daemon-reload			# 重载服务

启动服务

根据系统支持执行以下两组命令之一：

1
2
3
4
5
6
7
# service 命令
service x0vncserver start		# 启动服务
chkconfig x0vncserver on		# 确保在重新启动时启动服务

# systemctl 命令
systemctl start x0vncserver		# 启动服务
systemctl enable x0vncserver	# 确保在重新启动时启动服务

(拓展)手动启动的方法

手动使用 TigerVNC 的 x0vncserver命令共享实机画面：

1
2
x0vncserver -PasswordFile=~/.vnc/passwd -AlwaysShared=1	# 使用用户的密码文件，或：
x0vncserver -PasswordFile=.vncpasswd -AlwaysShared=1	# 使用手动生成的密码文件

(拓展)脚本启动的方法

使用 git 工具克隆脚本仓库：

1
git clone https://github.com/sebestyenistvan/runvncserver.git

或者通过如下链接下载脚本，并手动上传至服务端主机：

1
2
cd ./runvncserver/		# 进入仓库目录
chmod +x ./startvnc		# 为脚本添加执行权限

脚本用法 (默认使用 ~/.vnc/passwd 文件，启动前确保文件存在)：

1
2
3
4
5
6
7
8
9
10
./startvnc
# Usage: ./startvnc start|stop|restart|status
./startvnc start
# Starting VNC Server on display :0 [ok]
./startvnc stop
# Stopping VNC Server: [ok] (pid: xxxx)
./startvnc restart
# Restarting VNC Server on display :0 [ok]
./startvnc status
# Status of the VNC server: [running] (pid: xxxx)

设置脚本开机自启的方法（将下方的地址替换为正确的脚本地址）：

1
echo "/home/user/runvncserver/startvnc start >/dev/null 2>&1" >> ~/.xsessionrc

(拓展) Upstart 自启动方案 (2026/04/20 更新)

测试环境：Kubuntu 14.04 + KDE + LightDM
方案背景：Ubuntu 14.04 默认使用 Upstart，而不是 systemd。 Kubuntu 14.04 的 KDE 桌面默认使用 LightDM 作为显示管理器。登录前 Xauthority 属于 LightDM，而不是用户，且登录后 Xauthority 仍然可用（14.04 不会切换）

经过多轮调试，我们最终得到一个具备如下功能的 通用 Upstart 脚本：

  • 自动检测 DISPLAY
  • 自动检测 LightDM / SDDM / KDM / GDM / 用户桌面
  • 自动检测 Xauthority
  • 自动检测 VNC 密码文件
  • 自动恢复
  • 失败延时 5 秒（防止疯狂重启）
  • 登录前可用（显示登录界面）
  • 登录后可用（显示桌面）
  • 运行日志记录

执行以下命令，为 DM （以 LightDM 为例）创建 VNC 密码（登录前使用）：

1
2
3
4
sudo mkdir -p /var/lib/lightdm/.vnc
sudo vncpasswd /var/lib/lightdm/.vnc/passwd
sudo chown -R lightdm:lightdm /var/lib/lightdm/.vnc
sudo chmod 600 /var/lib/lightdm/.vnc/passwd

创建 Upstart 服务配置。新建并编辑 /etc/init/x0vncserver.conf 文件，写入以下内容：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
description "Universal auto-detect x0vncserver for major Linux desktops"

start on runlevel [2345]
stop on runlevel [016]

respawn
respawn limit unlimited

script
    exec >> /var/log/x0vncserver.log 2>&1
    echo "===== x0vncserver starting at $(date) ====="

    # 每次重启前等待 5 秒，避免疯狂重启
    echo "Waiting 5 seconds before starting x0vncserver..."
    sleep 5

    # 等待 Xorg 启动
    while [ ! -e /tmp/.X11-unix/X0 ]; do
        echo "X not ready, waiting..."
        sleep 2
    done

    export DISPLAY=":0"
    echo "Using DISPLAY=$DISPLAY"

    # 自动检测 Display Manager 的 Xauthority
    # 优先级：LightDM → SDDM → KDM → GDM → 用户目录
    if [ -f /var/lib/lightdm/.Xauthority ]; then
        DM_USER="lightdm"
        XAUTH="/var/lib/lightdm/.Xauthority"

    elif [ -f /var/run/sddm/:0 ]; then
        DM_USER="sddm"
        XAUTH="/var/run/sddm/:0"

    elif [ -f /var/run/kdm/:0 ]; then
        DM_USER="kdm"
        XAUTH="/var/run/kdm/:0"

    elif [ -f /var/lib/gdm/.Xauthority ]; then
        DM_USER="gdm"
        XAUTH="/var/lib/gdm/.Xauthority"

    else
        # fallback：用户目录。判断是否用户已登录
        DM_USER=$(who | grep "(:0)" | awk '{print $1}' | head -n 1)
        [ -z "$DM_USER" ] && DM_USER="root"
        XAUTH="/home/$DM_USER/.Xauthority"
    fi

    export XAUTHORITY="$XAUTH"
    echo "Detected DM_USER=$DM_USER"
    echo "Using XAUTHORITY=$XAUTHORITY"

    # 自动选择密码文件
    if [ -f "/var/lib/$DM_USER/.vnc/passwd" ]; then
        PASSFILE="/var/lib/$DM_USER/.vnc/passwd"
    elif [ -f "/home/$DM_USER/.vnc/passwd" ]; then
        PASSFILE="/home/$DM_USER/.vnc/passwd"
    else
        echo "WARNING: No VNC password found for $DM_USER"
        PASSFILE=""
    fi

    echo "Using PASSFILE=$PASSFILE"

    # 启动 x0vncserver
    exec sudo -u "$DM_USER" /usr/bin/x0vncserver \
        -SecurityTypes=VncAuth \
        -AlwaysShared \
        -PasswordFile=$PASSFILE \
        -rfbport=5900 \
        -display=:0.0
end script

脚本使用及日志查看方法：

1
2
3
4
sudo service x0vncserver start		# 启动服务
sudo service x0vncserver stop		# 停止服务
sudo service x0vncserver restart	# 重启服务
tail -f /var/log/x0vncserver.log	# 查看日志

此时你可以在系统启动后就能远程看到实机的 KDE 登录界面。

配置防火墙

开放相应端口：

1
2
3
4
5
6
# x0vncserver
iptables -I INPUT -m state --state NEW -p tcp --destination-port 5900 -j ACCEPT
# vncuser1
iptables -I INPUT -m state --state NEW -p tcp --destination-port 5901 -j ACCEPT
# vncuser2
iptables -I INPUT -m state --state NEW -p tcp --destination-port 5902 -j ACCEPT

提醒： 实机画面需要打开5900端口，此外每个虚拟桌面用户都需要从 5901 开始的已打开的额外防火墙端口。因为在上面添加了两个用户，所以我们需要再打开两个端口。

保存规则(根据情况选择以下之一)：

1
2
service iptables save						# 旧版本
iptables-save > /etc/sysconfig/iptables		# 新版本

提醒： 对于 RHEL7 及以后系统出现缺少 iptables 命令或者重启后 iptables 规则失效的情况，请参考以下文章：

参考资料