树莓派4B平台x11vnc服务启动失败（退出码错误）求助

1. 查看完整错误日志 #

先获取未省略的详细错误信息，执行以下命令：

systemctl status -l x11vnc.service
# 或者查看更完整的系统日志
journalctl -u x11vnc.service -e

详细日志会指出具体失败原因（如找不到X显示、权限问题、密码文件错误等）。

2. 验证X11桌面会话状态 #

• 确认树莓派已启用桌面环境：执行raspi-config，选择System Options > Boot / Auto Login，设置为Desktop Autologin或Desktop，重启后生效。
• 检查当前是否有X11会话在:0运行：

ps aux | grep Xorg
who

如果没有Xorg进程，说明桌面未启动，x11vnc无法连接到显示。

3. 检查密码文件有效性 #

• 确认密码文件/home/root/.vnc/passwd存在且权限正确：

ls -l /home/root/.vnc/passwd

权限应为-rw-------（600），否则x11vnc会拒绝读取。如果文件不存在，以root身份执行以下命令生成：

x11vnc -storepasswd /home/root/.vnc/passwd

4. 修正systemd服务配置 #

编辑/lib/systemd/system/x11vnc.service文件，完善[Service]段的配置：

[Service]
Type=simple
User=root
Environment="DISPLAY=:0"
Environment="XAUTHORITY=/root/.Xauthority"
ExecStart=/usr/bin/x11vnc -forever -display :0 -auth ${XAUTHORITY} -passwdfile /home/root/.vnc/passwd
Restart=on-failure
RestartSec=5
After=graphical.target

• 替换-auth guess为明确的.Xauthority路径，避免猜解失败
• 添加After=graphical.target确保服务在桌面启动后再启动
• 保存文件后重新加载systemd配置并重启服务：

systemctl daemon-reload
systemctl restart x11vnc.service

5. 手动启动测试定位问题 #

直接在终端执行启动命令，查看实时错误输出：

/usr/bin/x11vnc -forever -display :0 -auth guess -passwdfile /home/root/.vnc/passwd

终端会输出具体的错误提示（如无法连接到:0显示、权限不足等），根据提示针对性解决。

6. 验证x11vnc安装完整性 #

确认x11vnc已正确安装：

which x11vnc

如果输出为空，重新安装：

apt update && apt install -y x11vnc

内容的提问来源于stack exchange，提问作者Vipul Suneja