vanrijn/alpine-chrome

alpine-chrome 镜像文档

镜像概述

alpine-chrome是一个基于Alpine Linux的轻量级Docker镜像，包含以无头模式运行的Google Chrome浏览器。该镜像旨在提供最小化的资源占用和高效的网页处理能力，适合在服务器环境或资源受限场景中使用。

核心功能与特性

• 轻量级基础：基于Alpine Linux构建，镜像体积小巧，资源占用低
• 无头模式：无需图形界面即可运行Chrome，适合服务器端自动化任务
• 完整渲染能力：支持网页渲染、JavaScript执行、CSS渲染等Chrome核心功能
• 灵活配置：可通过命令行参数自定义Chrome运行行为
• 易于集成：可与Selenium等自动化测试工具、网页截图工具无缝集成

使用场景与适用范围

• 自动化网页测试：配合Selenium等框架进行UI自动化测试
• 网页截图生成：批量生成网页截图用于报告、监控或存档
• PDF文档转换：将网页内容转换为PDF格式文档
• 动态内容抓取：提取JavaScript渲染后的网页内容
• CI/CD流程集成：在持续集成/部署流程中执行网页测试或文档生成任务

使用方法与配置说明

基本运行

启动无头Chrome浏览器（默认参数）：

bash
docker run --rm docker.xuanyuan.run/tvanrijn/alpine-chrome

网页截图示例

生成指定网页的截图并保存到本地：

bash
docker run --rm -v $(pwd):/screenshots docker.xuanyuan.run/tvanrijn/alpine-chrome \
  --no-sandbox \
  --headless=new \
  --disable-gpu \
  --screenshot=/screenshots/example.png \
  --window-size=1280,720 \
  https://example.com

PDF生成示例

将网页转换为PDF文档：

bash
docker run --rm -v $(pwd):/pdfs docker.xuanyuan.run/tvanrijn/alpine-chrome \
  --no-sandbox \
  --headless=new \
  --disable-gpu \
  --print-to-pdf=/pdfs/example.pdf \
  https://example.com

与Selenium集成

通过远程调试端口连接Selenium WebDriver：

bash
docker run --rm -p 9222:9222 docker.xuanyuan.run/tvanrijn/alpine-chrome \
  --no-sandbox \
  --headless=new \
  --disable-gpu \
  --remote-debugging-port=9222 \
  --remote-debugging-address=0.0.0.0

在Selenium代码中连接到调试端口：

python
from docker.xuanyuan.run/selenium import webdriver
from docker.xuanyuan.run/selenium.webdriver.chrome.options import Options

chrome_options = Options()
chrome_options.add_experimental_option("debuggerAddress", "localhost:9222")
driver = webdriver.Chrome(options=chrome_options)

常用配置参数

Chrome支持多种启动参数，常用参数包括：

• --no-sandbox：禁用沙箱（Alpine环境中必需）
• --headless=new：启用新的无头模式（推荐）
• --disable-gpu：禁用GPU加速（无头模式下通常不需要）
• --window-size=WIDTH,HEIGHT：设置窗口尺寸（如1920,1080）
• --screenshot=PATH：指定截图保存路径
• --print-to-pdf=PATH：指定PDF输出路径
• --remote-debugging-port=PORT：启用远程调试端口
• --user-agent=UA_STRING：自定义User-Agent

源代码

镜像源代码可在GitHub获取：https://github.com/tvanrijn/alpine-chrome/blob/main/Dockerfile