树莓派安装VNC服务器失败，绝大多数情况下不是硬件问题，而是系统自带的RealVNC与桌面环境冲突，或者安装源版本不匹配导致的。直接换用TightVNC或TigerVNC，并手动指定桌面会话,基本能解决九成以上的故障。
为什么你的树莓派装上VNC却连不上
很多朋友拿到树莓派第一件事就是开VNC，结果不是提示连接被拒绝，就是黑屏一片，排查之前先搞清楚问题的根源在哪里,方向错了重装十次也是白费功夫。
最常见的三种失败现场
- 安装命令执行到一半报错，提示依赖关系缺失,这通常是因为系统源没有更新或者源地址失效。
- 安装过程一切顺利，但用客户端一连接直接提示Connection refused，这是VNC服务压根没启动起来,或者端口被防火墙挡了。
- 连接后能输入密码，进到桌面却是一片灰白或者只有鼠标指针,这是桌面环境没有正确传递给VNC服务。
第一件事永远是更新系统源
不要跳过这一步，树莓派官方系统的软件源地址偶尔会变动，老旧的索引会导致拉取不到最新版本的VNC组件，执行完下面命令再继续,能规避掉相当一部分安装报错。
sudo apt update sudo apt upgrade -y
业内专家指出，更新源之后再装软件，成功率比直接装高出很多,这已经是树莓派排障的默认前置步骤了。
树莓派安装vncserver命令失败的两种处理方案
搞清楚失败原因之后，接下来就是动手解决，根据你的实际需求选一条路走，不要两条路混着来,容易把系统搞乱。
启用系统自带RealVNC（适合安装失败后想走捷径的用户）
树莓派官方系统其实内置了RealVNC服务器，只是默认没有开启，很多人自己手动去装另一个版本，反而把系统自带的配置文件给覆盖了,导致两边都起不来。
依次运行下面命令：
sudo raspi-config
在弹出的界面中用键盘上下键选择Interface Options，回车进入后再选择VNC，系统会问你是否启用，选是然后回车。
启用后重启一下树莓派：
sudo reboot
重启完在终端里运行：
sudo systemctl status vncserver-x11-serviced
看到绿色的active (running)字样就说明服务正常了,这时候用客户端连接就顺理成章。
适用场景判断：如果只是想在局域网内远程操作桌面，这个方案完全够用，步骤最短,失败率最低。
安装TigerVNC并手动指定桌面会话（适合RealVNC不兼容的用户）
RealVNC偶尔会出现与当前桌面会话不匹配的情况，表现就是连上就黑屏退出，遇到这种情况直接放弃它,转投TigerVNC的怀抱比较省心。
先卸载可能冲突的组件：
sudo apt remove realvnc-vnc-server -y
再安装TigerVNC：
sudo apt install tigervnc-standalone-server tigervnc-common -y
安装完成后设置一个独立的VNC访问密码（注意这个密码可以和系统用户密码不同）：
vncpasswd
然后手动启动一个虚拟桌面,指定分辨率和桌面环境：
vncserver :1 -geometry 1920x1080 -depth 24
连接的时候在客户端地址栏输入你的树莓派IP:1即可，如果这一条命令执行成功，说明VNC服务器本身已经没问题了,剩下的就是开机自启和桌面配置的优化。
两种方案的对比数据
| 对比项 | 系统自带RealVNC | TigerVNC |
|---|---|---|
| 安装复杂度 | 低，一个命令启用 | 中，需要手动装包 |
| 默认桌面兼容性 | 与官方系统最佳 | 需要手动指定会话 |
| 失败率 | 较高（受版本影响） | 较低 |
| 适合场景 | 新装系统快速启用 | 黑屏或连接拒绝排障 |
树莓派vnc连接不上屏幕全黑问题定位
黑屏是VNC故障里最磨人的一个表现，服务状态正常，密码也通过了，就是看不到桌面图标,这背后是显示协议捣的鬼。
根因分析：XSession缺省配置不可用
树莓派官方系统默认走Wayland协议的趋势越来越明显，但很多VNC服务端还是基于古老的X11协议编写，当VNC启动时找不到一个可用的Xsession文件,就会呈现出一个空桌面。
解决黑屏问题的标准办法
编辑VNC的启动配置文件，让它在启动时明确加载LXDE桌面（树莓派官方桌面就是基于LXDE的）。
对于TigerVNC,执行：
nano ~/.vnc/xstartup
清空后写入：
#!/bin/sh unset SESSION_MANAGER unset DBUS_SESSION_BUS_ADDRESS exec startlxde
保存退出后,赋予这个文件执行权限：
chmod +x ~/.vnc/xstartup
杀掉现有的VNC进程并重新启动：
vncserver -kill :1 vncserver :1
这里有一个容易栽坑的细节：如果当前系统用户是pi，文件路径就是/home/pi/.vnc/xstartup，用root身份登录的那就需要对应修改路径,否则配置不生效。
解决连接提示超时和密码验证失败
连接超时和密码无效是第二大类高频问题,这两个问题常被误导成VNC安装失败,实际上和安装行为本身关系不大。
超时问题优先检查端口状态
VNC默认监听在5901端口（对应桌面编号:1）,在树莓派本机终端执行：
netstat -tlnp | grep 5901
看到0.0.0:5901在LISTEN状态，说明服务在正常等待连接，如果什么都没输出,大概率是端口没起来。
路由器端口映射常常被遗漏，如果要从外网访问，还要在路由器上做端口转发，把外网端口转发到树莓派的内网IP和5901端口上，这一步不做,外网连接必然超时。
密码验证失败是客户端侧的毛病
- 确认不是键盘大小写锁定。
- 确认密码是VNC连接密码,不是系统登录密码。
- 客户端密码保存格式过旧,删掉旧的保存记录重新输入。
树莓派vnc开机自启服务配置步骤
前边所有步骤弄通以后，重启一次树莓派，VNC服务又消失了，等于每次想远程访问都得先对着屏幕操作一遍,所以配置开机自启是收尾的关键动作。
通过systemd实现TigerVNC自启
创建一个系统服务文件：
sudo nano /etc/systemd/system/vncserver@.service
写入：
[Unit] Description=VNC Server for %i After=syslog.target network.target [Service] Type=forking User=pi Group=pi WorkingDirectory=/home/pi ExecStart=/usr/bin/vncserver :%i -geometry 1920x1080 -depth 24 ExecStop=/usr/bin/vncserver -kill :%i [Install] WantedBy=multi-user.target
保存后重新加载系统服务管理配置：
sudo systemctl daemon-reload sudo systemctl enable vncserver@1.service sudo systemctl start vncserver@1.service
以后树莓派开机就会自动拉起一个位于桌面1的VNC服务，直接连IP地址加1就能用,这对买了树莓派想当小服务器长期运行的用户来说比较实用。
VNC安装失败不是死路一条，按照先更新源、再选对方案、最后检查桌面会话的顺序去排查，绝大多数问题都能在半小时内解决，愿看到这里的你,能在远程桌面上顺利看到那个熟悉的树莓派桌面。
树莓派VNC相关常见问题解答
问：树莓派安装vncserver命令总是提示找不到软件包，换了源也不行，怎么回事？
系统架构不匹配是检查方向之一，树莓派新系统默认是64位的，如果安装的软件源里只有armhf架构的包，就会提示找不到，执行uname -m确认架构，再检查/etc/apt/sources.list里的源地址是否与系统版本一致。
问：手机端用的VNC客户端和电脑端有区别吗？
客户端协议本身没有区别，都走VNC标准协议，需要关注的是手机屏幕分辨率与VNC服务端设置的分辨率差异过大时，画面可能显示不全，这时修改vncserver启动命令中的-geometry参数即可适配,不用换客户端软件。
首发原创文章，作者：王坚，如若转载，请注明出处：https://idctop.com/article/786639.html
