@browserless.io/browserless

中文文档
2.60.0发布于 2026/11/06SSPLTypeScriptES Module构建来源已验证近 30 天下载 1.3万

无浏览器平台

中文使用文档
文档目录17 节
  1. 在多克部署无头浏览器. 逃出我们的云或带来你自己.
  2. 目录
  3. 开始第二!
  4. 第1步: 运行 Docker 图像
  5. 第2步:在浏览器中打开文件
  6. 步骤 3: 将脚本与 Puppeteer 或 Playwright 连接
  7. 输出 :
  8. * 特性
  9. 一般特征
  10. 高分特性
  11. QQ 自定义部署选项
  12. 开放源码(自有)
  13. 企业号(自控)
  14. * * 云(自助服务)
  15. * 私人部署
  16. 为什么没有浏览器?
  17. 许可证发放
Browserless logo

在多克部署无头浏览器. 逃出我们的云或带来你自己.

Try on Cloud    Run Locally    Developer Docs

browserless%2Fbrowserless | Trendshift

Docker pulls GitHub stars Version Status


目录

开始第二!

站起跑出三个简单的步骤:

第1步: 运行 Docker 图像

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

第2步:在浏览器中打开文件

访问http://localhost:30/docs

- 成功! - 成功吗! 您的浏览器服务正在直播 ws://localhost:3000

步骤 3: 将脚本与 Puppeteer 或 Playwright 连接

📘 ppe ppe
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();
QQ 剧作家示例
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();

说明: 使用 ghcr.io/browserless/firefox 或者说 ghcr.io/browserless/multi 用于Firefox/Webkit支持.


输出 :

Example Domain

* 特性

一般特征

  • 并行和排队 - 处理多个具有可配置货币限额的会议
  • 除错查看器 ——实时积极查看并调试运行浏览器会话
  • 未创建的库 - 与标准的Puppeteer和Playwright无缝工作
  • 字体和 emoji ——所有系统字体和emoji支持外出
  • 可配置的超时 设置会话计时器和健康检查,使事情顺利进行
  • 容忍错误 - 如果Chrome崩溃,无浏览器不会
  • ARM64 架构支持 ——全力支持包括苹果硅在内的ARM64平台;有的浏览器(Edge,Chrome)的ARM64相容性有限

高分特性

我们 自助服务云和企业提供 包括所有一般功能外加额外功能,例如:

  • 浏览器QL 避免探测器和解开相机
  • 混合自动化 用于在脚本中流出实时浏览器会话
  • 常务会议 用于持续浏览器状态(cookies,缓存,localStorage)的多个会话,可配置数据保存时间可长达90天
  • 会话重放 用于记录和调试浏览器会话以及事件捕获和视频回放
  • Chrome 扩展支持 用于装入自定义扩展,包括广告阻塞器、 captcha 解析器等.
  • 高级 Captcha/ Stealth 路由 用于加强带有Captcha解析、指纹随机化和住宅代理旋转的反检测
  • REST APIs 软件 用于检索 HTML 、 PDF 或 Screenshot 等任务.
  • 内建住宅代理 使用住宅代理网络自动IP旋转和地理目标
  • / smart- scrape API 软件 用于使用串接策略( HTTP 获取、 代理、 无头浏览器、 Captcha 解析) 智能刮取任意 URL
  • / 爬行 API 以同步地爬行整个网站,并刮去每个发现的页面,形成结构化的、LLM准备的数据
  • 地图 API 用于在网站上通过网站映射和链接提取发现所有URL,并按搜索关联排序
  • /搜索 API 用于搜索网页和可选地将每个结果页面取入结构化格式(马克下、HTML、链接或截图)
  • MCP 服务器 用于将 AI 助手( Claude Desktop, Cursor, VS 代码, Windsurf) 直接连接到浏览器浏览器自动化
  • Webhook 整合 队列提醒、拒绝、超时、出错和健康故障

QQ 自定义部署选项

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

开放源码(自有)

具有核心浏览器自动化能力的自由自备解决方案.

最佳服务: 测试、开发和小型项目

上方快速启动

企业号(自控)

企业部在自装货箱中具有完整的功能.

最佳服务: 需要数据主权的生产工作量

- 学习更多

* * 云(自助服务)

完全管理,以自动缩放方式提供现收现付服务.

最佳服务: 快速启动和快速原型

• 开始自由

* 私人部署

跨越主要云层提供者的定制企业基础设施.

最佳服务: 大型企业部署

• 联系销售

想潜入更深? 看这个 详细指南 用于高级设备,包括 Docker 配置、主机提供商、 SDK 扩展等.

为什么没有浏览器?

在云中运行克洛姆或CI烂.

缺少字体 。 随机相撞. 依赖地狱. 蓝巴达极限. 你知道规矩.

无浏览器解决此问题 通过将浏览器作为管理服务处理——本地或我们的云中——这样你就可以专注于自动化,而不是基础设施. 我们已经解决了硬件:系统包,字体库,安全补丁,缩放策略,以及CVES.

你仍然拥有你的剧本。 你还在控制你的密码 我们只是确保浏览器 运行顺利,每次都.

许可证发放

SPDX-License-Identifer: SSPL-1.0 OR 无浏览器商业许可证.

如果你想使用无浏览器来建立商业网站,应用程序,或者在一个连续集成的封闭源码系统中,那么就需要购买商业许可证. 这使得您可以保留您的软件专有, 同时仍然使用无浏览器 . 你可以在这里购买商业执照商业许可证授予您:

  • 就问题和特点提供优先支助.
  • 用于商业/CI目的的公共云提供商为专有系统运行和运行.
  • 为你自己的目的修改源(forking)的能力.
  • 新管理员用户界面 .

它不仅给了你经营如此关键的基础设施的许可,你还支持这个空间的进一步创新和我们为此做出贡献的能力.

如果您正在根据与服务器侧面许可证1.0相兼容的许可证创建开源应用程序,您可以根据这些条件使用浏览器 .

黑客快乐!

需要帮忙吗? 联系我们 支持@ browserless.io

版本与发布记录

@browserless.io/browserless 共发布 174 个版本,首次发布于 2023/12/19;过去 12 个月发布了 52 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
2.60.0latest2026/11/062 天前
2.59.02026/11/044 天前
2.58.32026/11/035 天前
2.58.22026/11/026 天前
2.58.12026/10/309 天前
2.58.02026/10/2910 天前

其他发布通道:beta → 2.39.0-beta-1。

关于 @browserless.io/browserless 的常见问题

@browserless.io/browserless 是什么?

无浏览器平台

如何安装 @browserless.io/browserless?

在项目目录运行 npm install @browserless.io/browserless,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 browserless,可以用 npx browserless 直接运行。

@browserless.io/browserless 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@browserless.io/browserless 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@browserless.io/browserless 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=24。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@browserless.io/browserless 可以商用吗?

@browserless.io/browserless 使用 SSPL 许可。声明的许可为 SSPL,请阅读许可原文确认使用条件。以上为概括,不构成法律意见,请以许可原文为准。

@browserless.io/browserless 的下载量有多少?

根据 npm 官方下载统计,@browserless.io/browserless 在 2026/10/09 – 2026/11/07 这 30 天内被下载 12,874 次,日均约 429 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@browserless.io/browserless 还在维护吗?

最新版本 2.60.0 发布于 2026/11/06(2 天前);至今共发布 174 个版本,其中过去 12 个月发布了 52 个;首次发布于 2023/12/19。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。