catsoss/node-headless-chrome

docker-node-headless-chrome

Chrome Headless环境的Docker镜像

本镜像基于https://hub.docker.com/_/node/%E6%9E%84%E5%BB%BA%EF%BC%8C%E6%8F%90%E4%BE%9B%E7%A8%B3%E5%AE%9A%E7%9A%84Chrome Headless运行环境，支持https://github.com/GoogleChrome/puppeteer/blob/master/docs/troubleshooting.md%E4%B8%AD%E7%9A%84%E5%9C%BA%E6%99%AF%EF%BC%8C%E4%B8%94%E5%86%85%E7%BD%AE%E6%97%A5%E6%96%87%E5%AD%97%E4%BD%93%E6%94%AF%E6%8C%81%E3%80%82

核心功能

• 基于官方Node镜像，确保环境兼容性与稳定性
• 集成Chrome Headless，实现无界面网页操作
• 兼容Puppeteer的故障排查方案
• 内置日文字体，可处理日文网页内容

使用场景

• 网页自动化测试（UI测试、功能验证等）
• 批量或单页网页截图生成
• 合法范围内的网页数据抓取与分析
• 无界面环境下的JavaScript代码执行与调试

配置说明

默认配置已满足基础使用需求，如需自定义Chrome运行参数，可在启动容器时通过命令行传递。例如，添加--no-sandbox参数（适用于部分受限环境）：

bash
docker run -it --rm catsoss/node-headless-chrome chrome --no-sandbox

更多配置可参考https://github.com/GoogleChrome/puppeteer%E3%80%82

部署示例

Docker Run命令

直接启动容器：

bash
docker run -it --rm catsoss/node-headless-chrome

挂载本地脚本并运行（以Puppeteer脚本为例）：

bash
docker run -v $(pwd)/scripts:/app -w /app catsoss/node-headless-chrome node your-puppeteer-script.js

Docker Compose示例

yaml
version: '3'
services:
  chrome-headless:
    image: catsoss/node-headless-chrome
    volumes:
      - ./scripts:/app  # 挂载本地脚本目录
    working_dir: /app
    command: node your-puppeteer-script.js  # 运行指定脚本

License

MIT © Cyberagent, Inc