ghcr.io/browserless/chromium:v2.38.3

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

📋 目录

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

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

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

Step 1: 运行Docker镜像

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

Step 2: 在浏览器中打开文档

访问 http://localhost:3000/docs

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

Step 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抓取、代理、无头浏览器、验证码解决）智能抓取任何URL
• /crawl API 用于异步爬取整个网站并将所有发现的页面抓取为结构化、LLM就绪数据
• /map API 用于通过站点地图和链接提取发现网站上的所有URL，并提供基于搜索的相关性排序
• /search API 用于网页搜索，并可选择将每个结果页面抓取为结构化格式（Markdown、HTML、链接或截图）
• MCP Server 用于将AI助手（Claude Desktop、Cursor、VS Code、Windsurf）直接连接到Browserless浏览器自动化
• Webhook集成 用于队列警报、拒绝、超时、错误和健康故障通知

🚢 可定制的部署选项

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

🔓 开源版（自托管）

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

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

↓ 快速开始（见上文）

🏢 企业Docker版（自托管）

包含完整企业特性的自托管容器。

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

→ 了解更多

☁️ 云服务（自助式）

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

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

→ 免费开始

🔒 私有部署

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

最适合： 大规模企业部署

→ 联系销售

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

💡 为什么选择Browserless？

在云端或CI中运行Chrome很麻烦。

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

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

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

📜 许可信息

SPDX-License-Identifier: SSPL-1.0 OR Browserless Commercial License.

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

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

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

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

祝您开发愉快！

需要帮助？请通过 ******* 联系我们。