zenika/alpine-chrome

可用仓库

基于Docker Hub速率限制的变更，提供以下仓库地址：

• https://hub.docker.com/r/zenika/alpine-chrome%EF%BC%88%E6%97%A0%E5%89%8D%E7%BC%80%EF%BC%89%EF%BC%9A%60zenika/alpine-chrome%60
• Google Cloud（按地区就近访问）：
  • 全球：gcr.io/zenika-hub/alpine-chrome
  • 欧洲：eu.gcr.io/zenika-hub/alpine-chrome
  • 亚洲：asia.gcr.io/zenika-hub/alpine-chrome
  • 美国：us.gcr.io/zenika-hub/alpine-chrome

支持的标签及对应Dockerfile链接

• latest、100 https://github.com/Zenika/alpine-chrome/blob/master/Dockerfile
• with-node、100-with-node、100-with-node-16（带Node.js）https://github.com/Zenika/alpine-chrome/blob/master/with-node/Dockerfile
• with-puppeteer、100-with-puppeteer（带Puppeteer）https://github.com/Zenika/alpine-chrome/blob/master/with-puppeteer/Dockerfile
• with-playwright、100-with-playwright（带Playwright）https://github.com/Zenika/alpine-chrome/blob/master/with-playwright/Dockerfile
• with-selenoid、100-with-selenoid（带Selenoid）https://github.com/Zenika/alpine-chrome/blob/master/with-selenoid/Dockerfile
• with-chromedriver、100-with-chromedriver（带Chromedriver）https://github.com/Zenika/alpine-chrome/blob/master/with-chromedriver/Dockerfile
• 历史版本：89、86、85、84、83、81、80、77、76、73、72、71、68、64
• 带Node.js的历史版本：89-with-node、86-with-node、85-with-node等
• 带Puppeteer的历史版本：89-with-puppeteer、86-with-puppeteer等

alpine-chrome

在极小的Alpine镜像中以无头模式运行的Chrome浏览器

---

🤔 为什么使用无头Chrome

在Web开发中，快速运行端到端测试至关重要。Puppeteer等流行技术使开发者能够实现测试、表单自动化、网页爬取、截图生成、时间线捕获等功能。而秘密在于：Chrome原生支持其中部分功能！🙌

💡 打造理想容器的特性

• 📦 最小的无头Chrome镜像（压缩大小：https://github.com/Zenika/alpine-chrome#image-disk-size%EF%BC%89
• 🐳 易于使用、临时且可复现的Docker无头Chrome环境
• 📝 文档友好，提供打印DOM、生成移动比例图片、生成PDF等示例
• 👷‍♂️ 通过https://hub.docker.com/repository/docker/zenika/alpine-chrome%E8%87%AA%E5%8A%A8%E6%9E%84%E5%BB%BA%EF%BC%8C%E7%A1%AE%E4%BF%9D%E9%A1%B9%E7%9B%AE%E5%90%8C%E6%AD%A5%E5%92%8C%E9%95%9C%E5%83%8F%E5%8F%AF%E9%9D%A0%E6%80%A7
• 📌 包含最新Chromium版本，同时提供历史版本标签以便测试不同Chromium版本
• 🔐 安全可靠，提供https://github.com/Zenika/alpine-chrome#3-ways-to-securely-use-chrome-headless-with-this-image
• 🌐 支持国际化：包含亚洲字符支持（参见https://github.com/Zenika/alpine-chrome/blob/master/with-puppeteer/src/screenshot-asia.js%EF%BC%89
• 💄 支持设计场景：支持WebGL和表情符号（参见https://github.com/Zenika/alpine-chrome#how-to-use-with-webgl%E5%92%8Chttps://github.com/Zenika/alpine-chrome/issues/114%EF%BC%89
• 📄 开源，采用Apache2许可证
• 👥 社区共建，包含外部贡献者（参见https://github.com/Zenika/alpine-chrome#-contributors%EF%BC%89
• 💚 开发者友好，提供NodeJS、Puppeteer、docker-compose示例，以及X11显示测试（参见https://github.com/Zenika/alpine-chrome#run-examples%EF%BC%89

三种安全使用本镜像运行Chrome无头模式的方法

❌ 无任何配置

仅使用docker container run -it zenika/alpine-chrome ...启动容器会失败，日志类似https://github.com/Zenika/alpine-chrome/issues/33%E3%80%82%E8%AF%B7%E4%BD%BF%E7%94%A8%E4%BB%A5%E4%B8%8B%E4%B8%89%E7%A7%8D%E6%96%B9%E6%B3%95%E3%80%82

✅ 使用--no-sandbox

启动容器命令：

docker container run -it --rm zenika/alpine-chrome，并在所有命令中添加--no-sandbox参数。

注意：确保信任目标网站。

no-sandbox参数的简要说明参见此处，深度设计文档参见此处。

✅ 使用SYS_ADMIN权限

启动容器命令： docker container run -it --rm --cap-add=SYS_ADMIN zenika/alpine-chrome

此方法允许Chrome启用沙箱，但从Docker角度看授予了不必要的权限。

✅ 最佳方式：使用seccomp

基于Jessie Frazelle的Chrome安全计算（seccomp）配置文件，这是最安全的运行方式。

配置文件：https://github.com/Zenika/alpine-chrome/blob/master/chrome.json%EF%BC%8C%E4%B9%9F%E5%8F%AF%E9%80%9A%E8%BF%87%60wget https://raw.githubusercontent.com/jfrazelle/dotfiles/master/etc/docker/seccomp/chrome.json%60%E8%8E%B7%E5%8F%96%E3%80%82

启动容器命令： docker container run -it --rm --security-opt seccomp=$(pwd)/chrome.json zenika/alpine-chrome

命令行使用方法

默认入口点

默认入口点执行命令：chromium-browser --headless --disable-gpu --disable-software-rasterizer --disable-dev-shm-usage

如需完全控制，可覆盖入口点：docker container run -it --rm --entrypoint "" zenika/alpine-chrome chromium-browser ...

使用开发者工具

命令（需no-sandbox）：docker container run -d -p 9222:9222 zenika/alpine-chrome --no-sandbox --remote-debugging-address=0.0.0.0 --remote-debugging-port=9222 https://www.chromestatus.com/

在浏览器中访问http://localhost:9222，点击要检查的标签页。将链接开头的https://chrome-devtools-frontend.appspot.com/serve_file/@.../inspector.html?ws=localhost:9222/[END]替换为chrome-devtools://devtools/bundled/inspector.html?ws=localhost:9222/[END]。

打印DOM

命令（需no-sandbox）：docker container run -it --rm zenika/alpine-chrome --no-sandbox --dump-dom https://www.chromestatus.com/

生成PDF

命令（需no-sandbox）：docker container run -it --rm -v $(pwd):/usr/src/app zenika/alpine-chrome --no-sandbox --print-to-pdf --hide-scrollbars https://www.chromestatus.com/

截取屏幕截图

命令（需no-sandbox）：docker container run -it --rm -v $(pwd):/usr/src/app zenika/alpine-chrome --no-sandbox --screenshot --hide-scrollbars https://www.chromestatus.com/

标准信纸尺寸

命令（需no-sandbox）：docker container run -it --rm -v $(pwd):/usr/src/app zenika/alpine-chrome --no-sandbox --screenshot --hide-scrollbars --window-size=1280,1696 https://www.chromestatus.com/

Nexus 5x手机尺寸

命令（需no-sandbox）：docker container run -it --rm -v $(pwd):/usr/src/app zenika/alpine-chrome --no-sandbox --screenshot --hide-scrollbars --window-size=412,732 https://www.chromestatus.com/

截图文件归属当前用户（默认归容器用户所有）

命令（需no-sandbox）：docker container run -u `id -u $USER` -it --rm -v $(pwd):/usr/src/app zenika/alpine-chrome --no-sandbox --screenshot --hide-scrollbars --window-size=412,732 [***]

与Deno集成使用

进入deno src目录，构建镜像：

docker image build -t zenika/alpine-chrome:with-deno-sample .

启动容器：

docker container run -it --rm zenika/alpine-chrome:with-deno-sample
 Download https://deno.land/std/examples/welcome.ts
 Warning Implicitly using master branch https://deno.land/std/examples/welcome.ts
 Compile https://deno.land/std/examples/welcome.ts
 Welcome to Deno 🦕

运行自定义文件：

docker container run -it --rm -v $(pwd):/usr/src/app zenika/alpine-chrome:with-deno-sample run helloworld.ts
Compile file:///usr/src/app/helloworld.ts
Download https://deno.land/std/fmt/colors.ts
Warning Implicitly using master branch https://deno.land/std/fmt/colors.ts
Hello world!

与Puppeteer集成使用

借助"Puppeteer"工具，可扩展无头Chrome功能。通过NodeJS代码可实现更复杂的测试。

详见https://github.com/Zenika/alpine-chrome/blob/master/with-puppeteer%E7%9B%AE%E5%BD%95%E3%80%82%E9%9C%80https://github.com/puppeteer/puppeteer/blob/main/versions.js%E3%80%82

若src目录中有NodeJS/Puppeteer脚本pdf.js，启动命令：

docker container run -it --rm -v $(pwd)/src:/usr/src/app/src --cap-add=SYS_ADMIN zenika/alpine-chrome:with-puppeteer node src/pdf.js

通过"wqy-zenhei"库支持亚洲语言页面（如https://github.com/Zenika/alpine-chrome/blob/master/with-puppeteer/src/screenshot-asia.js%EF%BC%89%EF%BC%9A

docker container run -it --rm -v $(pwd)/src:/usr/src/app/src --cap-add=SYS_ADMIN zenika/alpine-chrome:with-puppeteer node src/screenshot-asia.js

已测试支持以下语言的网站：

• 中文（https://m.baidu.com）
• 日文（https://www.yahoo.co.jp/）
• 韩文（https://www.naver.com/）

使用Puppeteer测试Chrome扩展

https://github.com/puppeteer/puppeteer/blob/main/docs/api.md#working-with-chrome-extensions%EF%BC%8C%E6%97%A0%E5%A4%B4%E6%A8%A1%E5%BC%8F%E4%B8%8D%E6%94%AF%E6%8C%81%E6%B5%8B%E8%AF%95Chrome%E6%89%A9%E5%B1%95%EF%BC%8C%E9%9C%80%E5%80%9F%E5%8A%A9Xvfb%E6%8F%90%E4%BE%9B%E6%98%BE%E7%A4%BA%E7%8E%AF%E5%A2%83%E3%80%82

详见https://github.com/Zenika/alpine-chrome/blob/master/with-puppeteer-xvfb%E7%9B%AE%E5%BD%95%EF%BC%8C%E9%9C%80https://github.com/puppeteer/puppeteer/blob/main/versions.js%E3%80%82

若src目录中有脚本extension.js，扩展文件在chrome-extension目录，启动命令：

docker container run -it --rm -v $(pwd)/src:/usr/src/app/src --cap-add=SYS_ADMIN zenika/alpine-chrome:with-puppeteer-xvfb node src/extension.js

示例扩展将所有网站背景设为红色，脚本会加载扩展并截取icanhazip.com的截图。

与Playwright集成使用

类似"Puppeteer"，"Playwright"也可扩展无头Chrome功能。

进入with-playwright目录，启动命令：

docker container run -it --rm -v $(pwd)/src:/usr/src/app/src --cap-add=SYS_ADMIN zenika/alpine-chrome:with-playwright node src/useragent.js

with-playwright/src目录将生成example-chromium.png文件。

WebGL使用方法

默认支持WebGL，如需禁用，启动Chromium时添加--disable-gpu。

with-webgl标签已弃用，将于2020年8月底前移除。

示例命令：

docker container run -it --rm --cap-add=SYS_ADMIN -v $(pwd):/usr/src/app zenika/alpine-chrome --screenshot --hide-scrollbars https://webglfundamentals.org/webgl/webgl-fundamentals.html

docker container run -it --rm --cap-add=SYS_ADMIN -v $(pwd):/usr/src/app zenika/alpine-chrome --screenshot --hide-scrollbars https://browserleaks.com/webgl

相关链接：

• https://github.com/adieuadieu/serverless-chrome/issues/108
• https://github.com/DevExpress/testcafe/issues/2116
• 'use-gl'参数值说明此处

与Chromedriver集成使用

ChromeDriver是Selenium WebDriver控制Chrome的独立可执行文件。本镜像可作为Docker化Selenium测试的基础。详见使用Chromedriver运行Selenium测试指南。

与Selenoid集成使用

https://github.com/aerokube/selenoid%E6%98%AF%E5%9F%BA%E4%BA%8EDocker%E7%9A%84Selenium hub实现，轻量级且功能强大。with-selenoid镜像包含Selenium服务器、Chrome和Chromedriver。

启动命令：

docker container run -it --rm --cap-add=SYS_ADMIN  -p 4444:4444 zenika/alpine-chrome:with-selenoid -capture-driver-logs

测试可访问http://localhost:4444/wd/hub。

在GitLab CI等Docker权限受限环境中，可能无法使用--cap-add=SYS_ADMIN，需向chromedriver传递--no-sandbox参数。详见selenoid文档。

以root用户运行并覆盖默认入口点

命令：

docker container run --rm -it --entrypoint "" --user root zenika/alpine-chrome sh

运行示例

examples目录提供以下示例：

• 🐳 https://github.com/Zenika/alpine-chrome/blob/master/examples/docker-compose%EF%BC%9A%E5%90%AF%E5%8A%A8Chrome%E5%B9%B6%E8%B0%83%E7%94%A8%E5%90%8C%E4%B8%80docker-compose%E4%B8%AD%E7%9A%84nginx%E6%9C%8D%E5%8A%A1%E5%99%A8
• ☸️ https://github.com/Zenika/alpine-chrome/tree/master/examples/k8s%EF%BC%9A%E5%9C%A8K8s%E4%B8%AD%E9%83%A8%E7%BD%B2%E6%97%A0%E5%A4%B4