Warum kann ich die ZED X-Kamera im Headless-Modus nicht mit „ssh -X“ verwenden?

Last updated: August 13, 2026

Der Treiber für unsere ZED-X-Kameraserie (ZED X, ZED X Mini, ZED X One GS, ZED X One 4K) basiert auf der NVIDIA Argus API, die für optimale Leistung EGLStream verwendet. Sie ist jedoch mit der X11-Weiterleitung (ssh -X) im Headless-Modus (kein angeschlossenes Display) nicht kompatibel.

Hinweis: Diese Support-Seite gilt für alle Remote-Desktop-Methoden, bei denen ein virtuelles Display eingerichtet werden muss, wie Remmina, VNC, NoMachine, RustDesk, TeamViewer, xrdp und andere.

Erklärung

Wenn kein Display angeschlossen ist, erstellt die Argus API einen NULL-EGL-Kontext, sodass EGLStream nahtlos funktioniert.
Bei Verwendung von ssh -X erkennt EGLStream den Bildschirm des Remote-Desktops und versucht, dafür einen EGL-Kontext zu erstellen. Da die meisten Desktop-PCs EGL jedoch nicht unterstützen (diese Funktion ist auf eingebettete Geräte beschränkt), führt dies zu einem ungültigen Kontext und verhindert die Initialisierung des ZED-X-Treibers.

LÖSUNGEN

Hardware

Um dieses Problem zu beheben, können Sie einen Dummy-Display-Stecker (HDMI oder DisplayPort) an Ihr Jetson-Gerät anschließen. Mit einem Dummy-Stecker kann EGLStream so ausgeführt werden, als wäre ein echtes Display an den Jetson angeschlossen, wodurch ein gültiger Kontext erstellt werden kann und der ZED-X-Treiber ordnungsgemäß funktioniert.

Hinweis: Wenn es sich bei dem Remote-Computer um ein anderes Jetson-Gerät handelt, sind Dummy-Stecker in der Regel nicht erforderlich, da ein gültiger EGLContext eingerichtet werden kann, weil das Gerät EGL unterstützt.

Software

Wir stellen eine Schritt-für-Schritt-Anleitung und ein einsatzbereites Skript bereit, mit denen Sie die physische Display-Ausgabe deaktivieren und stattdessen ein softwarebasiertes virtuelles Display aktivieren können.

Mit dieser Einrichtung können Sie über SSH oder eine virtuelle Desktop-Anwendung eine Verbindung zu einem entfernten NVIDIA®-Jetson-Gerät herstellen, ohne einen Dummy-Display-Stecker zu benötigen.

Hinweis: X11-Weiterleitung wird nicht unterstützt.

Den vollständigen Leitfaden finden Sie im ZED SDK-Abschnitt der Stereolabs-Dokumentation.

Warnung

Hinweis: Dieser Leitfaden gilt nicht für die ZED SDK Tools (d. h. ZED Explorer, ZED Depth Viewer, ZEDfu, ZED Sensor Viewer), da sie weiterhin inkompatibel mit ssh -X, sind, selbst bei Verwendung eines Dummy-Steckers oder der Softwarelösung.