ghcr.io/browserless/base:v2.51.2

在Docker中部署无头浏览器

在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 — 使用级联策略（HTTP fetch、代理、无头浏览器、验证码解决）智能抓取任何URL
• /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 或 Browserless 商业许可。

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

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

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

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

祝您开发愉快！

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