なぜヘッドレスモードで「ssh -X」を使用して ZED X カメラを使えないのですか?
Last updated: August 13, 2026
ZED Xカメラシリーズ(ZED X、ZED X Mini、ZED X One GS、ZED X One 4K)のドライバーは、最適なパフォーマンスを実現するためにNVIDIA Argus APIに依存しており、EGLStreamを使用します。ただし、ヘッドレスモード(ディスプレイが接続されていない状態)での X11転送(ssh -X)には対応していません。
注:このサポートページは、Remmina、VNC、NoMachine、RustDesk、TeamViewer、xrdpなど、仮想ディスプレイの設定が必要なすべてのリモートデスクトップ方式に適用されます。
説明
ssh -Xを使用すると、EGLStreamはリモートデスクトップの画面を検出し、その画面用のEGLコンテキストを作成しようとします。しかし、ほとんどのデスクトップPCはEGL(組み込みデバイス専用)をサポートしていないため、無効なコンテキストが作成され、ZED X Driverの初期化が妨げられます。ソリューション
ハードウェア
これを解決するには、Jetsonデバイスにダミーディスプレイプラグ(HDMIまたはDisplayPort)を接続します。ダミープラグを使用すると、Jetsonに実際のディスプレイが接続されているかのようにEGLStreamを実行できるため、有効なコンテキストを作成でき、ZED X Driverを正常に動作させることができます。

注: リモートマシンが別のJetsonデバイスである場合、EGLをサポートしているため有効なEGLContextを確立でき、通常はダミープラグは必要ありません。
ソフトウェア
物理ディスプレイ出力を無効にし、代わりにソフトウェアベースの仮想ディスプレイを有効にできる、ステップバイステップのガイドとすぐに使えるスクリプトを提供しています。
この設定により、ダミーディスプレイプラグを必要とせず、SSHまたは仮想デスクトップアプリケーションを介してリモートのNVIDIA® Jetsonデバイスに接続できます。
注: X11転送には対応していません。
完全なガイドは、ステレオラブスのドキュメントにあるZED SDKセクションでご覧いただけます。
警告
注: このガイドはZED SDKツール(つまり、ZED Explorer、 ZED Depth Viewer、ZEDfu、ZED Sensor Viewer)には適用されません。これらは、ダミープラグやソフトウェアソリューションを使用している場合でも、ssh -X、 との互換性がないためです。