illuin/node-chrome

镜像概述

本Docker镜像集成了Node.js 14.15.4环境与最新版无头Chrome（Headless Chrome），旨在提供一站式运行环境，支持需要Node.js后端能力与浏览器渲染/自动化的场景。无头Chrome模式无需图形界面即可运行浏览器相关任务，适用于服务器、CI/CD等无界面环境。

核心功能与特性

1. Node.js环境

• 内置Node.js 14.15.4，支持基于Node.js的脚本执行、后端服务运行等场景。
• 包含npm包管理工具，可直接安装并运行Node.js依赖包。

2. 无头Chrome

• 集成最新版Chrome浏览器，启用无头模式（Headless Mode），支持无界面浏览器渲染、JavaScript执行、DOM操作等能力。
• 兼容Chrome DevTools Protocol，可通过API控制浏览器行为（如页面导航、截图、网络请求拦截等）。

3. 版本稳定性

• Node.js版本固定为14.15.4，确保依赖Node.js 14.x生态的应用兼容性。
• Chrome保持最新版，持续获取浏览器功能更新与安全补丁。

使用场景

• 前端自动化测试：支持基于Jest、Mocha、Cypress等框架的前端测试，可渲染包含动态JavaScript的页面。
• 网页数据爬取：用于爬取需要JavaScript渲染的动态网页（如SPA应用），通过无头Chrome执行页面脚本后提取数据。
• 服务端页面预渲染：在服务端预渲染前端页面（如React、Vue应用），提升首屏加载速度。
• 浏览器环境脚本运行：执行需要浏览器API的Node.js脚本（如使用Puppeteer控制浏览器）。

使用方法

前提条件

• 已安装Docker引擎（推荐版本20.10+）。

基本运行命令

1. 交互式运行

进入容器终端，直接操作Node.js或Chrome：

bash
docker run -it --rm [镜像名称] /bin/bash

说明：[镜像名称]需替换为实际镜像标签（如构建后的本地镜像名或远程仓库地址）。

2. 运行Node脚本

挂载宿主机目录至容器，执行需要Chrome环境的Node脚本（如使用Puppeteer的爬虫脚本）：

bash
# 假设宿主机当前目录有脚本文件 script.js
docker run --rm -v $(pwd):/app -w /app [镜像名称] node script.js

3. 执行前端测试

在前端项目中，通过容器运行测试命令（以npm脚本为例）：

bash
# 挂载项目目录并运行测试命令
docker run --rm -v $(pwd):/app -w /app [镜像名称] npm run test

示例：使用Puppeteer进行网页截图

1. 在宿主机创建脚本文件 screenshot.js：

javascript
const puppeteer = require('puppeteer');

(async () => {
  const browser = await puppeteer.launch({ headless: 'new' }); // 使用无头模式
  const page = await browser.newPage();
  await page.goto('https://example.com');
  await page.screenshot({ path: 'example.png' });
  await browser.close();
})();

2. 安装依赖（宿主机执行）：

bash
npm init -y
npm install puppeteer

3. 通过容器运行脚本：

bash
docker run --rm -v $(pwd):/app -w /app [镜像名称] node screenshot.js

执行后，宿主机当前目录将生成 example.png 网页截图。

注意事项

• Chrome资源限制：无头Chrome运行时可能占用较多内存，建议根据实际任务调整容器资源限制（如--memory=2g）。
• 网络访问：若脚本需要访问外部网络，确保容器网络配置正确（默认使用bridge网络，支持外部访问）。
• 权限问题：挂载目录时若遇到权限错误，可通过-u $(id -u):$(id -g)指定用户ID，避免容器内权限与宿主机冲突。