跳转到内容
开发容器

远程显示 (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 “故障排除”

请参阅故障排除 — 远程显示，了解黑屏、连接被拒绝错误和端口冲突的解决方案。