# @browserless\.io/browserless 中文文档 规范地址：https://npmcn.com/package/%40browserless.io/browserless/ 版本：2\.60\.0 npm 元数据更新时间：2026-11-06T15:42:16.604Z 中文译文更新时间：2026-11-08T16:28:51.787Z 软件包许可：SSPL 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40browserless.io/browserless 原文对照：https://npmcn.com/package/%40browserless.io/browserless/?lang=original 项目主页：https://github.com/browserless/browserless#readme 源码仓库：https://github.com/browserless/browserless ## 关键信息（来自 npm 元数据） - 包体积（解压后）：148 MB，2639 个文件 - 模块格式：ES Module - TypeScript 类型：包内自带 - Node.js 要求：\>=24 - 运行依赖：21 个 - 首次发布：2023-12-18T22:30:06.376Z - 最新版本发布：2026-11-06T15:42:16.176Z - 近 30 天下载量：12874（2026-10-09 至 2026-11-07，npm 官方下载统计） - 已发布版本数：174（近 12 个月 52 个） ## 中文简介 无浏览器平台 ## 安装 ```sh npm install @browserless.io/browserless ``` 也可以使用：`pnpm add @browserless.io/browserless`、`yarn add @browserless.io/browserless`、`bun add @browserless.io/browserless` ## README [![Browserless logo](https://npmcn.com/package/%40browserless.io/browserless/assets/logo.svg)](https://browserless.io/?utm_source=github&utm_medium=referral&utm_campaign=oss-readme&utm_content=top-banner) ### 在多克部署无头浏览器. 逃出我们的云或带来你自己. [![Try on Cloud](https://img.shields.io/badge/%F0%9F%A7%AA_Try_on_Cloud-4A90E2?style=for-the-badge)](https://browserless.io/?utm_source=github&utm_medium=referral&utm_campaign=oss-readme&utm_content=try-on-cloud)   [![Run Locally](https://img.shields.io/badge/%F0%9F%93%A6_Run_Locally-34A853?style=for-the-badge) ](https://npmcn.com/package/%40browserless.io/browserless/#readme--get-started-in-seconds)   [![Developer Docs](https://img.shields.io/badge/%F0%9F%93%98_Dev_Docs-5C6AC4?style=for-the-badge)](https://docs.browserless.io/?utm_source=github&utm_medium=referral&utm_campaign=oss-readme&utm_content=dev-docs) [![browserless%2Fbrowserless | Trendshift](https://trendshift.io/api/badge/repositories/4378)](https://trendshift.io/repositories/4378) [![Docker pulls](https://img.shields.io/endpoint?url=https://browserless-docker-pulls.netlify.app/pulls&style=flat-square)](https://hub.docker.com/r/browserless/chrome)[![GitHub stars](https://img.shields.io/github/stars/browserless/browserless?style=flat-square) ](https://github.com/browserless/browserless)[![Version](https://img.shields.io/github/package-json/v/browserless/chrome?style=flat-square) ](https://github.com/browserless/browserless/tags)[![Status](https://img.shields.io/badge/Status-Operational-success?style=flat-square)](https://status.browserless.io/) ## 目录 - [以秒数开始](https://npmcn.com/package/%40browserless.io/browserless/#readme--get-started-in-seconds) - [特征](https://npmcn.com/package/%40browserless.io/browserless/#readme--features) - [自定义部署选项](https://npmcn.com/package/%40browserless.io/browserless/#readme--customisable-deployment-options) - [为什么是无浏览器 ?](https://npmcn.com/package/%40browserless.io/browserless/#readme--why-browserless) - [许可证发放](https://npmcn.com/package/%40browserless.io/browserless/#readme--licensing) ## 开始第二! 站起跑出三个简单的步骤: ### 第1步: 运行 Docker 图像 ```bash docker run -p 3000:3000 ghcr.io/browserless/chromium ``` ### 第2步:在浏览器中打开文件 访问http://localhost:30/docs **\- 成功! - 成功吗!** 您的浏览器服务正在直播 `ws://localhost:3000` ### 步骤 3: 将脚本与 Puppeteer 或 Playwright 连接 **📘 ppe ppe** ```js 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 剧作家示例** ```js 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相容性有限 ### 高分特性 我们 [自助服务云和企业提供](https://www.browserless.io/pricing/?utm_source=github&utm_medium=referral&utm_campaign=oss-readme&utm_content=features) 包括所有一般功能外加额外功能,例如: - **[浏览器QL](https://www.browserless.io/feature/browserql?utm_source=github&utm_medium=referral&utm_campaign=oss-readme&utm_content=features)** 避免探测器和解开相机 - **[混合自动化](https://docs.browserless.io/baas/interactive-browser-sessions/hybrid-automation?utm_source=github&utm_medium=referral&utm_campaign=oss-readme&utm_content=features)** 用于在脚本中流出实时浏览器会话 - **[常务会议](https://docs.browserless.io/baas/session-management/persisting-state?utm_source=github&utm_medium=referral&utm_campaign=oss-readme&utm_content=features)** 用于持续浏览器状态(cookies,缓存,localStorage)的多个会话,可配置数据保存时间可长达90天 - **[会话重放](https://docs.browserless.io/baas/interactive-browser-sessions/session-replay?utm_source=github&utm_medium=referral&utm_campaign=oss-readme&utm_content=features)** 用于记录和调试浏览器会话以及事件捕获和视频回放 - **[Chrome 扩展支持](https://docs.browserless.io/baas/features/browser-extensions?utm_source=github&utm_medium=referral&utm_campaign=oss-readme&utm_content=features)** 用于装入自定义扩展,包括广告阻塞器、 captcha 解析器等. - **[高级 Captcha/ Stealth 路由](https://docs.browserless.io/browserql/bot-detection/overview?utm_source=github&utm_medium=referral&utm_campaign=oss-readme&utm_content=features)** 用于加强带有Captcha解析、指纹随机化和住宅代理旋转的反检测 - **[REST APIs 软件](https://www.browserless.io/feature/rest-apis?utm_source=github&utm_medium=referral&utm_campaign=oss-readme&utm_content=features)** 用于检索 HTML 、 PDF 或 Screenshot 等任务. - **[内建住宅代理](https://www.browserless.io/blog/residential-proxying/?utm_source=github&utm_medium=referral&utm_campaign=oss-readme&utm_content=features)** 使用住宅代理网络自动IP旋转和地理目标 - **[/ smart- scrape API 软件](https://docs.browserless.io/rest-apis/smart-scrape?utm_source=github&utm_medium=referral&utm_campaign=oss-readme&utm_content=features)** 用于使用串接策略( HTTP 获取、 代理、 无头浏览器、 Captcha 解析) 智能刮取任意 URL - **[/ 爬行 API](https://docs.browserless.io/rest-apis/crawl?utm_source=github&utm_medium=referral&utm_campaign=oss-readme&utm_content=features)** 以同步地爬行整个网站,并刮去每个发现的页面,形成结构化的、LLM准备的数据 - **[地图 API](https://docs.browserless.io/rest-apis/map?utm_source=github&utm_medium=referral&utm_campaign=oss-readme&utm_content=features)** 用于在网站上通过网站映射和链接提取发现所有URL,并按搜索关联排序 - **[/搜索 API](https://docs.browserless.io/rest-apis/search?utm_source=github&utm_medium=referral&utm_campaign=oss-readme&utm_content=features)** 用于搜索网页和可选地将每个结果页面取入结构化格式(马克下、HTML、链接或截图) - **[MCP 服务器](https://docs.browserless.io/mcp/browserless-mcp-server?utm_source=github&utm_medium=referral&utm_campaign=oss-readme&utm_content=features)** 用于将 AI 助手( Claude Desktop, Cursor, VS 代码, Windsurf) 直接连接到浏览器浏览器自动化 - **[Webhook 整合](https://docs.browserless.io/enterprise/docker/webhooks?utm_source=github&utm_medium=referral&utm_campaign=oss-readme&utm_content=features)** 队列提醒、拒绝、超时、出错和健康故障 ## QQ 自定义部署选项 选择最适合您需求的部署模式 :

开放源码(自有)

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

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

上方快速启动

企业号(自控)

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

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

- 学习更多

* * 云(自助服务)

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

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

• 开始自由

* 私人部署

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

最佳服务: 大型企业部署

• 联系销售

> **想潜入更深?** 看这个 [详细指南](https://npmcn.com/package/%40browserless.io/browserless/LEARN_MORE.md) 用于高级设备,包括 Docker 配置、主机提供商、 SDK 扩展等. ## 为什么没有浏览器? **在云中运行克洛姆或CI烂.** 缺少字体 。 随机相撞. 依赖地狱. 蓝巴达极限. 你知道规矩. **无浏览器解决此问题** 通过将浏览器作为管理服务处理——本地或我们的云中——这样你就可以专注于自动化,而不是基础设施. 我们已经解决了硬件:系统包,字体库,安全补丁,缩放策略,以及CVES. 你仍然拥有你的剧本。 你还在控制你的密码 我们只是确保浏览器 运行顺利,每次都. ## 许可证发放 SPDX-License-Identifer: SSPL-1.0 OR 无浏览器商业许可证. 如果你想使用无浏览器来建立商业网站,应用程序,或者在一个连续集成的封闭源码系统中,那么就需要购买商业许可证. 这使得您可以保留您的软件专有, 同时仍然使用无浏览器 . [你可以在这里购买商业执照](https://www.browserless.io/contact?utm_source=github&utm_medium=referral&utm_campaign=oss-readme&utm_content=licensing)商业许可证授予您: - 就问题和特点提供优先支助. - 用于商业/CI目的的公共云提供商为专有系统运行和运行. - 为你自己的目的修改源(forking)的能力. - 新管理员用户界面 . 它不仅给了你经营如此关键的基础设施的许可,你还支持这个空间的进一步创新和我们为此做出贡献的能力. 如果您正在根据与服务器侧面许可证1.0相兼容的许可证创建开源应用程序,您可以根据这些条件使用浏览器 . **黑客快乐!** 需要帮忙吗? 联系我们 **[支持@ browserless.io](mailto:support@browserless.io)** ## 常见问题 ### @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 和提交记录判断。