最近在调一块 Jetson Orin NX核心工作是让它在机柜里不带显示器长期跑同时我拿笔记本随时连桌面看状态。网上关于“无头”模式的教程不少但很多都停留在 SSH 操作图形界面这块总踩坑插上电不接显示器桌面渲染不完整VNC 连上去要么黑屏要么只有 640x480。折腾了一圈最后是 HDMI 欺骗器 RealVNC 的组合帮我彻底解决了问题。这篇文章我会按实际操作的顺序把从硬件选购、系统环境确认、RealVNC Server 安装、HDMI 欺骗器配置到密钥环解锁的完整过程都写出来顺便把那些用了几周才会遇到的坑一并整理出来适合所有想把手头 Jetson Orin NX 部署成无人值守远程开发机的朋友参考。1. 方案与思路为什么是“HDMI欺骗器 RealVNC”1.1 解决无头设备的远程桌面问题Jetson Orin NX 这类开发板核心场景一般是边缘推理、机器人控制、多路视频处理。很多人拿到手第一件事是接显示器、鼠标、键盘然后在桌面环境里配环境。但当它要被部署到设备端、机柜或现场时桌面环境反而成了负担没地方放显示器或者根本没有显卡接口可接。这种情况下远程图形界面就变成刚需。但问题在于Jetson 的图形栈在检测不到显示器时行为会很不一样。Xorg 可能启动到默认低分辨率或者部分合成器根本不渲染桌面GNOME 壁纸都可能变成紫色。结果就是 VNC 连上去看到的是空白或者极低分辨率的桌面根本没有可操作性。这个时候很多人想到的第一个方案是用 VNC 服务端自带的“虚拟显示器”。RealVNC Server 的 Virtual Mode 确实可以创建虚拟显示但虚拟模式在授权和兼容性上有不少限制不是每台设备都能顺畅使用。硬件级 HDMI 欺骗器则是从最底层解决“没有显示器”这件事它内部有一颗 EDID 芯片插到 HDMI 口上后系统会以为有一台真实显示器连在上面于是按照显示器的时序和分辨率正常渲染桌面。这样 Xorg、GNOME 这些软件栈就全都认为“有屏幕”远程桌面自然也就正常了。RealVNC 负责把桌面图像压缩、传输到客户端两者各管一段组合起来非常干净。1.2 比一比RealVNC、XRDP、向日葵、NoMachine方案适用场景优点常见坑RealVNC Server跨平台远程控制、嵌入式 Linux客户端成熟支持 Service Mode配置灵活密钥环弹窗、授权逻辑稍麻烦XRDPWindows 远程到 LinuxWindows 自带客户端协议成熟Xorg 会话兼容性一般偶发画面撕裂向日葵国内网络环境友好穿透方便适合公网远程arm64 嵌入式设备支持有限NoMachine局域网高画质远程画质好、省带宽私有协议客户端不支持某些嵌入式架构选 RealVNC 的主要原因是它的跨平台客户端足够成熟CPU 占用相对可控而且支持 Service Mode 独立于用户会话运行配合 HDMI 欺骗器几乎没有“每次连接重新登录”的烦恼。NoMachine 性能也不错但客户端和协议偏私有向日葵在 Windows 上很顺手但在 Jetson 这种 ARM64 嵌入式板上的服务端支持不如 RealVNC 灵活。XRDP 走 RDP 协议Windows 自带客户端但对 Xorg 的扩展支持偶尔有撕裂感。实际用下来RealVNC 的体验是“少折腾”所以教程里我直接用这套方案。2. 硬件准备与系统环境确认2.1 需要的硬件与避坑提示先列一份清单Jetson Orin NX 模组或开发套件HDMI 欺骗器也叫 HDMI EDID 模拟器USB-C 电源稳定的网络连接。HDMI 欺骗器的选购要点是买之前先确认设备 HDMI 口支持什么规格。Jetson Orin NX 开发套件的 HDMI 接口一般支持 HDMI 2.0最大 4K60但如果你只是远程桌面用建议直接买 1080P 60Hz 的版本。原因有两个一是分辨率越高VNC 传输带宽和编码压力越大远程操作反而不流畅二是部分 4K 欺骗器在较老的 HDMI 线缆下会出现握手不稳定需要额外供电才能稳住。我手头这款欺骗器是免驱的即插即用带一个 EDID 存储器通电后系统就能读到固定分辨率。买的时候还要注意接口方向尽量选择带小尾巴的版本不然插在开发板上会被外壳挡住。如果是自行设计载板要额外确认载板上的 HDMI 桥接芯片是否被系统识别。如果xrandr根本看不到 HDMI 口大概率是驱动没加载或设备树没配置这个问题靠欺骗器解决不了得先回去查硬件。2.2 确认 Jetson 系统与显示驱动把板子接上电源、网线和 HDMI 欺骗器后先通过 HDMI 临时接一个显示器完成系统初始化或者直接用串口 / SSH 登录。检查系统版本和驱动状态cat /etc/nv_tegra_release uname -a nvidia-smiJetPack 5.x 对应 Ubuntu 20.04JetPack 6.x 对应 Ubuntu 22.04。RealVNC 的 deb 包对这两种系统都有兼容。特别提醒Jetson 的 Ubuntu 是 NVIDIA 定制内核部分桌面组件和原生 Ubuntu 有区别安装软件时如果遇到依赖冲突不要急着加第三方源先确认是不是 JetPack 里的版本锁定导致的。显示驱动方面只要nvidia-smi能正常输出版本和驱动号就说明 GPU 驱动没问题如果命令不存在需要先补装 JetPack 的 SDK 组件。2.3 基础网络与 SSH 配置在安装远程软件前先把 SSH 配好以免 VNC 出问题时还有保底通道。建议立刻修改默认密码启用密钥登录然后固定 IP避免重启后找不到板子。Jetson 默认用 NetworkManager固定 IP 可以用nmcli完成nmcli con mod Wired connection 1 ipv4.addresses 192.168.1.100/24 ipv4.gateway 192.168.1.1 ipv4.method manual nmcli con up Wired connection 1如果设备放在没有 DHCP 的裸环境这一步非常关键。固定好 IP 后用笔记本 SSH 连一次确认通后面所有远程操作都建立在网络层可用的基础上。3. 安装 RealVNC Server 并完成基本配置3.1 下载正确的 ARM64 DEB 包并安装RealVNC 官网提供 Linux 下的安装包Jetson Orin NX 是 ARM64 架构一定要下载VNC-Server-7.x.x-Linux-ARM64.deb不要下成 x64。下载后用scp传到板子scp VNC-Server-*.deb userjetson-ip:/tmp/然后在板子上安装cd /tmp sudo apt update sudo apt install ./VNC-Server-*.deb如果提示依赖错误先跑sudo apt --fix-broken install。安装完成后用dpkg -l | grep vnc确认版本避免后面排查问题时不知道软件版本。3.2 启动服务、开机自启与防火墙安装后系统会生成两个主要服务vncserver-x11-serviced.service和vncserver-virtuald.service。因为我们有 HDMI 欺骗器所以主要用 x11 服务它会把当前正在运行的桌面会话共享出去。先启动并设置开机自启sudo systemctl enable vncserver-x11-serviced.service sudo systemctl start vncserver-x11-serviced.service sudo systemctl status vncserver-x11-serviced.service然后放行 VNC 默认端口 5900sudo ufw allow 5900/tcp如果使用 RealVNC 云服务模式云端连接还会走 443 端口如果是局域网直连只开 5900 就够。JetPack 默认可能没有启用ufw但如果你之前手动开过千万别漏了这条规则。3.3 用 vncpasswd 设置服务密码并测试直连这一步直接关系到后面的密钥环问题。在命令行下执行sudo vncpasswd -service它会提示输入一个服务级密码这个密码会保存到系统配置中不依赖用户桌面会话的 GNOME 密钥环。这样一来后续用客户端连接时输入的是这个服务密码就绕开了“解锁密钥环”的弹窗。-service和普通用户的vncpasswd区别在于普通用户设置的密码是给某个用户会话用的而服务密码是给 VNC Server 服务进程做认证用的对无人值守设备更合适。设置完成后在局域网里用 VNC 客户端连接板子的 IP:5900如果能看到登录界面说明基本链路已经通。如果连不上先看端口是否监听sudo lsof -i :59004. 插入 HDMI 欺骗器让桌面“永远在线”4.1 HDMI 欺骗器的工作原理与选择要点HDMI 欺骗器本质上就是一个带 EDID 芯片的转接头。显示器通过 DDC 通道把 EDID 数据发给显卡告诉显卡自己支持什么分辨率、刷新率、色彩模式。真实显示器是这样欺骗器就模拟这个过程。Jetson 的图形驱动读到 EDID 后会认为自己接了一个真实显示器于是正常启动显示输出、渲染桌面。这对远程控制的好处是巨大的桌面环境不会因为“没有显示器”而主动降级。选购时最重要的参数就是分辨率。有的欺骗器标称支持 4K30有的只支持 1080P这些都没关系关键是和你的使用场景匹配。我自己用的是 1080P 60 的版本远程桌面操作流畅VNC 编码压力也小。如果是给 Jetson 配建议不要买带音频 EDID 的型号部分带音频的欺骗器在 Linux 下会多出一个 HDMI 音频设备虽然不影响使用但排查问题时多一个变量。4.2 用 xrandr 手动设置分辨率与刷新率插入欺骗器并进入桌面后终端里执行xrandr --query正常情况下会看到类似输出Screen 0: minimum 320 x 200, current 1920 x 1080, maximum 7680 x 4320 HDMI-0 connected 1920x108000 (normal left inverted right x axis y axis) 0mm x 0mm 1920x1080 60.00* 1280x720 59.94 1024x768 60.00如果系统没有默认选择 1920x1080可以手动指定xrandr --output HDMI-0 --mode 1920x1080 --rate 60如果你希望重启后仍然保持这个分辨率可以把命令写入 GNOME 的 autostart 目录。实测下来这种方式比直接改 xorg.conf 安全因为出了问题删掉 desktop 文件就能复原mkdir -p ~/.config/autostart cat ~/.config/autostart/set-resolution.desktop EOF [Desktop Entry] TypeApplication NameSet Resolution Execxrandr --output HDMI-0 --mode 1920x1080 --rate 60 X-GNOME-Autostart-enabledtrue EOF4.3 禁止锁屏和休眠远程桌面最怕连接后黑屏。桌面环境的电源管理默认可能会在闲置一段时间后关闭屏幕或进入锁屏这会导致 VNC 画面显示登录密码输入框或黑屏。对无人值守的设备建议把屏幕关闭、锁屏都关掉gsettings set org.gnome.desktop.session idle-delay 0 gsettings set org.gnome.desktop.screensaver lock-enabled false另外在 GNOME 设置里把“电源”中的“息屏”改成“从不”。如果使用的是 Wayland 会话部分 gsettings 键可能不生效所以这个方案更建议在 Xorg 会话下使用。Jetson 的 JetPack 默认登录会话一般还是 Xorg问题不大。5. 密钥环解锁让 VNC 在开机后自动就绪5.1 为什么会跳出“解锁密钥环”弹窗GNOME Keyring 是 Linux 桌面下常见的凭据存储服务RealVNC 的云服务模式会把账号 token 或密码放进密钥环。当 VNC 服务随系统启动时桌面会话可能还没有完成登录密钥环处于锁定状态服务尝试读取里面的数据就会触发解锁弹窗。这个弹窗只有在交互式桌面才会出现对于无人值守的设备来说它可能一直卡在那里导致 VNC 无法正常完成认证或者连接后只看到登录界面。这种现象看着像 VNC 的 bug其实是 GNOME Keyring 和自启动服务之间典型的时序冲突。解决办法有三个按操作成本从低到高排序。5.2 方法一设置空密码的默认密钥环这个方法适合有显示器、可以手动操作一次的场景。打开“密码和密钥”Seahorse找到“登录”密钥环右键修改密码原密码填当前登录用户密码新密码留空。这样以后解锁密钥环时不会再询问。如果找不到“登录”密钥环可以删掉~/.local/share/keyrings/login.keyring重启后系统会要求创建新密钥环同样把密码留空。这个方法需要在图形界面下操作但一劳永逸。需要注意空密码密钥环的安全性较低只适合内网可信环境如果设备暴露在公网不建议。5.3 方法二使用 vncpasswd -service 避免密钥环依赖这就是前面 3.3 节提到的做法。只要 VNC Server 使用服务级密码在连接时走的是 Service Password 认证RealVNC 就不再需要读取 GNOME Keyring弹窗自然消失。你可以在安装完成后直接设置服务密码而不必先登录 RealVNC 云账号。这样部署最干净适合大部分局域网直连场景。如果你确实需要 RealVNC 云服务的跨网络 ID 连接功能那就必须在服务端登录账号这时密钥环弹窗可能会回来。我的建议是优先用服务密码模式连接局域网跨网络时通过公司内网网关或 SSH 通道再跳到板子不要在公网直接暴露 5900 端口。5.4 方法三配置自动登录如果没有显示器又特别想用云服务模式可以考虑让系统自动登录到用户桌面再运行 RealVNC 服务。GNOME 设置中有“用户”-“自动登录”选项或者修改 GDM 配置。自动登录后密钥环会在用户会话创建后自动解锁弹窗问题减少。缺点是任何人重启板子都会直接进入桌面物理访问风险变大只适合放在封闭机柜等安全环境。修改 GDM 配置可以这样sudo sed -i s/#AutomaticLoginEnabletrue/AutomaticLoginEnabletrue/ /etc/gdm3/custom.conf sudo sed -i s/#AutomaticLoginuser1/AutomaticLogin你的用户名/ /etc/gdm3/custom.conf改完注意备份并重启 GDM 验证。我实际测试中的经验是自动登录 空密码密钥环一起配合VNC 的开机自启最顺畅基本不会卡在登录界面。6. 客户端接入与体验调优6.1 RealVNC Viewer 连接步骤在 Windows 或 Mac 上安装 RealVNC Viewer打开后输入板子的 IP 地址如果服务端口不是 5900就写成IP:5900。回车后输入之前设置的 VNC 密码连接成功后就能看到与本地桌面一致的 GNOME 桌面。第一次连接建议先用ping或telnet IP 5900测端口通不通避免 Viewer 端一直提示超时才去排查。在 Viewer 里可以把连接配置保存下来命名成 jetson-orin-nx下次一键连接。如果同一时间有多个管理员连接同一台板子RealVNC 会提示已有连接存在默认是抢占式连接后连的人会把前面的人踢掉。如果希望协作可以在服务端配置里打开多连接支持但会额外消耗系统资源。6.2 画质与流畅度调整在 Viewer 的连接属性里把画质设为“最佳速度”关闭“桌面壁纸”和“字体平滑”开关颜色深度降到 16 位能明显降低带宽占用。如果只是调试代码这种设置完全够用。如果需要操作 OpenGL 或 3D 程序建议保持原画质否则图像会糊看不出细节。VNC 本质是抓屏加编码不适合做高帧率远程游戏对 Jetson 上的 GUI 调试程序来说30fps 左右已经够用。如果发现鼠标位置和实际点击有偏移优先升级客户端版本一般是高 DPI 缩放导致的问题。6.3 无人值守断电重启后的完整启动顺序部署到现场后设备会被断电重启。我把自己的检查顺序列在这里第一HDMI 欺骗器是否在开机前就插好最好直接插在开发板 HDMI 口不要经过延长线第二系统启动后vncserver-x11-serviced.service是否自启第三自动登录是否生效桌面会话是否正常建立第四密钥环是否已设置空密码或使用服务密码第五VNC 端口是否在监听。如果每一步都正常从断电到远程可连接一般不超过两分钟。如果某一步失败先用 SSH 登进去看日志再逐一排查。把上面的流程做成一个启动脚本可以帮你在现场省掉大量时间。7. 常见问题与排查实录7.1 黑屏排查黑屏是 VNC 远程 Jetson 最常见的问题。原因大概率是桌面会话未建立。检查顺序是这样先确认欺骗器已被系统识别xrandr能看到HDMI-0 connected再确认服务是vncserver-x11-serviced.service而不是vncserver-virtuald.service然后确认板子上有用户会话在运行可以用who查看。如果远程看到的是 GDM 登录界面而不是桌面那就要考虑启用自动登录或者登录后手动启动 VNC 服务。我踩过的一次坑是板子用了新用户但旧用户仍留在系统里VNC 服务默认连到了旧会话结果那边是锁屏状态远程进来就黑屏。后来直接把旧用户删除并禁用无关交换用户的自动登录才解决。7.2 连接被拒绝或超时连接被拒绝先看端口和防火墙。如果 ufw 没放行 5900VNC 客户端会报无法访问。再看 RealVNC 服务是否在运行systemctl status查一下。有时候服务崩溃是因为用户目录权限不对检查~/.vnc和/etc/vnc下的配置文件确保 VNC 服务用户对相应目录有读权限。还有个容易忽略的坑RealVNC Server 默认绑定所有网口但如果板子上有多个网络接口可能绑定到另一个接口客户端访问的 IP 不对。用ss -tlnp | grep 5900看监听地址确认不是只监听在127.0.0.1。7.3 分辨率不受控制如果设置了 1920x1080但连接后只有 1024x768多半是桌面合成器在 VNC 会话启动时选了不同的分辨率。把 HDMI 欺骗器换成支持固定 EDID 的型号最直接或者通过 xrandr 在启动脚本里强制设置。还要注意 GNOME 会根据“显示器配置”自动记忆分辨率可以在设置里删除不需要的显示器配置让系统知道只有一个固定输出避免下次启动把分辨率又拉回默认。7.4 远程使用过程中的其他“小坑”有个常见问题是鼠标无法拖动窗口边缘这通常和 VNC 的按键映射有关把客户端键盘布局改成与板子一致再重新连接就正常了。还有一个是板子长时间高负载运行后桌面合成器偶尔会卡VNC 画面掉帧明显这时候用htop看看是不是有进程把 CPU 或 GPU 内存占满了优先排查应用层的异常。另外有人会问 Windows 上的 RealVNC 是不是只能装在 C 盘其实安装路径在安装向导里可以自定义跟 Jetson 服务端没有关系但容易混淆。最后再分享一个我一直在用的习惯每次修改 VNC 或显示相关配置前先用cp备份原配置文件并写好回滚命令。因为无人值守设备一旦远程断开现场恢复的成本很高。HDMI 欺骗器加 RealVNC 这套组合只要能度过最初的调试期后面运行起来真的稳定板子在机柜里跑几个月都不用碰一次显示器。希望这篇文章能帮你少踩几个坑把远程桌面这件事真正纳入到你的 Jetson 部署流程里。