在docker中运行chrome无头抓取需使用官方镜像（如browserless/chrome）或自建debian/ubuntu镜像，必加--headless=new、--no-sandbox、--disable-dev-shm-usage等参数，并通过puppeteer-core连接本地chrome二进制文件。
在 Docker 中运行 Chrome 实现无头抓取，核心是使用官方 chrome 镜像或基于 debian/ubuntu 自建镜像，配合 --headless=new、--no-sandbox、--disable-dev-shm-usage 等关键参数，并通过 Puppeteer、Playwright 或 curl + DevTools API 控制浏览器。
选择合适的基础镜像
推荐优先使用官方 Chromium 镜像（如 browserless/chrome 或 zenika/alpine-chrome），它们已预装依赖、禁用沙箱、适配无头模式。若需更高可控性，可用 debian:slim 或 ubuntu:22.04 自建：
-
browserless/chrome：轻量、开箱即用，支持按需启动/停止，适合高并发抓取 -
zenika/alpine-chrome：体积小（~150MB），但 Alpine 的 musl libc 可能与某些 JS 库兼容性略差 - 自建 Debian/Ubuntu 镜像：便于调试、集成 Node.js 和 Puppeteer，适合复杂渲染逻辑
必须添加的 Chrome 启动参数
在容器内直接运行 Chrome 时，以下参数缺一不可，否则会因权限或资源限制崩溃：
-
--headless=new：启用新版无头模式（Chrome 112+ 推荐，旧版--headless --disable-gpu已弃用） -
--no-sandbox：Docker 默认以非 root 用户运行时，沙箱无法启用，必须禁用 -
--disable-dev-shm-usage：避免 /dev/shm 空间不足导致页面崩溃（尤其在 CI 或内存受限环境） -
--remote-debugging-port=9222：启用 DevTools 协议，供 Puppeteer/Playwright 连接 -
--disable-gpu --single-process：增强稳定性（可选，部分场景下有效）
用 Puppeteer 在容器中稳定连接 Chrome
Node.js 应用需确保 Puppeteer 不下载 Chrome（避免重复安装），而是复用容器内已有的二进制文件：
- 安装 Puppeteer 时不带浏览器：
npm install puppeteer-core - 代码中指定
executablePath指向容器内 Chrome 路径（如/usr/bin/chromium或/usr/bin/google-chrome） - 连接时使用
ws://localhost:9222/devtools/browser/...或http://localhost:9222/json获取 WebSocket 地址 - 示例启动命令：
chromium --headless=new --no-sandbox --disable-dev-shm-usage --remote-debugging-port=9222 --disable-gpu
注意事项与常见问题
实际部署中容易忽略但影响稳定性的问题：
- Docker 运行时需加
--shm-size=2g（即使用了--disable-dev-shm-usage，某些版本仍依赖 shm 初始化） - 避免使用
latest标签，Chrome 版本升级可能破坏 Puppeteer 兼容性，建议锁死镜像 tag（如browserless/chrome:125.0） - 抓取含验证码、反爬 JS 的站点时，需额外注入用户代理、禁用自动化特征（
--disable-blink-features=AutomationControlled）、模拟真实行为 - 日志输出建议重定向到 stdout，方便
docker logs查看渲染异常或超时信息
