asymmetrik/node-chromium

Node-Chromium 镜像文档

镜像概述和主要用途

Node-Chromium是一个集成了NodeJS和Chromium的Docker镜像，基于官方NodeJS容器构建。该镜像特别针对无头（headless）模式使用场景进行优化，移除了无头模式下非必要的资源文件，提供了NodeJS环境与浏览器协同工作的一站式解决方案。

核心功能和特性

• 双环境集成：同时包含NodeJS运行时和Chromium浏览器，满足前后端协同需求
• 无头模式优化：安装后自动移除资源目录（包含inspector/devtools面板），减少镜像体积
• 版本控制：标签遵循nodeversion-chromiumversion命名模式，便于版本管理
• 环境变量配置：预设CHROME_BIN环境变量，使Chromium可被NodeJS测试框架直接调用
• 安全用户：默认使用node用户（UID 1000）运行，家目录为/home/node，符合安全最佳实践
• 灵活安装源：Chromium可根据标签从stable（稳定版）或snapshot（快照版）渠道安装

使用场景和适用范围

• NodeJS环境下的前端自动化测试（如Jest、Mocha等测试框架）
• 无头浏览器任务（网页截图、PDF生成、自动化表单提交）
• 基于Chromium的网页数据抓取和爬虫应用
• 需要浏览器渲染能力的服务端应用（如SSR预渲染）

使用方法和配置说明

镜像拉取

根据所需NodeJS和Chromium版本，通过标签拉取指定版本镜像：

bash
docker pull [镜像仓库地址]/node-chromium:nodeversion-chromiumversion

示例（拉取NodeJS 18.17.1和Chromium 116.0.5845.96）：

bash
docker pull [镜像仓库地址]/node-chromium:18.17.1-116.0.5845.96

基础运行命令

bash
docker run -it --rm [镜像仓库地址]/node-chromium:nodeversion-chromiumversion

执行NodeJS脚本（调用Chromium）

挂载本地目录并执行需要调用Chromium的NodeJS脚本：

bash
docker run -v $(pwd):/app -w /app [镜像仓库地址]/node-chromium:nodeversion-chromiumversion node your-script.js

参数说明：

• -v $(pwd):/app：将当前目录挂载到容器内/app目录
• -w /app：设置工作目录为/app
• your-script.js：需执行的NodeJS脚本（可通过process.env.CHROME_BIN获取Chromium路径）

环境变量

用户与权限

默认使用node用户（UID 1000）运行容器，如需修改用户可通过--user参数：

bash
docker run --user 1001 [镜像仓库地址]/node-chromium:nodeversion-chromiumversion