Exibição Remota (noVNC)

O contêiner executa uma pilha de exibição virtual (Xvfb + x11vnc + noVNC + fluxbox) para que você possa observar agentes de IA controlando um navegador e intervir quando necessário — por exemplo, para lidar com prompts de login ou MFA.

Conectando

1. Abra http://localhost:6080/vnc.html no seu navegador e clique em Connect
2. Você verá um desktop leve do fluxbox — esta é a tela virtual do contêiner

Agentes de IA usando @playwright/mcp em modo visível renderizam o Chromium nesta tela. Você pode clicar e digitar diretamente na janela do noVNC para intervir a qualquer momento — sem necessidade de pausar/retomar.

Inicialização Manual do Navegador

Para abrir um navegador manualmente dentro do contêiner:

chromium --no-sandbox &

Para executar testes do Playwright em modo visível:

npx playwright test --headed

Variáveis de Ambiente

Variável	Padrão	Descrição
ENABLE_VNC	true	Defina como false para desabilitar a pilha VNC
VNC_RESOLUTION	1280x1024x24	Resolução da tela virtual (LxAxProfundidade)
DISPLAY	:99	Número do display X11
NOVNC_HOST_PORT	6080	Porta do host para o noVNC (altere para evitar conflitos com outros contêineres)

Defina estas variáveis no seu arquivo .env ou em .devcontainer/devcontainer.json sob containerEnv.

Desabilitando a Pilha VNC

Para operação somente em modo headless, defina ENABLE_VNC=false no .env e reinicie o contêiner:

Docker

docker compose down
docker compose up -d

Podman

podman-compose down
podman-compose up -d

Solução de Problemas

Consulte Solução de Problemas — Exibição Remota para soluções de tela preta, erros de conexão recusada e conflitos de porta.