헤드리스 모드에서 "ssh -X"로 ZED X 카메라를 사용할 수 없는 이유는 무엇인가요?
Last updated: August 13, 2026
ZED X 카메라 제품군(ZED X, ZED X 미니, ZED X One GS, ZED X One 4K)의 드라이버는 최적의 성능을 위해 NVIDIA Argus API에 의존하며, 이 API는 EGLStream을 사용합니다. 그러나 헤드리스 모드(연결된 디스플레이가 없는 상태)에서는 X11 포워딩(ssh -X)과 호환되지 않습니다.
참고: 이 지원 페이지는 Remmina, VNC, NoMachine, RustDesk, TeamViewer, xrdp 및 기타 방법과 같이 가상 디스플레이 설정이 필요한 모든 원격 데스크톱 방법에 적용됩니다.
설명
ssh -X를 사용하는 경우 EGLStream은 원격 데스크톱의 화면을 감지하고 해당 화면을 위한 EGL 컨텍스트를 생성하려고 합니다. 그러나 대부분의 데스크톱 PC는 EGL을 지원하지 않으며(EGL은 임베디드 장치 전용임), 이로 인해 잘못된 컨텍스트가 생성되어 ZED X 드라이버가 초기화되지 않습니다.솔루션
하드웨어
이 문제를 해결하려면 Jetson 장치에 더미 디스플레이 플러그(HDMI 또는 DisplayPort)를 연결할 수 있습니다. 더미 플러그를 사용하면 EGLStream이 실제 디스플레이가 Jetson에 연결된 것처럼 실행될 수 있으므로 유효한 컨텍스트를 생성하고 ZED X 드라이버가 정상적으로 작동할 수 있습니다.

참고: 원격 컴퓨터가 다른 Jetson 장치인 경우 EGL을 지원하므로 유효한 EGLContext를 설정할 수 있어 일반적으로 더미 플러그가 필요하지 않습니다.
소프트웨어
물리적 디스플레이 출력을 비활성화하고 대신 소프트웨어 기반 가상 디스플레이를 활성화할 수 있는 단계별 가이드와 바로 사용할 수 있는 스크립트를 제공합니다.
이 설정을 사용하면 더미 디스플레이 플러그 없이 SSH 또는 가상 데스크톱 애플리케이션을 통해 원격 NVIDIA® Jetson 장치에 연결할 수 있습니다.
참고: X11 포워딩은 지원되지 않습니다.
전체 가이드는 Stereolabs 문서의 ZED SDK 섹션에서 확인할 수 있습니다.
경고
참고: 이 가이드는 ZED SDK 도구(예: ZED Explorer, ZED Depth Viewer, ZEDfu, ZED Sensor Viewer)에는 적용되지 않습니다. 이러한 도구는 더미 플러그 또는 소프트웨어 솔루션을 사용하더라도 ssh -X, 와 호환되지 않기 때문입니다.