zenika/alpine-chrome 镜像说明 | Docker Alpine Chrome 国内下载拉取

zenika/alpine-chrome

自动构建

在极小的Alpine镜像中以无头模式运行的Chrome浏览器，适用于网页测试、自动化和内容生成等场景，体积小巧且功能丰富。

72 收藏0 次下载activezenika镜像

🚀专业版镜像服务，面向生产环境设计

版本下载

🚀专业版镜像服务，面向生产环境设计

![GitHub Stars]([] ![Docker Build Status]([] ![Docker Pulls]([] ![Docker Stars]([]

可用仓库

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

Docker Hub（无前缀）：zenika/alpine-chrome
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 (Dockerfile)
with-node、100-with-node、100-with-node-16（带Node.js）(Dockerfile)
with-puppeteer、100-with-puppeteer（带Puppeteer）(Dockerfile)
with-playwright、100-with-playwright（带Playwright）(Dockerfile)
with-selenoid、100-with-selenoid（带Selenoid）(Dockerfile)
with-chromedriver、100-with-chromedriver（带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镜像（压缩大小：423 MB）
🐳 易于使用、临时且可复现的Docker无头Chrome环境
📝 文档友好，提供打印DOM、生成移动比例图片、生成PDF等示例
👷‍♂️ 通过Docker Hub自动构建，确保项目同步和镜像可靠性
📌 包含最新Chromium版本，同时提供历史版本标签以便测试不同Chromium版本
🔐 安全可靠，提供三种安全使用Chrome无头模式的方法
🌐 支持国际化：包含亚洲字符支持（参见"screenshot-asia.js"文件）
💄 支持设计场景：支持WebGL和表情符号（参见"WebGL使用方法"和"表情符号显示问题"）
📄 开源，采用Apache2许可证
👥 社区共建，包含外部贡献者（参见"✨ 贡献者"章节）
💚 开发者友好，提供NodeJS、Puppeteer、docker-compose示例，以及X11显示测试（参见"运行示例"章节）

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

❌ 无任何配置

仅使用docker container run -it zenika/alpine-chrome ...启动容器会失败，日志类似#33。请使用以下三种方法。

✅ 使用`--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）配置文件，这是最安全的运行方式。

配置文件：chrome.json，也可通过wget [***]获取。

启动容器命令： 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 [***]

在浏览器中访问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 [***]

生成PDF

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

截取屏幕截图

命令（需no-sandbox）：docker container run -it --rm -v $(pwd):/usr/src/app zenika/alpine-chrome --no-sandbox --screenshot --hide-scrollbars [***]

标准信纸尺寸

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

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 [***]

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

命令（需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 [***]
 Warning Implicitly using master branch [***]
 Compile [***]
 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 [***]
Warning Implicitly using master branch [***]
Hello world!

与Puppeteer集成使用

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

详见"with-puppeteer"目录。需遵循Chromium与Puppeteer版本对应关系。

若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"库支持亚洲语言页面（如"screenshot-asia.js"）：

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

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

中文（[***]）
日文（[***]）
韩文（[***]）

使用Puppeteer测试Chrome扩展

根据Puppeteer官方文档，无头模式不支持测试Chrome扩展，需借助Xvfb提供显示环境。

详见"with-puppeteer-xvfb"目录，需遵循Chromium与Puppeteer版本对应关系。

若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 [***]

docker container run -it --rm --cap-add=SYS_ADMIN -v $(pwd):/usr/src/app zenika/alpine-chrome --screenshot --hide-scrollbars [***]

与Chromedriver集成使用

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

与Selenoid集成使用

Selenoid是基于Docker的Selenium 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目录提供以下示例：

🐳 docker-compose：启动Chrome并调用同一docker-compose中的nginx服务器
☸️ kubernetes：在K8s中部署无头

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问版本下载页面。

国内拉取方式

docker pull docker.xuanyuan.run/zenika/alpine-chrome:<标签>

使用方法：

官方拉取方式

docker pull zenika/alpine-chrome:<标签>

轩辕镜像配置手册

探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式

登录仓库拉取

通过 Docker 登录认证访问私有仓库

Linux

在 Linux 系统配置镜像服务

Windows/Mac

在 Docker Desktop 配置镜像

Docker Compose

Docker Compose 项目配置

K8s Containerd

Kubernetes 集群配置 Containerd

K3s

K3s 轻量级 Kubernetes 镜像加速

宝塔面板

在宝塔面板一键配置镜像

群晖

Synology 群晖 NAS 配置

飞牛

飞牛 fnOS 系统配置镜像

极空间

极空间 NAS 系统配置服务

爱快路由

爱快 iKuai 路由系统配置

绿联

绿联 NAS 系统配置镜像

威联通

QNAP 威联通 NAS 配置

Podman

Podman 容器引擎配置

Singularity/Apptainer

HPC 科学计算容器配置

其他仓库配置

ghcr、Quay、nvcr 等镜像仓库

专属域名拉取

无需登录使用专属域名

需要其他帮助？请查看我们的常见问题Docker 镜像访问常见问题解答或提交工单

镜像拉取常见问题

轩辕镜像免费版与专业版有什么区别？

免费版仅支持 Docker Hub 访问，不承诺可用性和速度；专业版支持更多镜像源，保证可用性和稳定速度，提供优先客服响应。

轩辕镜像支持哪些镜像仓库？

专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等；免费版仅支持 docker.io。

流量耗尽错误提示

当返回 402 Payment Required 错误时，表示流量已耗尽，需要充值流量包以恢复服务。

410 错误问题

通常由 Docker 版本过低导致，需要升级到 20.x 或更高版本以支持 V2 协议。

manifest unknown 错误

先检查 Docker 版本，版本过低则升级；版本正常则验证镜像信息是否正确。

镜像拉取成功后，如何去掉轩辕镜像域名前缀？

使用 docker tag 命令为镜像打上新标签，去掉域名前缀，使镜像名称更简洁。

查看全部问题→

用户好评

来自真实用户的反馈，见证轩辕镜像的优质服务

oldzhang

运维工程师

Linux服务器

"Docker访问体验非常流畅，大镜像也能快速完成下载。"