akorn/chromium-headless

镜像概述

本镜像提供无头模式（Headless）的Chromium浏览器环境，专为需要浏览器渲染能力但无需图形界面的场景设计。镜像每周自动更新，确保集成最新的Chromium版本，包含安全补丁和功能更新，适合各类自动化任务。

核心功能与特性

• 无头模式运行：无需图形界面即可执行Chromium浏览器功能，节省系统资源
• 每周自动更新：定期同步官方Chromium更新，保持版本时效性和安全性
• 轻量级设计：基于精简基础镜像构建，降低部署资源占用
• 完整命令支持：兼容Chromium标准命令行参数，灵活配置运行行为
• 跨场景适配：支持与自动化测试工具、网页处理脚本无缝集成

适用场景

• Web应用自动化测试（如配合Selenium、Playwright、Puppeteer等框架）
• 网页截图生成与批量处理
• 动态网页内容渲染与PDF导出
• CI/CD流程中的前端自动化测试环节
• 网页内容爬取与数据提取（需遵守目标网站robots协议）

使用方法

基本使用

拉取镜像

bash
docker pull akornatskyy/chromium-headless

验证运行

bash
docker run --rm akornatskyy/chromium-headless --version

基础网页截图示例

bash
docker run --rm -v $(pwd):/output akornatskyy/chromium-headless \
  --no-sandbox \
  --headless=new \
  --disable-gpu \
  --screenshot=/output/screenshot.png \
  https://example.com

关键参数说明

与Puppeteer集成示例

1. 创建测试脚本（test.js）：

javascript
const puppeteer = require('puppeteer');

(async () => {
  const browser = await puppeteer.launch({
    executablePath: '/usr/bin/chromium',
    args: [
      '--no-sandbox',
      '--headless=new',
      '--disable-gpu'
    ]
  });
  const page = await browser.newPage();
  await page.goto('https://example.com');
  await page.screenshot({ path: '/output/example.png' });
  await browser.close();
})();

2. 运行容器执行脚本：

bash
docker run --rm -v $(pwd):/app -v $(pwd)/output:/output akornatskyy/chromium-headless \
  node /app/test.js

注意事项

• 沙箱模式：Docker环境中必须添加--no-sandbox参数，否则可能因权限限制导致启动失败
• 资源挂载：如需保存输出文件（截图、PDF等），需通过-v参数挂载宿主机目录到容器内
• 网络配置：若需访问内部网络服务，可使用--network=host或配置自定义网络
• 性能调优：根据任务需求调整内存限制（--memory）和CPU分配（--cpus）