andrewmackrodt/docker-nodejs-chromium

镜像概述

基于Node.js 20.x的Docker镜像，集成npm、yarn包管理工具和Chromium浏览器，专为需要无头浏览器支持的应用场景设计，例如服务端渲染(SSR)等。

核心功能与特性

• Node.js 20.x环境：提供稳定的JavaScript运行时环境
• 包管理工具：内置npm和yarn，支持主流JavaScript包管理流程
• 无头浏览器支持：集成Chromium浏览器，可直接用于需要浏览器渲染能力的场景

适用场景

适用于需要无头浏览器支持的Node.js应用开发与运行，典型场景包括：

• 服务端渲染(SSR)：如React、Vue等前端框架的服务端渲染实现
• 网页自动化操作：通过Puppeteer等工具进行页面截图、内容提取
• 前端自动化测试：执行依赖浏览器环境的单元测试或集成测试

使用方法

重要说明

本镜像默认导出环境变量 PUPPETEER_SKIP_CHROMIUM_DOWNLOAD=true，避免Puppeteer重复下载Chromium。

Docker命令示例

1. 启动交互模式

bash
docker run --rm -it andrewmackrodt/nodejs-chromium

2. 查看版本信息

bash
docker run --rm andrewmackrodt/nodejs-chromium --version

3. 在当前目录执行npm install

bash
docker run --rm -it \
  -e PUID=$(id -u) \
  -e PGID=$(id -g) \
  -v $PWD:/app \
  -w /app \
  andrewmackrodt/nodejs-chromium npm install

4. 在当前目录执行yarn install

bash
docker run --rm -it \
  -e PUID=$(id -u) \
  -e PGID=$(id -g) \
  -v $PWD:/app \
  -w /app \
  andrewmackrodt/nodejs-chromium yarn install

配置参数说明