Por que não consigo usar a câmera ZED X com "ssh -X" no modo sem interface gráfica?
Last updated: October 23, 2026
O driver de nossas câmeras GMSL2 (ZED X, ZED X Mini, ZED X Nano, ZED X One GS, ZED X One S, e ZED X One 4K) depende da NVIDIA Argus API, que usa EGLStream para obter o desempenho ideal. No entanto, ela é incompatível com o encaminhamento X11 (ssh -X) no modo headless (sem uma tela conectada).
Observação: este artigo também se aplica a todos os métodos de área de trabalho remota que exigem a configuração de uma tela virtual, como Remmina, VNC, NoMachine, RustDesk, TeamViewer, xrdp e outros.
Explicação
Quando nenhuma tela está conectada, a API Argus cria um contexto EGL NULL, permitindo que o EGLStream opere perfeitamente.
Ao usar ssh -X, o EGLStream detecta a tela da área de trabalho remota e tenta criar um contexto EGL para ela. No entanto, como a maioria dos PCs de mesa não oferece suporte a EGL nessa configuração, o resultado é um contexto inválido que impede a inicialização do driver ZED X.
Soluções
Hardware
Conecte um adaptador de tela fictício (HDMI ou DisplayPort) ao seu dispositivo® Jetson™ NVIDIA. Com um adaptador fictício, o EGLStream funciona como se uma tela real estivesse conectada ao Jetson, permitindo criar um contexto válido para que o driver ZED X funcione corretamente.

Observação: se a máquina remota for outro dispositivo Jetson, geralmente não é necessário usar um adaptador fictício, pois é possível estabelecer um contexto EGL válido.
Software
Fornecemos um guia passo a passo e um script pronto para uso para desabilitar a saída física de vídeo e habilitar uma tela virtual baseada em software. Com essa configuração, você pode se conectar a um dispositivo® Jetson™ NVIDIA remoto via SSH ou por meio de um aplicativo de área de trabalho virtual, sem um adaptador de tela fictício.
Observação: o encaminhamento X11 não é compatível.
Você encontra o guia completo na documentação Tela virtual (modo headless) .
Aviso
Essas soluções não se aplicam às ferramentas do ZED SDK (ZED Explorer, ZED Depth Viewer, ZEDfu, ZED Sensor Viewer), que continuam incompatíveis com ssh -X, mesmo ao usar um adaptador fictício ou a solução de software.