dockerclovertech/puppeteer

Puppeteer 22.0.0 官方镜像

概述

此镜像为 ghcr.io/puppeteer/puppeteer:22.0.0 的官方副本，基于 Node.js 环境构建，预装 Chromium 浏览器，用于实现浏览器自动化、网页截图、端到端测试等场景。Puppeteer 是 Google 开发的 Node.js 库，通过 DevTools 协议控制 Chromium/Chrome，支持页面导航、表单提交、网络请求拦截等功能。

特性

• 预装 Chromium：无需额外下载，镜像内置与 Puppeteer 22.0.0 兼容的 Chromium 版本
• Node.js 环境：基于官方 Node.js 镜像，提供稳定的 JavaScript 运行时
• 版本匹配：Puppeteer 版本固定为 22.0.0，确保 API 兼容性
• 优化配置：默认启用无头模式（headless），优化浏览器启动参数以减少资源占用

使用方法

基本用法

运行挂载本地脚本的容器，执行浏览器自动化任务。以下示例展示如何使用镜像运行一个简单的网页截图脚本。

1. 创建本地脚本（script.js）

javascript
const puppeteer = require('puppeteer');

(async () => {
  const browser = await puppeteer.launch();
  const page = await browser.newPage();
  await page.goto('https://example.com');
  await page.screenshot({ path: '/app/example.png' });
  await browser.close();
})();

2. 运行容器

将当前目录挂载到容器内的 /app 目录，执行脚本：

bash
docker run -v $(pwd):/app ghcr.io/puppeteer/puppeteer:22.0.0 node /app/script.js

执行后，当前目录将生成 example.png 截图文件。

环境变量

• PUPPETEER_EXECUTABLE_PATH：指定 Chromium 可执行文件路径（默认已配置为镜像内置路径 /usr/bin/chromium-browser）
• NODE_ENV：Node.js 环境变量，默认 production

注意事项

• 资源需求：浏览器运行需至少 512MB 内存，建议分配 1GB 以上以避免卡顿
• 文件权限：挂载本地目录时，确保容器内用户（默认 root）对挂载路径有读写权限
• 网络访问：若脚本需访问外部网络，确保容器网络配置正确（默认使用 bridge 网络）