ghcr.io/browserless/multi:v2.31.1

在 Docker 中部署无头浏览器。可运行于我们的云服务或自行托管。

📋 目录

• 快速开始（秒级部署）
• 功能特性
• 可定制的部署选项
• 为什么选择 Browserless？
• 许可协议

🚀 快速开始（秒级部署）！

通过三个简单步骤即可启动运行：

步骤 1：运行 Docker 镜像

docker run -p 3000:3000 ghcr.io/browserless/chromium

步骤 2：在浏览器中打开文档

访问 http://localhost:3000/docs

✅ 成功！ 浏览器服务已在 ws://localhost:3000 启动

步骤 3：使用 Puppeteer 或 Playwright 连接脚本

📘 Puppeteer 示例

import puppeteer from 'puppeteer-core';

const browser = await puppeteer.connect({
  browserWSEndpoint: 'ws://localhost:3000',
});

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

🎭 Playwright 示例

import pw from 'playwright-core';

const browser = await pw.firefox.connect(
  'ws://localhost:3000/firefox/playwright'
);

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

[!NOTE] 如需支持 Firefox/Webkit，请使用 ghcr.io/browserless/firefox 或 ghcr.io/browserless/multi 镜像。

输出：

Example Domain

✨ 功能特性

通用功能

• 并行处理与队列管理 — 支持多会话处理，可配置并发限制
• 调试查看器 — 实时查看和调试运行中的浏览器会话
• 原生库支持 — 与标准 Puppeteer 和 Playwright 无缝集成
• 字体与表情符号 — 开箱即支持所有系统字体和表情符号
• 可配置超时 — 设置会话计时器和健康检查，确保稳定运行
• 容错能力 — 即使 Chrome 崩溃，Browserless 也能保持稳定
• ARM64 架构支持 — 全面支持 ARM64 平台（包括 Apple Silicon）；部分浏览器（Edge、Chrome）的 ARM64 兼容性有限

高级功能

我们的 自助云服务和企业版方案 包含所有通用功能及以下额外特性：

• BrowserQL — 用于规避检测器和解决验证码
• 混合自动化 — 脚本执行期间流式传输实时浏览器会话
• 持久会话 — 跨多个会话持久化浏览器状态（Cookie、缓存、localStorage），数据保留期可配置（最长 90 天）
• 会话回放 — 记录和调试浏览器会话，支持事件捕获和视频回放
• Chrome 扩展支持 — 加载自定义扩展（如广告拦截器、验证码解决工具等）
• 高级验证码/隐匿路由 — 增强反检测能力，支持验证码解决、指纹随机化和住宅代理轮换
• REST APIs — 用于获取 HTML、PDF 或截图等任务
• 内置住宅代理 — 自动 IP 轮换和地理定位，集成住宅代理网络
• /smart-scrape API — 智能抓取任何 URL，采用级联策略（HTTP 抓取、代理、无头浏览器、验证码解决）
• /crawl API — 异步爬取整个网站，将所有发现的页面抓取为结构化、LLM 就绪数据
• /map API — 通过站点地图和链接提取发现网站上的所有 URL，支持基于搜索的相关性排序
• /search API — 搜索网页并可选地将每个结果页面抓取为结构化格式（Markdown、HTML、链接或截图）
• MCP Server — 将 AI 助手（Claude Desktop、Cursor、VS Code、Windsurf）直接连接到 Browserless 浏览器自动化
• Webhook 集成 — 用于队列警报、拒绝、超时、错误和健康故障通知

🚢 可定制的部署选项

选择最适合您需求的部署模式：

🔓 开源版（自托管）

免费、自托管解决方案，提供核心浏览器自动化功能。

最适合： 测试、开发和小型项目

↓ 快速开始（见上文）

🏢 企业版 Docker（自托管）

自托管容器中提供完整企业级功能。

最适合： 需要数据主权的生产工作负载

→ 了解更多

☁️ 云服务（自助式）

完全托管的按使用付费服务，支持自动扩展。

最适合： 快速启动和快速原型开发

→ 免费开始

🔒 私有部署

跨主要云提供商的定制企业基础设施。

最适合： 大规模企业部署

→ 联系销售

[!NOTE] 想要深入了解？查看此 详细指南，了解高级内容，包括 Docker 配置、托管提供商、SDK 扩展等。

💡 为什么选择 Browserless？

在云端或 CI 环境中运行 Chrome 体验糟糕。

缺少字体、随机崩溃、依赖地狱、Lambda 限制——这些问题您肯定遇到过。

Browserless 解决了这些问题，将浏览器作为托管服务（本地或云端）处理，让您可以专注于自动化而非基础设施。我们已处理所有难题：系统包、字体库、安全补丁、扩展策略和 CVE 修复。

您仍然拥有脚本所有权，仍然控制代码。我们只是确保浏览器每次都能平稳运行。

📜 许可协议

SPDX 许可证标识符：SSPL-1.0 OR Browserless Commercial License。

如果您想使用 Browserless 构建商业网站、应用程序，或在闭源的持续集成系统中使用，则需要购买商业许可证。这允许您在使用 Browserless 的同时保持软件的专有性。您可以在此处购买商业许可证。商业许可证授予您：

• 问题和功能的优先支持
• 本地部署以及在公共云提供商上用于商业/CI 目的（针对专有系统）
• 修改源代码（分叉）的能力（用于您自己的目的）
• 全新的管理员用户界面

商业许可证不仅授予您运行这一关键基础设施的权利，还支持我们在该领域的进一步创新和贡献能力。

如果您正在创建符合 Server Side License 1.0 的开源应用程序，则可以根据这些条款使用 Browserless。

祝您开发顺利！

需要帮助？请联系我们：*******