fuww/puppeteer

Docker + Puppeteer 镜像文档

镜像概述

该镜像集成了Puppeteer（一个Node.js库）及所需的Chrome/Chromium浏览器环境，提供无需本地安装浏览器即可控制浏览器的能力。Puppeteer通过高级API实现对浏览器的全控制，适用于各类浏览器自动化场景。

核心功能与特性

• 预配置环境：已包含Puppeteer及依赖的Chrome/Chromium浏览器，无需额外安装
• 无头模式支持：默认支持无头浏览器运行，适合服务器环境或无界面场景
• 完整API支持：提供页面导航、表单提交、元素操作、截图、PDF生成等完整浏览器控制能力
• 环境隔离：容器化运行避免本地浏览器版本冲突及环境依赖问题

使用场景

• 网页数据抓取：自动化提取网页内容、动态加载数据
• 前端自动化测试：模拟用户交互（点击、输入等），验证页面渲染及功能
• 文档生成：将网页转换为PDF或截图保存
• 自动化表单处理：批量提交表单、处理登录流程等重复性任务

使用方法

基本运行

通过以下命令启动容器并进入交互式终端：

sh
docker run -it fuww/puppeteer

运行Puppeteer脚本

在容器内可直接编写并执行Puppeteer脚本。示例：创建截图脚本screenshot.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: 'example.png', fullPage: true });
  // 关闭浏览器
  await browser.close();
  console.log('截图已保存');
})();

执行脚本：

sh
node screenshot.js

挂载本地目录（文件持久化）

如需将容器内生成的文件（如截图、PDF）保存到本地，可通过-v参数挂载本地目录：

sh
# 将当前目录挂载到容器内的/app目录
docker run -it -v $(pwd):/app fuww/puppeteer

在容器内将文件保存到/app目录，即可在本地当前目录查看结果。

自定义浏览器配置

可通过Puppeteer的launch方法配置浏览器参数，如设置窗口大小、禁用无头模式等：

javascript
const browser = await puppeteer.launch({
  headless: false, // 禁用无头模式（显示浏览器窗口）
  defaultViewport: { width: 1280, height: 720 } // 设置窗口大小
});