browserautos/browser-autos

browser.autos

官方Docker镜像: browserautos/browser-autos

基于Playwright Chromium的生产级浏览器自动化API，提供截图、PDF生成、内容提取、网页抓取等REST API及WebSocket CDP代理服务。

https://img.shields.io/github/stars/browser-autos/browser-autos?style=social](https://github.com/browser-autos/browser-autos)

---

快速开始

bash
docker run -d \
  --name browser-autos \
  -p 3001:3001 \
  -e JWT_SECRET=your-secret-key \
  -e DEFAULT_ADMIN_USERNAME=browserautos \
  -e DEFAULT_ADMIN_PASSWORD=browser.autos \
  --shm-size=2gb \
  --memory=4g \
  browserautos/browser-autos:latest

# 测试服务
curl http://localhost:3001/health

# 查看日志获取默认凭据
docker logs browser-autos | grep "Default credentials"

---

核心功能

• 📸 截图API - 支持PNG、JPEG、WebP格式
• 📄 PDF生成 - 自定义页面尺寸与样式
• 🔍 内容提取 - HTML、文本及元数据
• 🕷️ 网页抓取 - 基于CSS选择器
• 🔌 WebSocket CDP - 直接集成Puppeteer/Playwright
• ⚡ 浏览器池 - 自动复用提升85%效率
• 🔒 认证机制 - JWT令牌与API密钥
• 📊 监控能力 - 内置Prometheus指标

---

REST API示例

注意: 所有API端点均需认证，需先登录获取访问令牌。

1. 认证登录

bash
# 登录获取访问令牌
TOKEN=$(curl -s -X POST http://localhost:3001/auth/login \
  -H "Content-Type: application/json" \
  -d '{"username": "browserautos", "password": "browser.autos"}' \
  | jq -r '.data.accessToken')

echo "令牌: $TOKEN"

2. 生成截图

bash
curl -X POST http://localhost:3001/screenshot \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com", "fullPage": true}' \
  -o screenshot.png

3. 生成PDF

bash
curl -X POST http://localhost:3001/pdf \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com", "format": "A4"}' \
  -o document.pdf

4. 网页抓取

bash
curl -X POST http://localhost:3001/scrape \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com",
    "elements": [
      {"selector": "h1", "property": "textContent"},
      {"selector": ".price", "property": "textContent"}
    ]
  }'

5. 内容提取

bash
curl -X POST http://localhost:3001/content \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com", "includeMetadata": true}'

无认证测试（不推荐生产环境）：

bash
# 启动容器时禁用认证
docker run -d \
  --name browser-autos \
  -p 3001:3001 \
  -e JWT_SECRET=your-secret \
  -e REQUIRE_AUTH=false \
  --shm-size=2gb \
  browserautos/browser-autos:latest

---

集成示例

注意: WebSocket连接同样需要认证，需将令牌作为URL参数传递。

Puppeteer集成

javascript
const puppeteer = require('puppeteer-core');
const axios = require('axios');

// 获取访问令牌
const { data } = await axios.post('http://localhost:3001/auth/login', {
  username: 'browserautos',
  password: 'browser.autos'
});
const token = data.data.accessToken;

// 使用令牌连接
const browser = await puppeteer.connect({
  browserWSEndpoint: `ws://localhost:3001/ws?token=${token}`
});

const page = await browser.newPage();
await page.goto('https://example.com');
await browser.close();

Playwright集成

javascript
const { chromium } = require('playwright');
const axios = require('axios');

// 获取访问令牌
const { data } = await axios.post('http://localhost:3001/auth/login', {
  username: 'browserautos',
  password: 'browser.autos'
});
const token = data.data.accessToken;

// 使用令牌连接
const browser = await chromium.connect({
  wsEndpoint: `ws://localhost:3001/ws?token=${token}`
});

const page = await browser.newPage();
await page.goto('https://example.com');
await browser.close();

---

认证机制

默认用户：

• 管理员: browserautos / browser.autos
• API用户: api-user / browser.autos

获取访问令牌：

bash
curl -X POST http://localhost:3001/auth/login \
  -H "Content-Type: application/json" \
  -d '{"username": "browserautos", "password": "browser.autos"}'

使用令牌：

bash
# JWT方式
curl -H "Authorization: Bearer YOUR_TOKEN" http://localhost:3001/screenshot

# API密钥方式
curl -H "X-API-Key: YOUR_KEY" http://localhost:3001/screenshot

---

Docker Compose配置

yaml
version: '3.8'

services:
  browser-autos:
    image: browserautos/browser-autos:latest
    ports:
      - "3001:3001"
    environment:
      - JWT_SECRET=your-secret-key
      - ENABLE_QUEUE=false
    shm_size: '2gb'
    mem_limit: 4g
    restart: unless-stopped

  redis:
    image: redis:7-alpine
    volumes:
      - redis-data:/data

volumes:
  redis-data:

---

配置说明

必填环境变量：

bash
JWT_SECRET=your-secret-key    # 认证必填

可选配置：

bash
# 队列系统
ENABLE_QUEUE=false
REDIS_URL=redis://redis:6379

# 浏览器池
BROWSER_POOL_MIN=2
BROWSER_POOL_MAX=10

# 日志
LOG_LEVEL=info

资源要求：

|| 最低要求 | 推荐配置 | |---|---------|-------------| | 内存 | 2GB | 4GB | | CPU | 1核 | 2核 | | 共享内存 | 2GB（必填） | 2GB |

重要提示： 为保证Chromium稳定运行，务必设置--shm-size=2gb

---

可用版本

browser.autos提供多种标签满足不同场景：

多架构支持：

• ✅ linux/amd64 - Intel/AMD
• ✅ linux/arm64 - Apple Silicon、AWS Graviton、Azure ARM

bash
# 拉取特定版本
docker pull browserautos/browser-autos:latest
docker pull browserautos/browser-autos:1.0.0
docker pull browserautos/browser-autos:debian

---

API端点

---

性能表现

测试环境：4 vCPU，8GB RAM

---

使用场景

browser.autos支持多种自动化工作流：

• 🧪 CI/CD测试 - 视觉回归测试
• 📝 报告生成 - 批量HTML转PDF
• 👀 网页监控 - 内容变更追踪
• 📊 数据采集 - 高效网页抓取
• ✅ 端到端测试 - 全浏览器自动化
• 🖼️ 缩略图生成 - 批量截图
• 🔍 SEO审计 - 页面分析与爬取

---

故障排除

Chromium无法启动：

bash
# 确保设置共享内存
docker run --shm-size=2gb browserautos/browser-autos:latest

内存不足：

bash
# 增加内存限制
docker run --memory=4g browserautos/browser-autos:latest

查看日志：

bash
docker logs browser-autos
docker logs -f browser-autos  # 实时跟踪

认证错误：

bash
# 测试时禁用认证（不推荐生产环境）
docker run -e REQUIRE_AUTH=false browserautos/browser-autos:latest

---

技术栈

• 运行时： Node.js 20 + TypeScript
• 框架： Fastify
• 浏览器： Playwright Chromium 141.0.7390.37
• 队列： Bull + Redis（可选）
• 监控： Prometheus
• 基础镜像： Debian Bookworm Slim

---

安全特性

• 非root用户执行（UID 1001）
• JWT + API密钥认证
• 速率限制
• CORS保护
• 资源限制
• 定期安全更新

---

更新与版本管理

browser.autos遵循语义化版本：

• Chromium： 每1-2周通过Playwright更新
• 安全补丁： 48小时内修复关键漏洞
• 版本标签： 所有发布均打标签（1.0.0、1.1.0等）
• Latest： 始终指向最新稳定版

查看版本：

bash
docker run --rm browserautos/browser-autos:latest \
  node -e "console.log(require('./package.json').version)"

---

支持与链接

• 🌐 官网： [***]
• 📁 GitHub： https://github.com/browser-autos/browser-autos
• 🐛 问题反馈： https://github.com/browser-autos/browser-autos/issues
• 📖 文档： https://github.com/browser-autos/browser-autos

---

关于browser.autos

browser.autos是面向开发者、测试人员和企业的开源浏览器自动化平台。

核心优势：

• 🎯 生产级就绪且经过实战验证
• 🚀 浏览器池优化提升性能
• 🔒 默认安全配置
• 📊 Prometheus可观测性
• 🌍 多平台支持
• 📦 部署简单

---

由browser.autos团队维护

镜像： browserautos/browser-autos (稳定版) 版本： 1.0.0 Chromium： 141.0.7390.37（Playwright） 更新时间： 2025-10-11

⭐ 欢迎在https://github.com/browser-autos/browser-autos%E4%B8%8A%E7%82%B9%E8%B5%9E%E6%94%AF%E6%8C%81%EF%BC%81

---

MIT许可证 - 商业使用免费