Affichage à distance (noVNC)

Le conteneur exécute une pile d’affichage virtuel (Xvfb + x11vnc + noVNC + fluxbox) afin que vous puissiez observer les agents IA contrôler un navigateur et intervenir si nécessaire — par exemple, pour gérer les invites de connexion ou d’authentification multifacteur (MFA).

Connexion

1. Ouvrez http://localhost:6080/vnc.html dans votre navigateur et cliquez sur Connect
2. Vous verrez un bureau fluxbox léger — il s’agit de l’affichage virtuel du conteneur

Les agents IA utilisant @playwright/mcp en mode graphique affichent Chromium sur cet écran. Vous pouvez cliquer et saisir du texte directement dans la fenêtre noVNC pour intervenir à tout moment — aucune pause/reprise n’est nécessaire.

Lancement manuel du navigateur

Pour ouvrir un navigateur manuellement dans le conteneur :

chromium --no-sandbox &

Pour exécuter les tests Playwright en mode graphique :

npx playwright test --headed

Variables d’environnement

Variable	Valeur par défaut	Description
ENABLE_VNC	true	Définir à false pour désactiver la pile VNC
VNC_RESOLUTION	1280x1024x24	Résolution de l’affichage virtuel (LxHxProfondeur)
DISPLAY	:99	Numéro d’affichage X11
NOVNC_HOST_PORT	6080	Port côté hôte pour noVNC (modifier pour éviter les conflits avec d’autres conteneurs)

Définissez-les dans votre fichier .env ou dans .devcontainer/devcontainer.json sous containerEnv.

Désactivation de la pile VNC

Pour un fonctionnement uniquement en mode headless, définissez ENABLE_VNC=false dans .env et redémarrez le conteneur :

Docker

docker compose down
docker compose up -d

Podman

podman-compose down
podman-compose up -d

Dépannage

Consultez Dépannage — Affichage à distance pour des solutions aux écrans noirs, aux erreurs de connexion refusée et aux conflits de ports.