nextools/chromium

镜像概述

该镜像提供了Docker化的Chromium浏览器，默认以无头（headless）模式运行并启用远程调试功能。它允许在无图形界面环境中执行Chromium浏览器的各种功能，同时支持通过Chrome DevTools协议进行远程调试，适用于自动化测试、网页截图、动态内容抓取等场景。

核心功能与特性

• 无头模式运行：无需图形界面即可启动和运行Chromium，节省系统资源
• 远程调试支持：内置远程调试功能，可通过Chrome DevTools协议连接和控制浏览器
• 轻量级设计：基于精简基础镜像构建，减少镜像体积和资源占用
• 灵活配置：支持通过环境变量和启动参数自定义浏览器行为

使用场景

• 前端自动化测试：结合Selenium、Puppeteer等工具进行网页UI自动化测试
• 网页内容渲染：生成网页截图或PDF文件
• 动态内容抓取：执行JavaScript并获取动态渲染的网页数据
• 浏览器兼容性测试：在隔离环境中验证网页在Chromium中的表现

使用方法

基本运行命令

bash
docker run -d -p 9222:9222 nextools/chromium

该命令将启动Chromium容器并映射远程调试端口9222到主机。

自定义启动参数

通过环境变量CHROMIUM_FLAGS添加自定义启动参数：

bash
docker run -d -p 9222:9222 -e "CHROMIUM_FLAGS=--no-sandbox --disable-gpu --window-size=1920,1080" nextools/chromium

远程调试连接

启动容器后，可通过Chrome浏览器访问 chrome://inspect 并配置目标为 localhost:9222，或使用Puppeteer等工具连接：

javascript
const puppeteer = require('puppeteer');

(async () => {
  const browser = await puppeteer.connect({
    browserWSEndpoint: 'ws://localhost:9222/devtools/browser'
  });
  const page = await browser.newPage();
  await page.goto('https://example.com');
  await page.screenshot({ path: 'example.png' });
  await browser.disconnect();
})();

docker-compose配置示例

yaml
version: '3'
services:
  chromium:
    image: nextools/chromium
    ports:
      - "9222:9222"
    environment:
      - CHROMIUM_FLAGS=--no-sandbox --disable-gpu --disable-dev-shm-usage
    restart: unless-stopped

常用配置参数