
akorn/chromium-headless本镜像提供无头模式(Headless)的Chromium浏览器环境,专为需要浏览器渲染能力但无需图形界面的场景设计。镜像每周自动更新,确保集成最新的Chromium版本,包含安全补丁和功能更新,适合各类自动化任务。
bashdocker pull akornatskyy/chromium-headless
bashdocker run --rm akornatskyy/chromium-headless --version
bashdocker run --rm -v $(pwd):/output akornatskyy/chromium-headless \ --no-sandbox \ --headless=new \ --disable-gpu \ --screenshot=/output/screenshot.png \ https://example.com
| 参数 | 说明 |
|---|---|
--no-sandbox | 禁用沙箱模式(Docker环境中通常需要,因容器内用户权限限制) |
--headless=new | 使用最新无头模式(推荐,替代旧版--headless参数) |
--disable-gpu | 禁用GPU加速(无头模式下无需GPU,减少资源占用) |
--screenshot=<path> | 指定截图输出路径,需配合挂载卷(如-v参数)将结果导出到宿主机 |
--print-to-pdf=<path> | 导出网页为PDF文件,用法类似截图参数 |
test.js):javascriptconst puppeteer = require('puppeteer'); (async () => { const browser = await puppeteer.launch({ executablePath: '/usr/bin/chromium', args: [ '--no-sandbox', '--headless=new', '--disable-gpu' ] }); const page = await browser.newPage(); await page.goto('https://example.com'); await page.screenshot({ path: '/output/example.png' }); await browser.close(); })();
bashdocker run --rm -v $(pwd):/app -v $(pwd)/output:/output akornatskyy/chromium-headless \ node /app/test.js
--no-sandbox参数,否则可能因权限限制导致启动失败-v参数挂载宿主机目录到容器内--network=host或配置自定义网络--memory)和CPU分配(--cpus)


探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录认证访问私有仓库
无需登录使用专属域名
Kubernetes 集群配置 Containerd
K3s 轻量级 Kubernetes 镜像加速
VS Code Dev Containers 配置
Podman 容器引擎配置
HPC 科学计算容器配置
ghcr、Quay、nvcr 等镜像仓库
Harbor Proxy Repository 对接专属域名
Portainer Registries 加速拉取
Nexus3 Docker Proxy 内网缓存
需要其他帮助?请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
manifest unknown
no matching manifest(架构)
invalid tar header(解压)
TLS 证书失败
DNS 超时
410 Gone 排查
402 与流量用尽
401 认证失败
429 限流
D-Bus 凭证提示
413 与超大单层
来自真实用户的反馈,见证轩辕镜像的优质服务