为什么我无法在无头模式下通过“ssh -X”使用 ZED X 相机?
Last updated: October 23, 2026
我们的 GMSL2 相机(ZED X、 ZED X Mini、 ZED X Nano、 ZED X One GS、 ZED X One S和 ZED X One 4K)的驱动程序依赖于 NVIDIA Argus API,该 API 使用 EGLStream 以实现最佳表现。但是,在无头模式(未连接显示器)下,它与 X11 转发 (ssh -X)不兼容。
注意: 本文也适用于所有需要设置虚拟显示器的远程桌面方法,例如 Remmina、VNC、NoMachine、RustDesk、TeamViewer、xrdp 等。
说明
未连接显示器时,Argus API 会创建一个 NULL EGL 上下文,使 EGLStream 能够无缝运行。
使用 ssh -X时,EGLStream 会检测远程桌面的屏幕,并尝试为其创建 EGL 上下文。但是,由于大多数台式电脑不支持在此配置下使用 EGL,结果会产生一个无效上下文,从而阻止 ZED X 驱动程序初始化。
解决方案
硬件
连接一个 虚拟显示器插头 (HDMI 或 DisplayPort)到您的 NVIDIA® Jetson™ 设备。使用虚拟插头后,EGLStream 会像真实显示器已连接到 Jetson 一样运行,因此可以创建有效的上下文,ZED X 驱动程序也能正常工作。

注意: 如果远程计算机是另一台 Jetson 设备,通常不需要虚拟插头,因为可以建立有效的 EGL 上下文。
软件
我们提供了分步指南和一个可直接使用的脚本,用于禁用物理显示输出,并改为启用基于软件的虚拟显示器。完成此设置后,您无需使用虚拟显示器插头,即可通过 SSH 或虚拟桌面应用程序连接到远程 NVIDIA® Jetson™ 设备。
注意: 不支持 X11 转发。
完整指南请参阅 虚拟显示器(无头模式) 文档。
警告
这些解决方案不适用于 ZED SDK 工具(ZED Explorer、ZED Depth Viewer、ZEDfu、ZED Sensor Viewer),即使使用虚拟插头或软件解决方案,这些工具仍与 ssh -X不兼容。