ghcr.io/browserless/base:v2.29.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 fetch、代理、无头浏览器、验证码解决）
• /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。

祝您开发愉快！

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