yukinying/chrome-headless-browser-selenium

chrome-headless-browser-docker

镜像概述

基于Alpine Linux的轻量级Docker镜像，包含Chrome浏览器的无头版本(headless Chrome)，适用于自动化测试、网页截图、PDF生成等场景。该镜像体积小、启动快速，提供了灵活的配置选项。

核心功能和特性

• 轻量级：基于Alpine Linux，镜像体积小
• 最新版Chrome：包含最新稳定版Chrome浏览器
• 无头模式：无需图形界面即可运行Chrome
• 远程调试：支持Chrome远程调试协议
• 灵活配置：可通过环境变量和命令行参数自定义Chrome启动选项

使用场景和适用范围

• 网页自动化测试
• 网页截图生成
• PDF文档生成
• 网页内容抓取
• JavaScript渲染和执行
• 前端性能测试

使用方法和配置说明

基本使用

bash
docker run -it --rm yukinying/chrome-headless-browser

远程调试

bash
docker run -d -p 9222:9222 --rm yukinying/chrome-headless-browser \
  chrome --headless=new --remote-debugging-address=0.0.0.0 --remote-debugging-port=9222

然后可通过http://localhost:9222访问调试界面。

网页截图

bash
docker run -it --rm -v $(pwd):/screenshots yukinying/chrome-headless-browser \
  chrome --headless=new --disable-gpu --screenshot=/screenshots/screenshot.png https://example.com

生成PDF

bash
docker run -it --rm -v $(pwd):/pdfs yukinying/chrome-headless-browser \
  chrome --headless=new --disable-gpu --print-to-pdf=/pdfs/example.pdf https://example.com

Docker Compose配置

yaml
version: '3'
services:
  chrome:
    image: yukinying/chrome-headless-browser
    ports:
      - "9222:9222"
    command: chrome --headless=new --remote-debugging-address=0.0.0.0 --remote-debugging-port=9222
    volumes:
      - ./screenshots:/screenshots
      - ./pdfs:/pdfs

高级配置

自定义Chrome启动参数

bash
docker run -it --rm yukinying/chrome-headless-browser \
  chrome --headless=new --disable-gpu --window-size=1280,720 --no-sandbox \
  --user-agent="Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/90.0.4430.212 Safari/537.36" \
  https://example.com

远程调试与卷挂载

bash
docker run -d -p 9222:9222 -v $(pwd):/workspace --rm yukinying/chrome-headless-browser \
  chrome --headless=new --remote-debugging-address=0.0.0.0 --remote-debugging-port=9222 \
  --user-data-dir=/workspace/chrome-data

环境变量

目前该镜像不使用特定的环境变量，所有配置通过Chrome命令行参数完成。

常用Chrome命令行参数

• --headless=new: 启用新的无头模式
• --disable-gpu: 禁用GPU加速
• --remote-debugging-address: 指定远程调试绑定地址
• --remote-debugging-port: 指定远程调试端口
• --screenshot: 截取网页截图
• --print-to-pdf: 生成PDF文件
• --window-size: 指定窗口大小
• --no-sandbox: 禁用沙箱模式
• --user-agent: 自定义用户代理字符串
• --user-data-dir: 指定用户数据目录

维护和更新

该镜像会定期更新以包含最新版本的Chrome浏览器和安全补丁。建议定期更新镜像以获取最新功能和安全修复。