apify/actor-node-puppeteer-chrome

集成Debian、Node.js、Puppeteer和Chrome的Docker镜像，支持通过标签选择预安装的Puppeteer版本，适用于浏览器自动化、网页截图、PDF生成等场景。

6 收藏0 次下载activeapify镜像

镜像概述

本Docker镜像基于Debian系统构建，集成Node.js运行环境、Puppeteer库及Chrome浏览器，提供即开即用的浏览器自动化环境。无需手动配置浏览器依赖，可直接用于网页自动化操作、截图生成、PDF导出等任务，支持通过标签灵活选择预安装的Puppeteer版本。

核心功能与特性

完整环境集成：包含Debian基础系统、Node.js运行时、Puppeteer库及Chrome浏览器，一站式满足浏览器自动化需求
版本灵活选择：通过镜像标签（Tag）指定预安装的Puppeteer版本（如:puppeteer-19.7.0），适配不同项目依赖
即开即用：预配置Chrome及相关系统依赖（如字体、库文件），无需手动安装浏览器或解决兼容性问题
版本兼容性：严格匹配Puppeteer与Chrome版本，避免因版本不兼容导致的运行错误
轻量优化：基于***Debian镜像精简构建，平衡功能完整性与镜像体积

使用场景与适用范围

浏览器自动化测试：前端页面功能测试、端到端（E2E）测试
网页内容处理：生成网页截图、导出PDF文件、HTML转图片
前端性能分析：通过Puppeteer API采集页面加载性能数据
合规数据抓取：在遵守网站协议及***的前提下，自动化提取公开网页数据
UI监控：定期检查网页UI变化、元素渲染状态

使用方法与配置说明

获取镜像

通过Docker命令拉取镜像，指定标签选择Puppeteer版本：

bash
docker pull <image-name>:puppeteer-<version>

说明：<image-name>为镜像完整名称（如仓库地址/镜像名），<version>为目标Puppeteer版本号（如19.7.0）。未指定标签时默认使用最新版本。

基本使用示例

执行本地Puppeteer脚本

假设本地有自动化脚本script.js（示例功能：访问网页并生成截图）：

javascript
const puppeteer = require('puppeteer');

(async () => {
  // 启动Chrome（容器环境需配置--no-sandbox参数）
  const browser = await puppeteer.launch({
    headless: 'new',
    args: ['--no-sandbox', '--disable-setuid-sandbox']
  });
  const page = await browser.newPage();
  await page.goto('[***]
  // 保存截图到/output目录
  await page.screenshot({ path: '/output/example.png', fullPage: true });
  await browser.close();
})();

通过以下命令运行容器，挂载本地脚本和输出目录：

bash
docker run -v $(pwd)/script.js:/app/script.js -v $(pwd)/output:/output <image-name>:puppeteer-19.7.0 node /app/script.js

执行后，截图文件将保存到本地./output/example.png。

docker-compose集成示例

创建docker-compose.yml配置文件，集成到项目中：

yaml
version: '3'
services:
  puppeteer-worker:
    image: <image-name>:puppeteer-19.7.0
    volumes:
      - ./scripts:/app/scripts  # 挂载本地脚本目录
      - ./output:/app/output    # 挂载输出文件目录
    environment:
      - NODE_ENV=production
      - PUPPETEER_DISABLE_HEADLESS=false  # 启用无头模式
    command: node /app/scripts/main.js  # 启动脚本路径
    deploy:
      resources:
        limits:
          cpus: '1'
          memory: 2G  # 限制资源使用，避免过度消耗

启动服务：

bash
docker-compose up -d

配置参数说明

环境变量

环境变量名	说明	默认值
`NODE_ENV`	Node.js运行环境，可选`development`（开发）或`production`（生产）	`production`
`PUPPETEER_EXECUTABLE_PATH`	Chrome可执行文件路径，镜像已预设路径	`/usr/bin/google-chrome`
`PUPPETEER_DISABLE_HEADLESS`	是否禁用无头模式（`true`显示浏览器界面，仅调试用）	`false`（默认启用无头模式）
`PUPPETEER_DEFAULT_VIEWPORT`	默认视口大小，格式为`width,height`（如`1920,1080`）	`800,600`