ghcr.io/browserless/chrome:v2.45.0

在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（自托管）

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

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

→ 了解更多

☁️ 云服务（自助式）

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

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

→ 免费开始

🔒 私有部署

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

最适合： 大规模企业部署

→ 联系销售

想要深入了解？ 查看这份详细指南，了解高级内容，包括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。

祝您开发愉快！

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