stacklineorg/nodejs-chrome

Ubuntu-Nodejs-Chrome 镜像文档

镜像概述

本镜像基于Ubuntu操作系统构建，预安装了Node.js运行环境及Chrome浏览器所需的依赖库，旨在为需要同时使用Node.js和浏览器功能的应用提供便捷的运行环境。无需手动配置依赖，可直接用于开发、测试或生产环境。

核心功能与特性

• 基础环境：基于官方Ubuntu镜像，提供稳定的Linux运行环境
• Node.js支持：预装Node.js及npm包管理器，支持JavaScript应用开发与运行
• Chrome依赖：包含Chrome浏览器运行所需的核心依赖库（如libnss3、libxss1、libasound2等），支持浏览器相关操作（如自动化测试、网页渲染等）
• 兼容性：兼容大多数基于Node.js的应用框架（如Express、React、Vue等）及浏览器自动化工具（如Selenium、Puppeteer等）

使用场景

• 前端应用开发与构建（需Node.js环境及浏览器预览）
• 基于浏览器的自动化测试（如UI测试、端到端测试）
• 需要网页渲染功能的服务（如HTML转PDF、网页截图）
• Node.js应用与浏览器交互的场景（如爬虫、数据抓取）

使用方法

1. 拉取镜像

bash
docker pull [镜像名称]:[标签]  # 替换为实际镜像名称和标签，如未指定标签通常使用latest

2. 基本运行命令

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

• -it：以交互模式运行并分配终端
• --rm：容器退出后自动删除
• /bin/bash：启动bash shell，可在容器内执行命令

3. 运行Node.js应用示例

假设本地有Node.js项目目录./my-node-app，可通过以下命令运行：

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

• -v $(pwd)/my-node-app:/app：将本地项目目录挂载到容器内/app目录
• -w /app：设置工作目录为/app
• node app.js：执行项目入口文件

4. 浏览器相关操作示例（如使用Puppeteer）

在容器内安装Puppeteer并运行简单网页截图脚本：

bash
# 容器内执行
npm install puppeteer
cat > screenshot.js << EOF
const puppeteer = require('puppeteer');
(async () => {
  const browser = await puppeteer.launch({args: ['--no-sandbox', '--disable-setuid-sandbox']});
  const page = await browser.newPage();
  await page.goto('https://example.com');
  await page.screenshot({path: 'example.png'});
  await browser.close();
})();
EOF
node screenshot.js

注：运行Puppeteer时需添加--no-sandbox参数以避免权限问题

配置参数说明

环境变量

• NODE_ENV：Node.js运行环境（可选，如development、production，默认development）
• NODE_VERSION：指定Node.js版本（需镜像支持多版本标签时使用）

标签说明

• latest：最新稳定版本，基于最新Ubuntu镜像，包含最新LTS版本Node.js及Chrome依赖
• [ubuntu-version]-node[node-version]：特定版本组合，如22.04-node20（基于Ubuntu 22.04，Node.js 20.x）

依赖检查

容器内可通过以下命令验证环境：

bash
node -v  # 查看Node.js版本
npm -v   # 查看npm版本
ldd /usr/bin/google-chrome  # 验证Chrome依赖（如镜像包含Chrome二进制文件）