playwright

sbx/playwright Docker 镜像

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应用调试等操作,所有运行均以无头模式在沙箱内部执行,不会影响宿主机环境。

核心功能

  1. 预置完整Playwright v1.61.1运行环境,构建阶段即完成npm包和浏览器二进制安装,沙箱创建时无需额外下载资源
  2. 全局配置环境变量,实现零配置运行Playwright相关命令,无需额外安装依赖
  3. 沙箱隔离运行,所有浏览器操作均在沙箱内部完成,运行结束后所有资源随沙箱销毁,不会污染宿主机环境
  4. 适配Debian系基础镜像,自动安装Chromium运行所需的系统依赖库
  5. 开放浏览器二进制目录权限,支持运行时按需拉取其他版本的浏览器内核

使用场景

  • AI智能体自动编写执行Web端端到端测试用例
  • 沙箱内部署Web服务的自动化功能验证
  • 本地网页截图、PDF导出、页面内容抓取
  • Web应用自动化调试与问题复现
  • CI/CD流水线内的无头浏览器自动化测试

配置说明

前置要求

  1. 基础镜像需预装Node.js 18及以上版本,官方标准智能体模板均已内置该环境
  2. 需使用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仓库直接加载套件运行

console
sbx run --kit "git+https://github.com/docker/sbx-kits-contrib.git#dir=playwright" claude

3. 使用本地仓库克隆的套件运行

console
sbx run claude --kit ./playwright/ .

沙箱内常用操作命令

console
# 查看Playwright版本
playwright --version

# 运行项目测试套件
npx playwright test

# 对本地服务页面截图
npx playwright screenshot http://localhost:3000 page.png

代码调用示例

js
const { 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();

注意事项

  1. 该镜像仅预装Chromium内核,Firefox、WebKit内核可通过npx playwright install firefox webkit命令在运行时按需拉取,但对应的系统依赖库不会自动安装
  2. 沙箱无显示服务器,不支持headed模式、UI调试模式和代码生成功能,所有操作均为无头模式执行
  3. 沙箱默认 outbound 网络做了最小化限制,仅允许依赖的Ubuntu镜像源、Playwright官方CDN等域名访问,如需访问其他外部站点需额外配置沙箱网络策略
  4. 所有沙箱内生成的资源随沙箱删除自动清理,不会在宿主机留存任何浏览器缓存、截图文件等数据

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。

轩辕镜像加速拉取命令点我查看更多 playwright 镜像标签

docker pull docker.xuanyuan.run/sbx/playwright:<标签>

DockerHub 原生拉取命令

docker pull sbx/playwright:<标签>
专业版 · 高速稳定拉取镜像
50GB 仅 ¥8/年
高速镜像下载在线技术支持专业版保障服务可用付费会员免广告