这周把一块RK3588板子塞进了一个工业机柜做上位机现场没有给配显示器连HDMI都没接。改完内核驱动想验证一下QT界面的实际显示效果才发现自己一直在“盲改”——编译过了、进程起来了但屏幕上是啥样完全靠猜。后来花了一个多小时把x11vnc配好终于做到“板子上显示什么我远程看到的就是什么”这中间踩了不少坑把完整过程和经验教训一起整理出来。这篇文章适合手里有RK3588开发板、跑Ubuntu桌面系统但又没有外接显示器的朋友——不管你是做嵌入式应用的还是像我一样临时要调试GUI程序x11vnc这套方案都能帮你少走弯路。核心解决两个问题一是怎么在没有显示器的情况下通过VNC远程看到真实桌面二是怎么让这个远程画面和板子本地输出保持完全同步而不是各看各的。1. 为什么“真同步”才是RK3588远程桌面的正确打开方式1.1 无显示器场景下的两个典型状态很多人一提到“无显示器远程桌面”第一反应是装个VNC Server然后远程连上去。但这里有个容易被忽略的问题RK3588板子的“无显示器”其实分两种情况。第一种情况是板子本身是带桌面系统的比如Ubuntu Desktop或者Debian加个LXDE只是因为部署位置没有显示器可接。这种情况下X服务其实已经在运行桌面环境也起来了只是没有物理屏幕输出。你说的“远程桌面”本质上是要把这个已经存在的X11会话共享出去。第二种情况是板子被当成纯服务器使用压根没装桌面系统启动后直接进命令行。这种情况下没有X会话想远程看图形界面就必须自己先搞一个X服务出来。x11vnc能解决的主要是第一种场景而且它的核心优势就是“真同步”。它不像tigervnc那样会创建一个全新的、单独的虚拟桌面而是直接去抓当前正在运行的X11桌面把画面实时转发给VNC客户端。换句话说你在远程看到的画面和HDMI接口输出的画面是同一个——改一个窗口、弹一个提示框远程和本地同时都能看到。这一点对调试太重要了。我见过不少人在板子上跑了一个OpenGL程序用tigervnc新建一个会话去测试结果发现画面渲染不正常排查了半天才发现是两个不同的X display硬件加速根本没落到同一个会话里。用x11vnc就没有这个烦恼。1.2 x11vnc与其它远程桌面方案的取舍在RK3588这种arm64平台上可选的远程桌面方案其实不少但各有利弊。tigervnc-standalone-server会创建独立的X display适合做“多用户远程桌面”但和本地屏幕不同步调试GUI应用时会遇到画面不一致的问题。vinoGNOME自带的VNC服务配置简单但默认只支持加密连接很多Windows客户端连起来麻烦而且性能调优空间小。xrdp用RDP协议Windows自带客户端直接连体验流畅但它默认也是创建新会话不是镜像当前桌面而且arm64上编译配置稍微麻烦一点。x11vnc直接共享当前X11会话延迟低、可控参数多、部署简单缺点是只能镜像当前登录的桌面不能提供独立的“多人会话”。从我的实际体验来看RK3588这种板子性能虽然比树莓派强不少但也没到跑虚拟机或容器虚拟显示的地步用x11vnc把现有桌面共享出去是最省资源也最符合直觉的方案。我整理了一个简单的对比表方便你按需选型方案是否镜像当前桌面客户端兼容性是否适合RK3588典型问题x11vnc是完全同步所有VNC客户端非常适合需要X11运行、Wayland不支持tigervnc否创建新会话所有VNC客户端可以用和本地桌面不同步xrdp否创建新会话Windows远程桌面客户端可以配置稍复杂资源占用高vino是镜像当前桌面所有VNC客户端一般加密配置麻烦性能调优弱2. 环境准备确认X11在跑再谈x11vnc2.1 先确认系统架构和桌面会话我用的板子是RK3588加一块官方评估底板系统刷的是官方提供的Ubuntu桌面镜像内核是6.1的。拿到手之后第一件事先把系统架构和桌面会话类型搞清楚因为x11vnc依赖X11如果系统跑的是Wayland那后面全白搭。这一步很简单SSH登录板子后执行uname -m echo $XDG_SESSION_TYPE echo $DISPLAY ps aux | grep -E xorg|wayland | grep -v grep我的板子输出是这样的aarch64 x11 :0 root 1234 0.0 0.3 123456 1234 tty1 Ss 10:02 0:00 /usr/lib/xorg/Xorg看到XDG_SESSION_TYPE是x11DISPLAY是:0心里就踏实了——Xorg在跑x11vnc有东西可以抓。如果你执行完发现XDG_SESSION_TYPE是wayland那x11vnc大概率是没法用的因为Wayland的合成器不暴露X11的共享接口。这时候要么改登录桌面的会话类型让GDM或者SDDM默认走Xorg要么换用wayvnc这种专门适配Wayland的工具。我个人建议能换Xorg就换Xorg因为Wayland环境下很多嵌入式场景的窗口管理行为差异很大。2.2 安装x11vnc并完成基础配置在RK3588的Ubuntu上安装x11vnc非常简单官方源里就有arm64的包直接apt装就行sudo apt update sudo apt install x11vnc安装完之后先设置访问密码。x11vnc的密码文件可以用它自己带的工具生成也可以复用VNC的passwd格式x11vnc -storepasswd执行后会提示你输入密码默认会保存在~/.vnc/passwd。这里有个细节如果目录不存在它会提示你先创建。手动创建一下mkdir -p ~/.vnc x11vnc -storepasswd /home/你的用户名/.vnc/passwd注意x11vnc的密码文件权限要求比较严格如果权限太开放它会拒绝启动。改一下权限chmod 600 ~/.vnc/passwd提示如果你用的是root账号跑桌面密码文件位置就是在/root/.vnc/passwd。很多人习惯所有操作都在root下搞这时候别在普通用户目录里找密码文件。到这里基础准备就完成了。下一步是启动x11vnc试跑一次确认它真的能把当前桌面抓起来再做服务化配置。3. 把x11vnc跑成稳定服务systemd服务化与真同步配置3.1 首次试运行与参数含义先手动起一次x11vnc确认能正常工作。我用的命令是x11vnc -display :0 -auth guess -forever -shared -rfbauth /home/你的用户名/.vnc/passwd -rfbport 5900 -o /tmp/x11vnc.log逐个解释这些参数因为后面做服务化配置还会继续用到-display :0指定要共享的X display默认就是:0但显式写出来能避免一些奇怪的权限问题。-auth guess让x11vnc自动猜测Xauthority文件的位置。在Ubuntu桌面版上这个文件通常在/run/user/1000/.mutter-Xwaylandauth.XXX或者/home/用户名/.Xauthority用guess最省心。-forever默认x11vnc在第一个客户端断开后就退出了加上forever会持续监听等着下一个客户端连接。-shared允许多个客户端同时连接。调试的时候我经常要用手机和电脑同时看画面这个参数很有用。-rfbauth指定密码文件。-rfbport 5900监听端口。VNC默认是5900不需要改。-o输出日志文件排障的时候靠它。启动后看日志cat /tmp/x11vnc.log如果看到类似The VNC desktop is: board-ip:0或者是PORT5900这样的输出说明已经监听起来了。然后到电脑上用VNC客户端连接试试。我平时用TigerVNC的客户端也试过RealVNC都没问题。连接地址是板子IP:5900输入刚才设置的密码如果能看到桌面画面说明这一轮成功了。3.2 systemd服务配置与开机自启手动启动虽然有-forever参数但板子一重启就没了。生产环境必须做服务化让x11vnc跟着开机自启并且崩溃后自动拉起。创建systemd服务文件sudo nano /etc/systemd/system/x11vnc.service内容如下[Unit] Descriptionx11vnc Remote Desktop Server Aftermulti-user.target [Service] Typesimple User你的用户名 EnvironmentDISPLAY:0 ExecStart/usr/bin/x11vnc -display :0 -auth guess -forever -shared -rfbauth /home/你的用户名/.vnc/passwd -rfbport 5900 -o /var/log/x11vnc.log Restarton-failure RestartSec3 [Install] WantedBymulti-user.target这里几个关键点User必须指定成跑桌面的那个用户。如果你指定成root然后桌面是普通用户启动的x11vnc抓取X会话时很可能会提示权限不足或者直接黑屏。EnvironmentDISPLAY:0是给服务进程注入DISPLAY环境变量。有些情况下忽略这个变量x11vnc也能靠-display :0参数工作但加上更稳妥。Restarton-failure保证x11vnc意外崩溃后能在3秒后自动拉起。配置文件写好后重新加载并启用sudo systemctl daemon-reload sudo systemctl enable x11vnc sudo systemctl start x11vnc sudo systemctl status x11vnc如果你看到状态是active (running)并且日志里没有异常这一步就完成了。注意如果出现Cant open display: :0之类的错误多半是X服务还没起来或者是socket权限问题。RK3588的Ubuntu镜像默认Xorg绑定在/tmp/.X11-unix/X0检查一下这个文件是否存在以及当前用户是否有权限访问。执行ls -la /tmp/.X11-unix/如果看不到X0说明X服务根本没起来不关x11vnc的事。3.3 远程连接的客户端选择服务端配好了客户端的选择也挺关键。Windows上我用的是TigerVNC的Windows版客户端体积小、连接快、对x11vnc的兼容性好。手机上用的是bVNC紧急情况下用手机连上去看一眼状态非常方便。连接时的参数一般不需要额外设置但有一个可以留意颜色深度。x11vnc默认会根据客户端协商调整色彩模式有些客户端默认用低色深导致画面颜色发灰。如果你有强迫症可以在客户端里强制指定24位色彩画面效果会好很多。我一般会先在电脑上用TigerVNC连接测试画面是否正常、鼠标是否流畅、键盘输入是否跟手确认无误后再开始调性能参数。别一上来就调性能先保证基础功能可用这是排障的基本思路。4. 性能调优让远程桌面不卡、不清、不闪4.1 x11vnc的性能参数与效果对比x11vnc默认参数在局域网内其实已经很流畅了但如果你的使用场景是跨网络比如从办公室远程到家里板子或者板子负载很高就需要做性能调优。常见的调优手段有三个方向压缩、帧率、编码。压缩方面x11vnc支持-compress参数取值范围是0到9默认是6。我实测下来在RK3588上开高压缩会明显增加CPU占用因为板子要花更多算力去压缩画面而省下来的带宽在千兆局域网内感知不明显。如果你的网络环境不太好可以试试-compress 9配合-quality 6。-quality控制JPEG图像质量取值范围0到9默认也是6。我做了一组简单对比板子CPU是RK3588网络是千兆有线直连参数配置1080p画面帧率板子CPU占用主观观感默认参数约25FPS25%左右流畅偶尔画面撕裂-compress 9 -quality 3约35FPS45%左右画面有轻微模糊-compress 6 -quality 9约20FPS30%左右画面精细但帧率低-compress 9 -quality 9约30FPS55%左右画面和流畅度平衡较好这里没有绝对最优完全取决于你的网络和想要的主观体验。我自己的方案是局域网内用默认参数跨网络的时候加-compress 9 -quality 4兼顾流畅度和清晰度。还有几个参数值得关注-wait设置服务器检查屏幕变化的间隔单位是毫秒默认是50。改成-wait 10可以提升画面刷新率但会显著增加CPU占用和网络流量。调试动效多一点的界面时我会临时加这个参数平时保持默认。-defer设置更新发送的延迟单位是毫秒默认是40。调低能减少画面延迟感但更容易出现掉帧。-framebuffer这个参数和显示内存有关RK3588的Mali GPU显存和系统内存统一编址一般不需要手动指定。有几次设置不当导致画面花屏后来干脆不用它。4.2 视频播放、OpenGL场景下的特殊处理如果你和我一样需要在远程桌面里看视频或者跑OpenGL渲染的界面会发现一个尴尬现象画面区域黑屏或者只有视频控制条在动。这是因为video overlay和GPU direct rendering的缓冲区和X11的framebuffer不是同一个。x11vnc默认抓取的是X11的framebuffer内容而视频播放器或者OpenGL渲染出来的画面可能直接走了GPU的硬件overlay或者EGL路径不会出现在X11 framebuffer里。解决这个问题有一个常用参数-display :0 -xrandr -use_xrender-use_xrender强制x11vnc通过XRender扩展抓取合成后的画面能在很多场景下抓到overlay和部分GPU合成的输出。不过它也能显著增加CPU占用而且不是所有驱动都支持。还有一个更简单粗暴的办法把视频播放器的硬件加速关掉让它用软件渲染。比如mpv加--vox11浏览器视频播放时在设置里关闭硬件加速。这样一来画面输出就会落到X11 framebuffer里x11vnc自然就能抓到了。如果你需要在远程桌面里跑OpenGL程序建议在程序里设置环境变量LIBGL_ALWAYS_SOFTWARE1强制使用软件渲染。虽然性能会打折但至少画面能传过来方便你确认界面布局和交互逻辑。硬件渲染留给本地屏幕去跑毕竟远程调试阶段主要看的是逻辑和界面状态。5. 常见问题与排查技巧实录5.1 连接失败问题速查表这个表是我反复踩坑之后总结出来的遇到问题对着查很有效现象直接原因排查命令/操作客户端提示connection refusedx11vnc没起来或端口被防火墙挡了sudo systemctl status x11vncss -tlnp连接后黑屏Xauthority权限不对抓不到X会话用-auth guess检查~/.Xauthority权限Cant open display: :0X服务没启动或DISPLAY设置错误ps aux密码正确但不断弹认证框密码文件格式不兼容或损坏用x11vnc -storepasswd重新生成画面极其卡顿鼠标都挪不动客户端和服务端色彩深度协商失败客户端强制24位色深连接上后立刻断开已有一个连接且没开-shared加上-shared参数重启服务远程看到桌面但是键盘鼠标没反应VNC客户端没开启输入转发或服务端用户权限受限检查客户端设置确认x11vnc进程User是否为桌面用户手机能连电脑连不上局域网可能有设备隔离或电脑防火墙拦截在电脑上telnet 板子IP 5900测试端口通不通遇到问题不要慌先看日志。x11vnc的日志信息非常丰富默认会打印出每一步操作和错误原因。我把日志路径统一放到/var/log/x11vnc.log每次出问题第一件事就是sudo tail -50 /var/log/x11vnc.log80%的问题在日志里都有直接线索。5.2 黑屏、断线、Wayland冲突等典型问题深挖第一个想展开说的是黑屏问题。前期配置x11vnc时遇到黑屏十有八九是Xauthority的问题。X11的安全机制要求访问X display必须有对应的授权文件。x11vnc用-auth guess自动查找但某些系统上猜不到正确位置。这时候可以手动指定x11vnc -display :0 -auth /run/user/1000/.Xauthority注意不同系统的路径不完全一样用find / -name .Xauthority 2/dev/null搜一下最稳妥。我自己遇到过一种比较怪的情况明明Xauthority路径正确但x11vnc还是黑屏。查了很久才发现是User配错了systemd服务里用的是root而X会话是普通用户启动的。root进程去读普通用户的X authority就算路径对也会被SELinux或者AppArmor拦下来。改成User你的用户名之后再启动问题立刻消失。第二个常见问题是断线后重新连接失败。如果你没有加-forever参数x11vnc在第一个客户端断开后就会退出。但有些时候加了-forever依然连不上检查一下是不是还有残留进程占着端口ss -tlnp | grep 5900如果有个僵死进程占着5900把它杀掉再重启服务就好。第三个是Wayland冲突问题。前面提过x11vnc只认X11。如果你板子刷的镜像默认用Wayland比如较新的Ubuntu桌面版会默认切到Wayland那这个过程会是另一个局面。我的一个朋友在RK3588上刷了某发行版的新版镜像聚会时问我为什么vnc连不上我远程看了下发现整个会话是Wayland的后来让他换装了Xorg会话才解决。RK3588的Ubuntu桌面切换Xorg的方式一般是编辑/etc/gdm3/custom.conf把WaylandEnablefalse取消注释并重启GDM。但不同桌面管理器配置位置不太一样搜一下自己的桌面管理器 disable wayland基本都能找到。还有一个冷门但很重要的坑如果你在RK3588上跑的是Ubuntu镜像而且系统里同时装了gdm3和lightdm会导致X服务启动异常混乱。我自己遇到过开机后X起不来查了半天发现是lightdm和gdm3在争抢显示管理器。直接用startx手动启动X是不行的因为搞不清谁是权威。最后卸掉一个只保留gdm3世界才清净。5.3 输入体验优化的小技巧远程桌面光能看还不行鼠标键盘操作必须跟手。x11vnc默认的输入体验在局域网内已经很接近本地了但有几个细节能进一步优化体验。第一个是鼠标加速度问题。VNC连接后远程鼠标的灵敏度往往比本地高很多。可以在客户端里关掉鼠标加速度或者在板子的系统设置里把鼠标加速调整到舒适档位。这个纯看个人习惯有需要就调。第二个是键盘布局问题。远程桌面连接后如果本地键盘是美式布局板子系统默认是德语或其他布局输密码时就会发现符号对不上特别折腾。解决方法是提前在板子的桌面设置里把键盘布局改成和客户端一致的布局或者改x11vnc启动参数让x11vnc尝试保持客户端传来的键盘状态。后者配置起来略麻烦我一般直接改板子的键盘布局一劳永逸。第三个是触摸屏支持。RK3588的板子很多会接触摸屏如果你要用远程桌面调试触摸程序x11vnc默认会把鼠标点击转换成触摸事件但多点触控手势是传不过去的。这个限制目前VNC协议无解只能忍或者远程调试时用鼠标模拟单点操作。结语最后一点实用建议我在实际配置过程中最大的体会是远程桌面的“真同步”不只是画面同步还包含会话同步和输入同步。x11vnc能把这三者都做到是因为它完全基于现有的X11会话工作不搞虚拟显示器、不创建新会话所以RK3588上跑的什么你远程看到的就是什么。最后再分享一个小技巧RK3588板子如果在没有显示器的情况下启动Xorg部分镜像会因为检测不到显示设备而自动降低分辨率或切换虚拟输出。遇到这种问题但又不想插一个假HDMI头的时候可以看看内核cmdline里有没有video参数可以设置比如videoHDMI-A-1:1920x108060强制指定Xorg的输出分辨率。这个参数不治本但对不少RK3588板卡是很有效的兜底方案。配置好x11vnc之后我至少不用再为“本地到底显示什么样”猜来猜去了。编译完一个界面程序远程连上去截图、录屏、操作直接一步到位。如果你也经常和RK3588的GUI调试打交道这套方案值得一试。