garunski/alpine-chrome

garunski/alpine-chrome 镜像说明

镜像概述

基于Alpine Linux构建的最小化无头Chrome Docker镜像，旨在提供轻量、高效的无头浏览器环境，支持Puppeteer集成，适用于各类自动化网页处理场景。

核心功能

• 支持无头Chrome基础操作：网页截图、PDF生成、DOM导出
• 提供远程调试功能（DevTools）
• 集成Puppeteer，支持Node.js脚本自动化
• 三种安全配置方式（无沙箱、SYS_ADMIN权限、seccomp安全配置）

使用场景

• 自动化网页测试与截图
• 网页内容抓取与分析
• 生成网页PDF报告
• 基于Puppeteer的自动化任务（如表单提交、数据爬取）

配置说明与部署示例

三种Chrome无头模式使用方式

1. 无沙箱模式（仅用于可信网站）

   bash
   docker container run -it --rm garunski/alpine-chrome --no-sandbox [命令参数]
   

2. 带SYS_ADMIN权限（支持沙箱但需额外权限）

   bash
   docker container run -it --rm --cap-add=SYS_ADMIN garunski/alpine-chrome [命令参数]
   

3. seccomp配置（推荐，安全且无需额外权限）
   先下载配置文件：

   bash
   wget https://raw.githubusercontent.com/Zenika/alpine-chrome/master/chrome.json
   

   运行容器：

   bash
   docker container run -it --rm --security-opt seccomp=$(pwd)/chrome.json garunski/alpine-chrome [命令参数]
   

常用命令示例

• 远程调试：

  bash
  docker container run -d -p 9222:9222 garunski/alpine-chrome --no-sandbox --remote-debugging-address=0.0.0.0 --remote-debugging-port=9222 https://www.chromestatus.com/
  

  访问http://localhost:9222即可进行调试。

• 生成PDF：

  bash
  docker container run -it --rm -v $(pwd):/usr/src/app garunski/alpine-chrome --no-sandbox --print-to-pdf --hide-scrollbars https://www.chromestatus.com/
  

• 网页截图：

  bash
  docker container run -it --rm -v $(pwd):/usr/src/app garunski/alpine-chrome --no-sandbox --screenshot --hide-scrollbars --window-size=1280,1696 https://www.chromestatus.com/
  

Puppeteer集成使用

使用with-puppeteer标签运行Node.js脚本：

bash
docker run -it --rm -v $(pwd):/usr/src/app --cap-add=SYS_ADMIN docker.xuanyuan.run/garunski/alpine-chrome:with-puppeteer node my-test.js