schliflo/docker-puppeteer

puppeteer Docker镜像

包含https://github.com/GoogleChrome/puppeteer%E5%92%8C%E6%88%AA%E5%9B%BE%E8%84%9A%E6%9C%AC%E7%9A%84Docker%E9%95%9C%E5%83%8F%E3%80%82

镜像概述

该镜像预安装了Google Puppeteer（无头Chrome/Chromium自动化工具）及配套截图脚本，可快速用于网页自动化操作、网页截图生成、定时截图等场景，简化Puppeteer环境配置流程。

核心功能与特性

• 内置Puppeteer，无需手动安装依赖
• 提供多种截图工具：基础截图、全屏截图、系列截图等
• 支持自定义脚本运行，灵活扩展功能
• 包含常见问题解决方案（如沙箱配置、内存问题处理等）

安装

bash
docker pull schliflo/docker-puppeteer:latest
# 或指定版本
docker pull schliflo/docker-puppeteer:2.1.0

使用前注意事项

1. 启动浏览器时需传递特定参数

启动Puppeteer浏览器实例时，必须添加--no-sandbox和--disable-setuid-sandbox参数：

js
const puppeteer = require('puppeteer');

(async() => {
    const browser = await puppeteer.launch({
        args: [
            '--no-sandbox',
            '--disable-setuid-sandbox'
        ]
    });

    const page = await browser.newPage();
    await page.goto('https://www.google.com/', {waitUntil: 'networkidle2'});
    browser.close();
})();

2. 处理页面崩溃问题（BUS_ADRERR错误）

若遇到页面崩溃并提示BUS_ADRERR错误（chromium issue），需通过--shm-size参数增加共享内存大小：

bash
docker run --shm-size 1G --rm -v <本地脚本路径>:/app/index.js schliflo/docker-puppeteer:latest

3. 解决随机导航错误

若出现随机导航错误（如无法访问URL），可能是Docker启用了IPv6导致。通过--sysctl参数禁用IPv6可修复：

bash
docker run --shm-size 1G --sysctl net.ipv6.conf.all.disable_ipv6=1 --rm -v <本地脚本路径>:/app/index.js schliflo/docker-puppeteer:latest

4. 启用Chrome调试日志

如需Chrome调试日志，添加--enable-logging参数（详细说明：[***]

js
const puppeteer = require('puppeteer');

(async() => {
    const browser = await puppeteer.launch({args: [
        '--no-sandbox',
        '--disable-setuid-sandbox',
        // 调试日志参数
        '--enable-logging', '--v=1'
    ]});
    // ...
})();

使用方法

挂载脚本至/app/index.js

将本地脚本挂载到容器的/app/index.js路径，容器会自动执行该脚本：

bash
docker run --shm-size 1G --rm -v <本地脚本路径>:/app/index.js schliflo/docker-puppeteer:latest

从目录运行自定义脚本

挂载本地目录至/app，并指定要运行的脚本文件名：

bash
docker run --shm-size 1G --rm \
 -v <本地目录路径>:/app \
 schliflo/docker-puppeteer:latest \
 node my_script.js

截图工具

镜像内置简单截图工具，支持多种截图模式。

基本语法

bash
docker run --shm-size 1G --rm -v /tmp/screenshots:/screenshots \
 schliflo/docker-puppeteer:latest \
 <工具名称> '目标URL' 宽x高 [<延迟毫秒数>]

• 工具名称：可选值screenshot、full_screenshot、screenshot_series、full_screenshot_series
• 目标URL：需截图的网页地址（需用引号包裹）
• 宽x高：窗口尺寸，格式如1366x768
• 延迟毫秒数：可选参数，截图前等待的毫秒数（默认0）

screenshot：基础窗口截图

截取指定尺寸窗口内的网页可见区域：

bash
docker run --shm-size 1G --rm -v /tmp/screenshots:/screenshots \
 schliflo/docker-puppeteer:latest \
 screenshot 'https://www.google.com' 1366x768

输出：单行JSON格式结果

json
{
    "date":"2017-09-01T05:03:27.464Z",
    "timestamp":1504242207,
    "filename":"screenshot_1366_768.png",
    "width":1366,
    "height":768
}

截图文件保存路径：/tmp/screenshots/screenshot_1366_768.png（对应本地挂载目录）

full_screenshot：全屏截图

截取网页完整内容（包含滚动区域）：

bash
docker run --shm-size 1G --rm -v /tmp/screenshots:/screenshots \
 schliflo/docker-puppeteer:latest \
 full_screenshot 'https://www.google.com' 1366x768

screenshot_series / full_screenshot_series：系列截图

文件名包含ISO格式时间戳，适用于定时截图场景：

bash
# 基础系列截图
docker run --shm-size 1G --rm -v /tmp/screenshots:/screenshots \
 schliflo/docker-puppeteer:latest \
 screenshot_series 'https://www.google.com' 1366x768

# 全屏系列截图
docker run --shm-size 1G --rm -v /tmp/screenshots:/screenshots \
 schliflo/docker-puppeteer:latest \
 full_screenshot_series 'https://www.google.com' 1366x768

输出文件名示例：

2017-09-01T05:08:55.027Z_screenshot_1366_768.png
# 或
2017-09-01T05:08:55.027Z_full_screenshot_1366_768.png