Remote-Display (noVNC)

Der Container führt einen virtuellen Display-Stack (Xvfb + x11vnc + noVNC + fluxbox) aus, sodass Sie KI-Agenten bei der Browsersteuerung beobachten und bei Bedarf eingreifen können — beispielsweise bei Login- oder MFA-Eingabeaufforderungen.

Verbindung herstellen

1. Öffnen Sie http://localhost:6080/vnc.html in Ihrem Browser und klicken Sie auf Connect
2. Sie sehen einen leichtgewichtigen fluxbox-Desktop — dies ist das virtuelle Display des Containers

KI-Agenten, die @playwright/mcp im sichtbaren Modus verwenden, rendern Chromium auf diesem Display. Sie können jederzeit im noVNC-Fenster klicken und tippen, um einzugreifen — kein Pausieren/Fortsetzen erforderlich.

Manueller Browser-Start

Um einen Browser manuell innerhalb des Containers zu öffnen:

chromium --no-sandbox &

Um Playwright-Tests im sichtbaren Modus auszuführen:

npx playwright test --headed

Umgebungsvariablen

Variable	Standard	Beschreibung
ENABLE_VNC	true	Auf false setzen, um den VNC-Stack zu deaktivieren
VNC_RESOLUTION	1280x1024x24	Auflösung des virtuellen Displays (BxHxFarbtiefe)
DISPLAY	:99	X11-Display-Nummer
NOVNC_HOST_PORT	6080	Host-seitiger Port für noVNC (ändern, um Konflikte mit anderen Containern zu vermeiden)

Setzen Sie diese in Ihrer .env-Datei oder in .devcontainer/devcontainer.json unter containerEnv.

VNC-Stack deaktivieren

Für den reinen Headless-Betrieb setzen Sie ENABLE_VNC=false in .env und starten den Container neu:

Docker

docker compose down
docker compose up -d

Podman

podman-compose down
podman-compose up -d

Fehlerbehebung

Siehe Fehlerbehebung — Remote-Display für Lösungen bei schwarzen Bildschirmen, Verbindungsablehnungsfehlern und Port-Konflikten.