browserless 引擎基础镜像文档

镜像概述

本镜像为browserless引擎的基础镜像。browserless是一个允许通过API控制无头浏览器（Headless Browser）的服务，可用于自动化网页操作、测试和内容处理。该基础镜像提供了运行browserless引擎所需的底层环境，包含预配置的无头Chrome/Chromium浏览器、必要的系统依赖及基础配置，为构建基于browserless的应用提供稳定的运行平台。

核心功能与特性

• 无头浏览器环境：内置无头Chrome/Chromium浏览器，支持标准浏览器功能（如DOM操作、JavaScript执行、网络请求等）
• 轻量级设计：优化镜像体积，仅包含核心依赖，降低资源占用
• 可配置性：支持通过环境变量自定义浏览器行为、资源限制及会话管理
• API兼容性：与browserless标准API完全兼容，可无缝对接browserless客户端库
• 稳定性保障：包含浏览器崩溃自动恢复机制，确保服务持续可用

使用场景与适用范围

适用场景

• 自动化网页测试（如前端功能测试、兼容性测试）
• 网页截图生成与PDF转换
• 基于网页内容的自动化数据抓取
• 前端性能监控与分析
• 浏览器环境下的脚本自动化执行

适用人群

• 前端开发者（自动化测试）
• 测试工程师（浏览器自动化测试）
• 数据工程师（网页数据采集）
• DevOps工程师（构建自动化工作流）

详细使用方法

镜像拉取

通过Docker Hub拉取最新版本镜像：

docker pull browserless/base:latest

基本运行命令

启动基础browserless服务（默认端口3000）：

docker run -d -p 3000:3000 --name browserless-base browserless/base:latest

环境变量配置

通过环境变量自定义服务行为，常用配置项如下：

带配置的运行示例

启动支持10个并发会话、超时时间10分钟的服务：

docker run -d \
  -p 3000:3000 \
  -e MAX_CONCURRENT_SESSIONS=10 \
  -e SESSION_TIMEOUT=600 \
  -e CHROME_FLAGS="--no-sandbox --disable-gpu" \
  --name browserless-configured \
  browserless/base:latest

Docker Compose配置示例

创建docker-compose.yml文件：

version: '3.8'
services:
  browserless:
    image: browserless/base:latest
    container_name: browserless-service
    ports:
      - "3000:3000"
    environment:
      - MAX_CONCURRENT_SESSIONS=8
      - SESSION_TIMEOUT=480
      - ENABLE_DEBUGGING=false
      - CHROME_FLAGS=--no-sandbox --disable-dev-shm-usage
    restart: unless-stopped
    resources:
      limits:
        cpus: '2'
        memory: 2G

启动服务：

docker-compose up -d

验证服务可用性

服务启动后，通过HTTP请求验证：

curl http://localhost:3000/health

返回OK表示服务正常运行。

注意事项

• 资源配置：无头浏览器对CPU和内存资源消耗较高，建议根据并发需求调整容器资源限制（如--memory=2G --cpus=2）
• 安全配置：生产环境建议禁用ENABLE_DEBUGGING，避免暴露调试接口
• 持久化：如需保存浏览器缓存或配置，可挂载本地目录至容器/home/chrome/.cache路径

版本兼容性

• 支持与browserless v1.60.0+版本客户端库兼容
• 内置Chrome版本随镜像版本更新，具体版本可通过CHROME_VERSION环境变量查询