最常见原因是防火墙未放行端口或服务监听地址为127.0.0.1而非0.0.0.0；需用ss -tlnp | grep :5901确认监听地址，若为127.0.0.1则需修改xstartup并确保firewalld放行对应端口（如5901/tcp）。
为什么 vncserver 启动后连不上，提示 connection refused？
最常见原因是防火墙没放行对应端口，或者服务根本没监听在预期地址上。TigerVNC 默认监听 127.0.0.1（仅本机），不是 0.0.0.0，所以从外部 IP 连接时会直接被拒绝。
检查方法：ss -tlnp | grep :590，看输出里是 127.0.0.1:5901 还是 *:5901。
- 若显示
127.0.0.1:5901：需修改用户级配置，编辑~/.vnc/xstartup前加一行export DISPLAY=:1，再重启服务 - 若防火墙开着（如
firewalld）：运行sudo firewall-cmd --permanent --add-port=5901/tcp并重载规则 - 别信“改了
/etc/sysconfig/vncservers就万事大吉”——CentOS 7+ 已弃用该文件，改用 systemd 单元文件
怎么让 vncserver 开机自启且以普通用户身份运行？
不能用 root 启动 VNC 服务再切用户，必须为每个目标用户单独配置 systemd service。否则桌面环境变量、~/.Xauthority 权限、GNOME/Wayland 会出问题。
以用户 dev 为例：
- 先切换到该用户：
su - dev，运行vncpasswd设置密码 - 复制模板：
sudo cp /lib/systemd/system/vncserver@.service /etc/systemd/system/vncserver@:1.service - 编辑新文件，把
<user></user>替换为dev，并确认ExecStart中的 display 号与你启动时一致（如:1） - 启用服务：
sudo systemctl daemon-reload && sudo systemctl enable vncserver@:1.service && sudo systemctl start vncserver@:1.service
注意：@:1 中的 :1 必须和你实际用的 display 编号严格一致，否则启动失败但日志不报错。
xstartup 文件权限或内容错误，导致黑屏或闪退
这是图形界面进不去的第二大原因。VNC 启动后只执行 ~/.vnc/xstartup，如果它不可执行、路径不对、或里面没正确调起桌面环境，就会卡在灰屏或立刻断开。
标准修复步骤：
- 确保文件存在且可执行：
chmod +x ~/.vnc/xstartup - 内容至少包含三行（以 GNOME 为例）：
#!/bin/sh unset SESSION_MANAGER exec /etc/X11/xinit/xinitrc
，或更稳妥的：#!/bin/sh export XKL_XMODMAP_DISABLE=1 exec gnome-session
- 如果系统用的是 Wayland（如较新 CentOS/RHEL 8+），必须在
/etc/gdm/custom.conf中取消注释WaylandEnable=false，否则vncserver无法接管 Xorg 会话
客户端连接时输对密码却进不了桌面，只看到灰色背景或弹窗消失
大概率是 vncserver 启动时没加载图形环境依赖，或者桌面会话已损坏。不要反复杀进程重试，先查日志。
关键日志位置：~/.vnc/hostname:1.log（比如 node3:1.log）。打开它，重点搜 failed、error、cannot open display。
- 出现
Cannot establish any listening sockets：端口被占，用lsof -i :5901查进程并 kill - 出现
Could not open default font 'fixed'：缺字体包，装liberation-fonts-common和xorg-x11-fonts-misc - 出现
gnome-session-binary[xxx]: Gnome session terminated：GNOME 配置损坏，临时改用twm测试：echo "twm &" > ~/.vnc/xstartup
真正麻烦的不是配不起来，而是日志里没报错却连不上——这时候八成是 SELinux 拦截了 X11 socket 或 home 目录上下文，setsebool -P xserver_execmem 1 或临时 setenforce 0 可快速验证。
