sbx/playwright是沙箱环境专用的Playwright浏览器自动化工具套件,预集成指定版本的playwright CLI、测试框架和Chromium浏览器,支持浏览器自动化测试、网页抓取、截图、PDF生成等操作。
下载次数: 0状态:社区镜像维护者:sbx仓库类型:镜像最近更新:
镜像概述
sbx/playwright是基于实验性Sandbox Kit v3规范构建的沙箱混合套件镜像,将指定版本的Playwright浏览器自动化工具链预装到沙箱环境中,包含v1.61.1版本的playwright CLI、@playwright/test测试框架,以及Chromium无头浏览器和所有依赖的系统库。可搭配各类大模型智能体使用,在沙箱本地环境中完成端到端测试编写运行、网页抓取、页面截图、PDF生成、Web应用调试等操作,所有运行均以无头模式在沙箱内部执行,不会影响宿主机环境。
核心功能
- 预置完整Playwright v1.61.1运行环境,构建阶段即完成npm包和浏览器二进制安装,沙箱创建时无需额外下载资源
- 全局配置环境变量,实现零配置运行Playwright相关命令,无需额外安装依赖
- 沙箱隔离运行,所有浏览器操作均在沙箱内部完成,运行结束后所有资源随沙箱销毁,不会污染宿主机环境
- 适配Debian系基础镜像,自动安装Chromium运行所需的系统依赖库
- 开放浏览器二进制目录权限,支持运行时按需拉取其他版本的浏览器内核
使用场景
- AI智能体自动编写执行Web端端到端测试用例
- 沙箱内部署Web服务的自动化功能验证
- 本地网页截图、PDF导出、页面内容抓取
- Web应用自动化调试与问题复现
- CI/CD流水线内的无头浏览器自动化测试
配置说明
前置要求
- 基础镜像需预装Node.js 18及以上版本,官方标准智能体模板均已内置该环境
- 需使用Debian家族的操作系统作为基础镜像,以支持通过apt安装Chromium所需系统依赖
环境变量说明
| 环境变量 | 作用 |
|---|---|
| PLAYWRIGHT_BROWSERS_PATH | 固定为/opt/ms-playwright,指定全局浏览器二进制存储路径,规避root安装后普通用户无法访问的问题 |
| NODE_PATH | 包含npm全局包路径/usr/local/share/npm-global/lib/node_modules,解决无项目本地依赖时测试文件无法导入Playwright模块的问题 |
部署使用示例
1. 直接通过sbx命令搭配智能体运行
console# 搭配Claude智能体使用本地镜像运行当前目录项目 sbx run claude --kit "docker.io/sbx/playwright:latest" .
2. 从远程Git仓库直接加载套件运行
consolesbx run --kit "git+https://github.com/docker/sbx-kits-contrib.git#dir=playwright" claude
3. 使用本地仓库克隆的套件运行
consolesbx run claude --kit ./playwright/ .
沙箱内常用操作命令
console# 查看Playwright版本 playwright --version # 运行项目测试套件 npx playwright test # 对本地服务页面截图 npx playwright screenshot http://localhost:3000 page.png
代码调用示例
jsconst { chromium } = require('playwright'); // 启动无头Chromium实例 const browser = await chromium.launch(); const page = await browser.newPage(); await page.goto('http://localhost:3000'); await page.screenshot({ path: 'example.png' }); await browser.close();
注意事项
- 该镜像仅预装Chromium内核,Firefox、WebKit内核可通过
npx playwright install firefox webkit命令在运行时按需拉取,但对应的系统依赖库不会自动安装 - 沙箱无显示服务器,不支持headed模式、UI调试模式和代码生成功能,所有操作均为无头模式执行
- 沙箱默认 outbound 网络做了最小化限制,仅允许依赖的Ubuntu镜像源、Playwright官方CDN等域名访问,如需访问其他外部站点需额外配置沙箱网络策略
- 所有沙箱内生成的资源随沙箱删除自动清理,不会在宿主机留存任何浏览器缓存、截图文件等数据
sbx 命名空间的其他可用镜像:
sbx/opencode
Opencode 容器镜像,适合 sbx 维护的 Opencode 工作负载部署
sbx/hermes-agent-image
Hermes Agent Image 容器镜像,适合 sbx 维护的 Hermes Agent Image 工作负载部署
sbx/pi-image
Pi Image 容器镜像,适合 sbx 维护的 Pi Image 工作负载部署
sbx/shell
Shell 容器镜像,适合 sbx 维护的 Shell 工作负载部署
sbx/claude
Claude 容器镜像,适合 sbx 维护的 Claude 工作负载部署
sbx/claude-ollama
Claude Ollama 容器镜像,适合 sbx 维护的 Claude Ollama 工作负载部署
更多相关 Docker 镜像与资源
以下是 sbx/playwright 相关的常用 Docker 镜像,适用于 不同场景 等不同场景:
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull sbx/playwright:<标签>
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务