tidyrailroad/chromium

Chromium Docker镜像文档

镜像概述

Chromium是由Google主导开发的开源网页浏览器项目，是Google Chrome浏览器的基础。本Docker镜像将Chromium浏览器进行容器化封装，提供无需本地安装即可运行的浏览器环境，支持现代网页标准、JavaScript执行及可配置的运行参数，适用于多种开发和自动化场景。

核心功能与特性

• 开源免费：基于GNU General Public License v3.0许可，可自由使用和修改
• 标准兼容性：支持HTML5、CSS3、JavaScript等现代网页标准
• 无头模式支持：可运行Headless模式，无需图形界面即可执行网页渲染和交互
• 轻量级部署：容器化设计，简化依赖管理，可快速部署到各类环境
• 灵活配置：支持通过启动参数自定义浏览器行为，如窗口大小、代理设置等
• 跨平台兼容：可在任何支持Docker的操作系统上运行

使用场景与适用范围

• 开发测试：网页兼容性测试、前端功能验证
• 自动化任务：网页截图、数据抓取、自动化表单提交
• CI/CD集成：前端自动化测试流程中的浏览器环境提供
• 环境隔离：需要独立浏览器环境的应用场景，避免本地环境干扰

使用方法与配置说明

基本运行

通过以下命令启动Chromium浏览器（需宿主机支持图形界面）：

bash
docker run -it --rm \
  -e DISPLAY=$DISPLAY \
  -v /tmp/.X11-unix:/tmp/.X11-unix \
  chromium

无头模式运行

以无头模式运行（无图形界面，适用于自动化任务）：

bash
docker run -it --rm \
  chromium \
  chromium-browser --headless=new --disable-gpu --remote-debugging-port=9222

自定义启动参数

通过CHROMIUM_FLAGS环境变量或直接在命令后添加参数自定义浏览器行为：

bash
# 设置窗口大小并禁用JavaScript
docker run -it --rm \
  chromium \
  chromium-browser --window-size=1920,1080 --disable-javascript

数据持久化

挂载数据卷保存浏览器配置和缓存：

bash
docker run -it --rm \
  -v /path/to/local/data:/home/chromium/.config/chromium \
  chromium

环境变量说明

注意事项

• 图形界面模式需宿主机支持X11显示系统
• 无头模式下可通过--remote-debugging-port启用远程调试
• 部分功能（如GPU加速）可能受容器环境限制，建议根据需求调整参数

许可证信息

本镜像基于Chromium项目构建，遵循GNU General Public License v3.0许可。详细许可条款可访问：<[***]>