跳到內容
開發容器

遠端顯示 (noVNC)

容器會執行虛擬顯示堆疊（Xvfb + x11vnc + noVNC + fluxbox），讓您可以觀看 AI 代理控制瀏覽器，並在需要時進行介入——例如，處理登入或多因素驗證提示。

連線

Section titled “連線”
  1. 在瀏覽器中開啟 http://localhost:6080/vnc.html 並點擊 Connect
  2. 您將看到一個輕量級的 fluxbox 桌面——這是容器的虛擬顯示器

使用 @playwright/mcp 有介面模式的 AI 代理會將 Chromium 渲染到此顯示器中。您可以隨時在 noVNC 視窗中直接點擊和輸入來進行介入——無需暫停/恢復。

手動啟動瀏覽器

Section titled “手動啟動瀏覽器”

要在容器內手動開啟瀏覽器：

Terminal window
chromium --no-sandbox &

要以有介面模式執行 Playwright 測試：

Terminal window
npx playwright test --headed

環境變數

Section titled “環境變數”
變數預設值說明
ENABLE_VNCtrue設為 false 可停用 VNC 堆疊
VNC_RESOLUTION1280x1024x24虛擬顯示器解析度（寬x高x色深）
DISPLAY:99X11 顯示器編號
NOVNC_HOST_PORT6080noVNC 的主機端連接埠（可覆寫以避免與其他容器衝突）

在您的 .env 檔案中或在 .devcontainer/devcontainer.json 的 containerEnv 下設定這些變數。

停用 VNC 堆疊

Section titled “停用 VNC 堆疊”

若僅需無介面操作，請在 .env 中設定 ENABLE_VNC=false 並重新啟動容器：

Terminal window
docker compose down
docker compose up -d

疑難排解

Section titled “疑難排解”

請參閱疑難排解 — 遠端顯示以取得黑畫面、連線被拒絕錯誤和連接埠衝突的解決方案。