nextnextools/chromium Docker 镜像

Chromium Docker镜像文档

镜像概述

本镜像提供了多平台支持的Docker化Chromium浏览器，默认运行在无头模式（headless）并启用远程调试功能。特别针对M1架构设备进行了优化支持，可广泛应用于自动化测试、网页渲染、截图生成等场景。

核心功能与特性

• 多平台支持：兼容x86_64和ARM64（包括M1/M2芯片）架构
• 无头模式：无需图形界面即可运行Chromium
• 远程调试：内置Chrome DevTools协议支持，可通过网络进行远程调试
• 轻量级设计：基于精简基础镜像，优化镜像体积
• 灵活配置：支持通过环境变量自定义Chromium启动参数

使用场景

• 前端自动化测试（与Selenium、Playwright等工具集成）
• 网页截图和PDF生成
• 网页内容抓取与渲染
• CI/CD流程中的前端兼容性测试
• 无头浏览器环境下的JavaScript执行

使用方法

基本运行

通过以下命令启动Chromium容器，默认暴露远程调试端口9222：

bash
docker run -d -p 9222:9222 --name chromium docker.xuanyuan.run/shenato/chromium

自定义启动参数

使用CHROME_OPTS环境变量添加额外启动参数：

bash
docker run -d -p 9222:9222 -e "CHROME_OPTS=--disable-gpu --no-sandbox" --name chromium docker.xuanyuan.run/shenato/chromium

Docker Compose配置

创建docker-compose.yml文件：

yaml
version: '3'
services:
  chromium:
    image: docker.xuanyuan.run/shenato/chromium
    ports:
      - "9222:9222"
    environment:
      - CHROME_OPTS=--disable-gpu --no-sandbox
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

远程调试连接

容器启动后，可通过Chrome浏览器访问 chrome://inspect，点击"Configure"添加localhost:9222，即可远程调试运行中的Chromium实例。

环境变量说明

注意事项

• 生产环境建议添加--no-sandbox参数（需确保容器安全配置）
• 资源受限环境可添加--disable-dev-shm-usage参数避免共享内存限制
• ARM架构设备（如M1/M2 Mac）需确保Docker Desktop开启Rosetta模拟或使用原生ARM镜像

镜像获取

可从Docker Hub获取最新镜像：

bash
docker pull docker.xuanyuan.run/shenato/chromium