如果 VNC Viewer 可以连接 macOS，但无法连接 Ubuntu，通常是由于 Ubuntu 上的 VNC 服务配置问题或网络限制导致的。以下是逐步排查和解决方案：
1. 确认 Ubuntu 上已安装并运行 VNC 服务
(1) 检查是否安装了 VNC 服务器
Ubuntu 常用的 VNC 服务器有：
-
TigerVNC（轻量级，推荐）
-
RealVNC（商业版）
-
x11vnc（临时共享）
安装 TigerVNC：
sudo apt update
sudo apt install tigervnc-standalone-server tigervnc-common(2) 设置 VNC 密码
vncpasswd（输入密码，会保存在 ~/.vnc/passwd）
(3) 启动 VNC 服务器
vncserver :1 -geometry 1920x1080 -depth 24-
:1表示显示端口5901（:2对应5902，依此类推）。 -
-geometry设置分辨率，-depth设置颜色深度。
(4) 检查 VNC 是否运行
ss -tulnp | grep vnc正常应显示：tcp LISTEN 0 5 0.0.0.0:5901 0.0.0.0:* users:(("Xvnc",pid=1234,fd=7))
如果没有，可能是服务未启动或端口被占用。
2. 检查防火墙是否放行 VNC 端口
(1) Ubuntu 防火墙（UFW）
sudo ufw status如果防火墙开启，放行 VNC 端口（默认 5901）：
sudo ufw allow 5901
sudo ufw reload(2) 检查云服务器安全组（如果是云主机）
-
AWS/Azure/GCP 需在控制台放行
5901端口（TCP）。
3. 确保 VNC 服务绑定到 0.0.0.0（允许远程连接）
默认情况下，VNC 可能只监听 127.0.0.1（仅本地访问），需修改配置：
vim ~/.vnc/config
添加：
localhost=no
然后重启 VNC：
vncserver -kill :1 vncserver :1
4. 检查 VNC 客户端连接方式
(1) 正确连接格式
在 VNC Viewer 输入：<Ubuntu的IP>:1
:1 对应 5901，:2 对应 5902，依此类推。
(2) 使用 SSH 隧道（更安全）
如果直接连接失败，可以尝试 SSH 端口转发：
ssh -L 5901:localhost:5901 username@ubuntu-ip
然后在 VNC Viewer 连接 localhost:1。
5. 常见错误及解决方案
| 错误现象 | 可能原因 | 解决方案 |
|---|---|---|
| Connection refused | 服务未运行/端口未开放 | 检查 vncserver 是否运行，防火墙是否放行 |
| Authentication failed | 密码错误 | 重新运行 vncpasswd 设置密码 |
| Black screen | 未正确启动桌面环境 | 确保 Ubuntu 安装了 GNOME/XFCE 等桌面 |
| Cannot currently show the desktop | 未配置桌面会话 | 修改 ~/.vnc/xstartup 文件 |
6. 配置桌面环境（解决黑屏问题）
如果连接后黑屏，可能是未正确启动桌面。编辑 ~/.vnc/xstartup：
写入（以 GNOME 为例）：
#!/bin/sh
unset SESSION_MANAGER
unset DBUS_SESSION_BUS_ADDRESS
exec /usr/bin/gnome-session然后赋予执行权限并重启 VNC：
chmod +x ~/.vnc/xstartup
vncserver -kill :1
vncserver :17. 测试 VNC 服务
在 Ubuntu 上运行：
vncserver -list
应显示：
TigerVNC server sessions:X DISPLAY # PROCESS ID :1 1234
然后在 VNC Viewer 输入 <Ubuntu-IP>:1，输入密码连接。
总结
-
安装 TigerVNC 并设置密码。
-
放行防火墙（
5901端口）。 -
确保 VNC 监听
0.0.0.0（允许远程连接）。 -
配置桌面环境（避免黑屏）。
-
使用 SSH 隧道（提升安全性）。
如果仍然无法连接，检查日志：
cat ~/.vnc/*.log
或尝试其他 VNC 服务器（如 x11vnc）：
sudo apt install x11vnc x11vnc -display :0 -forever -passwd 你的密码
