satantime/puppeteer-node

satantime/puppeteer-node 镜像文档

镜像概述和主要用途

satantime/puppeteer-node 是基于官方 Node.js 镜像构建的 Docker 镜像，其核心用途是为持续集成 (CI) 环境提供预配置的 Puppeteer 运行依赖。该镜像在所有版本/平台的 Node.js 官方镜像基础上，仅添加一层包含 Puppeteer 运行时依赖的层（如 Chromium 相关库），但不包含 Puppeteer 本身。用户可根据需求自行安装特定版本的 Puppeteer，灵活适配不同项目对 Puppeteer 及 Chrome 浏览器版本的依赖。

核心功能与特性

• 基于官方 Node.js 镜像：严格遵循官方 Node.js 镜像的版本和平台标签（如 20.9.0-bookworm、18.18.0-buster 等），确保环境一致性。
• 最小化依赖层：仅添加 Puppeteer 运行必需的系统依赖（如字体、图形库等），避免镜像体积膨胀。
• 版本灵活性：不捆绑特定版本的 Puppeteer，用户可通过 npm install puppeteer@x.y.z 自由选择版本，适配不同测试框架（如 WebdriverIO）对 Chrome 版本的要求。
• 多平台支持：覆盖官方 Node.js 镜像支持的所有平台，无特殊平台限制。
• 无 Alpine 版本：暂不提供基于 Alpine Linux 的镜像版本。

使用场景和适用范围

• 持续集成 (CI) 环境：适用于需要在 CI 流程中运行 Puppeteer 的场景，如前端自动化测试（Angular、React、Vue 等框架）、网页截图/PDF 生成等。
• 开发环境一致性：本地开发与 CI 环境共享相同的 Puppeteer 依赖配置，避免“本地可运行，CI 失败”的环境差异问题。
• 多版本 Puppeteer 适配：需在不同项目中使用不同版本 Puppeteer 时，无需重复配置系统依赖。

使用方法和配置说明

基础使用方式

镜像标签格式与官方 Node.js 镜像完全一致，只需将 node 镜像名替换为 satantime/puppeteer-node 即可。

1. Dockerfile 示例

基于特定 Node.js 版本构建项目镜像：

dockerfile
# 基于 satantime/puppeteer-node:20.9.0-bookworm（对应官方 node:20.9.0-bookworm）
FROM satantime/puppeteer-node:20.9.0-bookworm

# 设置工作目录
WORKDIR /app

# 复制项目依赖文件
COPY package*.json ./

# 安装项目依赖（包括所需版本的 Puppeteer）
RUN npm install puppeteer@21.5.0  # 示例：安装 Puppeteer 21.5.0

# 复制项目代码
COPY . .

# 运行 Puppeteer 相关命令（如测试、截图等）
CMD ["node", "your-puppeteer-script.js"]

2. docker-compose 配置示例

在 docker-compose.yml 中使用：

yaml
version: '3.8'
services:
  puppeteer-service:
    image: satantime/puppeteer-node:20.9.0-bookworm  # 对应 Node.js 20.9.0，Debian bookworm
    working_dir: /app
    volumes:
      - ./:/app  # 挂载本地项目目录
    command: sh -c "npm install puppeteer@21.5.0 && node your-puppeteer-script.js"  # 安装指定版本 Puppeteer 并运行脚本

注意事项

• 无 Alpine 版本：该镜像不提供基于 Alpine Linux 的版本，仅支持 Debian/Ubuntu 等官方 Node.js 镜像的基础系统。
• 版本请求：若未找到所需的 Node.js 版本标签，可通过 https://github.com/satanTime/puppeteer-node/issues/new 提交版本需求。

相关资源

• Angular 持续集成配置：关于如何在 CI 环境中配置 Angular 应用的详细文档，参见 https://satantime.github.io/puppeteer-node/%E3%80%82
• 镜像仓库：https://hub.docker.com/r/satantime/puppeteer-node
• 源码与反馈：https://github.com/satanTime/puppeteer-node