如何通过自动化脚本快速配置CentOS VNC，实现高效远程桌面管理？

一、为什么需要自动化脚本来配置 CentOS VNC？

痛点 1：手工配置繁琐、易出错——在大量服务器上逐一执行 vncserver编辑 xstartup设置防火墙规则，耗时且每一步都可能因笔误导致连接失败。

痛点 2：安全性难以统一管控——手动打开端口或硬编码密码会导致安全隐患，缺乏统一的审计日志。

痛点 3：跨网站协作不顺畅——运维人员常在 Windows 客户端使用 VNC Viewer 远程连接 CentOS。如果网络不通或分辨率不匹配，会出现“连接失败”“黑屏”等常见问题。

通过一次性编写并部署自动化脚本。可一次性完成安装、配置、开机自启还有安全加固，明显提高效率并减少风险。

二、环境准备与基础依赖安装

# 更新程序
sudo yum update -y
# 安装图形桌面
sudo yum groupinstall -y "Server with GUI"
# 安装 VNC Server
sudo yum install -y tigervnc-server
# 安装 Expect
sudo yum install -y expect

1. 启用图形界面并设置默认运行级别

# 设置程序启动到图形界面
sudo systemctl set-default graphical.target
# 启动图形界面
sudo systemctl start graphical.target

2. 防火墙放行 VNC 端口

# 永久放行 5901/tcp
sudo firewall-cmd --permanent --add-port=5901/tcp
sudo firewall-cmd --reload

三、手动配置 VNC

1. 创建 VNC 服务使用者及密码

# 创建专用使用者
sudo adduser vncuser
sudo passwd vncuser
# 切换至该使用者并设置 VNC 密码
su - vncuser
vncpasswd # 按提示输入两次密码。选择是否创建只读密码
exit

2. 初始化 VNC Server 并生成默认 xstartup 文件

# 以新建使用者身份启动一次以生成默认配置文件
su - vncuser -c "vncserver :1"
# 关闭服务，准备自定义 xstartup 脚本
su - vncuser -c "vncserver -kill :1"

3. 编辑 xstartup

# 编辑 /home/vncuser/.vnc/xstartup
vi /home/vncuser/.vnc/xstartup
# 内容示例：
#!/bin/sh
unset SESSION_MANAGER
unset DBUS_SESSION_BUS_ADDRESS
&& exec /etc/vnc/xstartup
&& xrdb $HOME/.Xresources
gnome-session &

保存后赋予可执行权限：

chmod +x /home/vncuser/.vnc/xstartup

四、编写全自动化脚本

脚本说明：

• 使用 Bash 完成软件安装、设置和服务管理。
• 使用 Expect 自动输入 VNC 密码，实现无交互启动。
• 支持通过 SSH 隧道安全访问。
• 日志统一输出至 /var/log/vnc_setup.log便于审计。

a) 主 Bash 脚本 /usr/local/bin/setup_vnc.sh

> 2>&1
echo "=== 开始 CentOS VNC 自动化配置 $ ==="
# ---------- 1. 安装依赖 ----------
echo " 更新程序并安装常用软件..."
yum update -y && yum install -y "Server with GUI" tigervnc-server expect && \
systemctl set-default graphical.target && \
systemctl start graphical.target
# ---------- 2. 防火墙放行 ----------
VNC_PORT=5901
echo " 放行防火墙端口 $VNC_PORT..."
firewall-cmd --permanent --add-port=${VNC_PORT}/tcp && firewall-cmd --reload
# ---------- 3. 创建 VNC 使用者 ----------
VNC_USER="vncuser"
VNC_PASS="YourSecurePass"
if!id "$VNC_USER">/dev/null 2>&1;n
echo " 创建使用者 $VNC_USER..."
useradd -m "$VNV_USER"
echo "$VNV_USER:$VNV_PASS" | chpasswd
fi
# ---------- 4. 使用 Expect 设置 VNC 密码 ----------
EXPECT_SCRIPT="/tmp/set_vnc_pass.exp"
cat> "$EXPECT_SCRIPT" <'EOF'
#!/usr/bin/expect -f
set timeout 10
set user 
set pass 
spawn su - $user -c "vncpasswd"
expect "Password:"
send "$pass\r"
expect "Verify:"
send "$pass\r"
expect {
    "Would you like to enter a view-only password ?" { send "n\r" }
}
expect eof
EOF
chmod +x "$EXPECT_SCRIPT"
"$EXPECT_SCRIPT" "$VNC_USER" "$VNC_PASS"
# ---------- 5. 配置 xstartup ----------
XSTARTUP="/home/$VNC_USER/.vnc/xstartup"
cat> "$XSTARTUP" <'EOS'
#!/bin/sh
unset SESSION_MANAGER
unset DBUS_SESSION_BUS_ADDRESS
 && exec /etc/vnc/xstartup
 && xrdb $HOME/.Xresources
gnome-session &
EOS
chmod +x "$XSTARTUP"
chown "$VNC_USER":"$VNC_USER" "$XSTARTUP"
# ---------- 6. 创建 systemd service 文件 ----------
SERVICE_FILE="/etc/systemd/system/vncserver@:1.service"
cat> "$SERVICE_FILE" /dev/null 2>&1 || :
ExecStart=/usr/bin/vncserver :%i -geometry 1920x1080 -depth 24
ExecStop=/usr/bin/vncserver -kill :%i
WantedBy=multi-user.target
EOS
systemctl daemon-reload
# ---------- 7. 启动并设为开机自启 ----------
echo " 启动 VNC 服务..."
systemctl enable --now vcnserver@\:1.service || systemctl start vcnserver@\:1.service
echo "=== CentOS VND 自动化配置完成 $ ==="
exit 0

至于使用方法。

1. 将上述脚本保存为 /usr/local/bin/setup_vnc.sh
2. 再看赋予执行权限，

   # chmod +x /usr/local/bin/setup_vnc.sh 

3. 以 root 身份运行：

   # /usr/local/bin/setup_vnc.sh 

4. 脚本结束后检查日志 /var/log/vnc_setup.log.

五、Expect 脚本实现“一键登录”客户端

痛点：每次连接都要手动输入密码，尤其在批量运维时极其低效。

a) Expect 脚本 /usr/local/bin/vcn_connect.exp

User=youruser
ExecStart=/usr/bin/ssh -N -L 5901:localhost:5901 youruser@yourcentoshost
Restart=on-failure

WantedBy=multi-user.target


启动并设为自启：

sudo systemctl enable --now ssh-vnctunnel.service

七、常见问题排查

Pain Point	可能原因 Solution
连接失败 – “Connection Refused” 或 “Network Unreachable”	- 防火墙未放行对应端口。检查 `firewall-cmd --list-all` . - SELinux 阻止。从临时关闭测试来看，`setenforce 0` . 若确认无误，再永久添加策略。
黑屏 – 登录后显示空白或仅有光标	- xstartup 未正确启动桌面环境。确认文件拥有执行权限且包含 `gnome-session &` . - 分辨率不匹配。可在启动参数加入 `-geometry WIDTHxHEIGHT` 如 `-geometry 1920x1080`。
密码错误 – Expect 脚本报 “Password:” 超时	- 脚本中密码与实际设置不一致；请使用 `vncpasswd` 确认。- Expect 超时过短，可适当增大 `set timeout` 值。
服务无法自启 – 重启后 VNC 不再运行	- Systemd service 文件方法或使用者名错误。检查 ``systemctl status vcnserver@\:1.service` . - 确认已执行 `systemctl enable --now …` 而且服务文件权限为 root 可读。
SSH 隧道断开后无法重新连接	- 隧道进程意外退出。建议使用 Systemd 持久化隧道服务。- 本地防火墙阻止出站 SSH，可检查 `iptables` 或 `firewalld` 的 OUT 区域规则。
日志文件无输出或权限异常	- 脚本写日志的方法需拥有写权限；推荐放置于 `/var/log/` 并确保 `root` 权限或添加相应 ACL。- 检查 SELinux 上下文，如有必要执行 `restorecon -Rvv /var/log/vnc_setup.log`。

©2026 自动化运维教程 · All Rights Reserved.