Salta ai contenuti

Display remoto (noVNC)

Il container esegue uno stack di display virtuale (Xvfb + x11vnc + noVNC + fluxbox) che permette di osservare gli agenti AI controllare un browser e intervenire quando necessario — ad esempio, per gestire prompt di login o MFA.

  1. Apri http://localhost:6080/vnc.html nel tuo browser e fai clic su Connect
  2. Vedrai un desktop fluxbox leggero — questo è il display virtuale del container

Gli agenti AI che utilizzano @playwright/mcp in modalità headed renderizzano Chromium su questo display. Puoi cliccare e digitare direttamente nella finestra noVNC per intervenire in qualsiasi momento — non è necessario mettere in pausa o riprendere.

Per aprire un browser manualmente all’interno del container:

Terminal window
chromium --no-sandbox &

Per eseguire i test Playwright in modalità headed:

Terminal window
npx playwright test --headed
VariabilePredefinitoDescrizione
ENABLE_VNCtrueImposta su false per disabilitare lo stack VNC
VNC_RESOLUTION1280x1024x24Risoluzione del display virtuale (LxAxProfondità)
DISPLAY:99Numero display X11
NOVNC_HOST_PORT6080Porta lato host per noVNC (modifica per evitare conflitti con altri container)

Imposta queste variabili nel tuo file .env o in .devcontainer/devcontainer.json sotto containerEnv.

Per il funzionamento solo in modalità headless, imposta ENABLE_VNC=false in .env e riavvia il container:

Terminal window
docker compose down
docker compose up -d

Consulta Risoluzione dei problemi — Display remoto per soluzioni a schermate nere, errori di connessione rifiutata e conflitti di porte.