深圳市网站建设_网站建设公司_前后端分离_seo优化
2026/1/16 14:09:43 网站建设 项目流程

从零配置 VNC 服务:解决“目标计算机积极拒绝”连接问题完整指南


本文记录了在 Linux 服务器(Ubuntu 22.04)上从零配置 TigerVNC 服务的全过程,重点解决客户端连接时出现的错误:

“Unable to connect to socket: 由于目标计算机积极拒绝,无法连接。(10061)”

适用于 Docker 容器、云服务器、本地虚拟机等环境,最终实现通过 TigerVNC Viewer 成功连接图形桌面。


一、环境说明

  • 系统:Ubuntu 22.04 LTS(最小化安装)
  • 用户:root
  • IP 地址:========(内网 IP)
  • VNC 端口:5901(对应显示号 :1)
  • 桌面环境:XFCE4
  • 客户端:Windows 上的 TigerVNC Viewer

二、确认 VNC 服务已安装

首先确认tigervnc-standalone-server已安装:

aptupdate&&aptinstall-y tigervnc-standalone-server

三、设置 VNC 密码

运行以下命令设置密码(首次运行会提示输入):

vncserver

密码将保存在/root/.vnc/passwd,无需重复设置。


四、配置 xstartup 脚本

编辑~/.vnc/xstartup文件:

nano~/.vnc/xstartup

确保内容如下:

#!/bin/shunsetSESSION_MANAGERunsetDBUS_SESSION_BUS_ADDRESSexecstartxfce4

赋予执行权限:

chmod+x ~/.vnc/xstartup

五、启动 VNC 服务并绑定到所有网络接口

vncserver -kill :12>/dev/null vncserver -localhost no :1 -geometry 1280x720 -depth24

-localhost no:允许外部连接
-geometry:设置分辨率
-depth:设置颜色深度


六、检查服务是否正常运行

psaux|grepvnc

输出示例:

root 8320 0.0 0.0 245704 67956 ? Ss 13:24 0:00 /usr/bin/Xtigervnc :1 -localhost=0 -desktop 760inpb4plcdq-0:1 (root) -rfbport 5901 -PasswordFile /root/.vnc/passwd -SecurityTypes VncAuth,TLSVnc -auth /root/.Xauthority -geometry 1280x720 -depth 24

检查端口监听状态:

netstat-tlnp|grep:5901

正常输出应包含:

tcp 0 0 0.0.0.0:5901 0.0.0.0:* LISTEN 8320/Xtigervnc

七、安装 XFCE 桌面环境(如未安装)

aptupdate&&aptinstall-y xfce4 xfce4-goodies

验证安装:

whichstartxfce4

应输出:

/usr/bin/startxfce4

八、查看 VNC 服务日志

tail-f ~/.vnc/760inpb4plcdq-0:5901.log

常见错误:

  • Session startup via '/root/.vnc/xstartup' cleanly exited too early (< 3 seconds)!
    → 检查xstartup脚本是否正确。

  • ImportError: libQt5Core.so.5: cannot open shared object file: No such file or directory
    → 无关紧要,不影响 VNC 服务运行。


九、测试最简模式(xterm)

如果桌面环境启动失败,可先测试最简模式:

vncserver -kill :1 vncserver -localhost no :1 -geometry 1280x720 -depth24-xstartup /usr/bin/xterm

在客户端连接localhost:5901,应看到终端窗口。


十、解决“目标计算机积极拒绝”连接问题

10.1 确认客户端与服务器在同一子网

在 Windows 上运行:

ipconfig

确保你的 IP 与服务器在同一网段(如10.31.26.x)。


10.2 尝试使用 SSH 隧道连接(推荐)

在 Windows 上运行:

ssh -L 5901:localhost:5901 root@10.31.==.===

然后在 VNC 客户端连接:

localhost:5901

10.3 使用 x11vnc 替代 TigerVNC(终极方案)

安装x11vnc

aptinstall-y x11vnc

设置密码:

x11vnc -storepasswd /root/.vnc/passwd

启动服务:

x11vnc -display :1 -passwd /root/.vnc/passwd -localhost no -forever -shared -rfbport5901

在客户端连接localhost:5901,即可看到桌面。


十一、配置开机自启(可选)

方法一:使用 crontab

编辑 root 的 crontab:

crontab-e

添加:

@reboot /root/startvnc.sh

创建启动脚本:

nano/root/startvnc.sh

内容:

#!/bin/bashvncserver -kill :12>/dev/null vncserver -localhost no :1 -geometry 1280x720 -depth24

赋予执行权限:

chmod+x /root/startvnc.sh

十二、安全建议

  • 使用强密码;
  • 不要开放 5901 端口到公网;
  • 推荐使用 SSH 隧道连接;
  • 如需公网访问,建议配置 TLS 加密或使用反向代理。

十三、常见问题排查

13.1 “Connection refused” 或 “Connection timed out”

  • 检查netstat -tlnp | grep :5901是否监听0.0.0.0:5901
  • 检查防火墙是否放行 5901 端口;
  • 检查客户端与服务器是否在同一子网。

13.2 “Session startup via ‘/root/.vnc/xstartup’ cleanly exited too early”

  • 检查xstartup脚本是否正确;
  • 确保startxfce4命令存在;
  • 尝试最简模式测试。

13.3 “libQt5Core.so.5: cannot open shared object file”

  • 无关紧要,不影响 VNC 服务运行;

  • 可忽略或安装qt5-default解决:

    aptinstall-y qt5-default

十四、总结

本文从零开始配置 VNC 服务,解决“目标计算机积极拒绝”连接问题,最终实现通过 TigerVNC Viewer 成功连接图形桌面。

关键步骤:

  1. 安装 TigerVNC;
  2. 设置密码;
  3. 配置xstartup脚本;
  4. 启动服务并绑定到所有网络接口;
  5. 安装 XFCE 桌面环境;
  6. 使用x11vnc作为终极解决方案;
  7. 配置开机自启;
  8. 安全建议。

附:常用命令速查表

功能命令
启动 VNC 服务vncserver -localhost no :1 -geometry 1280x720 -depth 24
杀死 VNC 服务vncserver -kill :1
检查端口监听`netstat -tlnp
查看 VNC 日志tail -f ~/.vnc/760inpb4plcdq-0:5901.log
安装 XFCEapt install -y xfce4 xfce4-goodies
安装 x11vncapt install -y x11vnc
启动 x11vncx11vnc -display :1 -passwd /root/.vnc/passwd -localhost no -forever -shared -rfbport 5901

本文适用于 Ubuntu 22.04 系统,其他版本请根据实际情况调整命令。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询