agent-browser 三大引擎横评:Chrome、Lightpanda 与 Obscura 该怎么选
agent-browser 三大引擎横评:Chrome、Lightpanda 与 Obscura 该怎么选
agent-browser 是一款面向 AI agent 的浏览器自动化 CLI 工具:打开网页、读取可访问性树、按元素引用执行点击和填表等操作。它内置三大浏览器引擎——Chrome、Lightpanda 与 Obscura,通过 --engine 参数即可切换。本文带你快速搞懂三者的差异、适用场景和选择方法。
为什么一个 CLI 要带三个引擎?
agent-browser 用统一的 Chrome DevTools Protocol(CDP)驱动所有引擎:无论底层是哪一个,snapshot、click、fill、screenshot 等命令都走同一条协议路径,命令行为保持一致。
换而言之,切换引擎不需要改任何自动化脚本,只需一个启动参数。这正是三引擎设计的价值所在——用同一个接口,在不同场景下换不同的"发动机"。
- 🎯 Chrome:追求功能完整和真实度
- ⚡ Lightpanda:追求速度和低内存
- 🕵️ Obscura:追求轻量、单文件、可选隐身指纹
三大引擎速览表
| 维度 | Chrome(默认) | Lightpanda | Obscura |
|---|---|---|---|
| 开发语言 | C++(Chromium) | Zig | Rust(内置 V8) |
| 是否默认引擎 | ✅ 是 | ❌ 需 --engine lightpanda |
❌ 需 --engine obscura |
| 安装方式 | agent-browser install 自动下载 Chrome for Testing |
需自行下载二进制并放入 PATH | 需自行下载二进制并放入 PATH |
| 启动速度 | 正常 | 官方宣称 10 倍快 | 单文件自包含,启动轻快 |
| 内存占用 | 正常 | 官方宣称约为 Chrome 的 1/10 | 低 |
| 浏览器扩展 / 持久化 Profile | ✅ 支持 | ❌ 不支持 | ❌ 不支持 |
存储状态(--state) |
✅ 支持 | ❌ 不支持 | ❌ 不支持 |
有头模式(--headed 可见窗口) |
✅ 支持 | ❌ 仅无头 | ❌ 仅无头 |
| 隐身指纹模式 | — | — | ✅ 可选开启 |
| 成熟度 | 生产级 | 面向机器的无头引擎 | 实验性(experimental) |
Chrome 引擎:默认之选,功能最全
Chrome(含 Chromium)是 agent-browser 的默认引擎,无需任何 --engine 参数:
agent-browser open example.com
它自动按平台搜索本机 Chrome 路径;找不到时执行 agent-browser install 即可从 Chrome for Testing 下载。Chrome 独有的功能包括:
- 浏览器扩展(
--extension <path>) - 持久化用户目录(
--profile <path>) - 登录态保存与复用(
--state <path>) - 文件 URL 访问、自定义启动参数(
--args) - 有头模式,可肉眼观察浏览器行为(
--headed)
在 Docker、CI 等容器环境中,agent-browser 检测到沙箱后会自动加上 --no-sandbox,开箱即用。
👉 适合场景:需要完整浏览器保真度、扩展、登录态持久化的工作流——例如带账号体系的自动化测试、需要扩展的抓取任务。
Lightpanda 引擎:为机器而生的速度怪兽
Lightpanda 是一个从零用 Zig 编写的无头浏览器引擎,官方定位是"为机器(machines)设计":启动瞬间完成、内存占用约为 Chrome 的 1/10、执行速度提升 10 倍。
使用方式:先下载 lightpanda 二进制并放入 PATH(macOS Apple Silicon 与 Linux x86_64 各有下载命令),然后:
agent-browser --engine lightpanda open example.com
agent-browser --engine lightpanda snapshot
它同样支持通过 --executable-path 指定二进制路径。需要注意:扩展、持久化 Profile、--state、文件访问等 Chrome 专属功能均不可用,若误用不兼容参数,agent-browser 会给出明确报错。
👉 适合场景:高速爬虫与数据抽取、对速度和内存敏感的 AI agent 工作流、资源受限的 CI/CD 环境、大规模并行自动化。
Obscura 引擎:实验性新贵,自带隐身模式
Obscura 是用 Rust 编写的无头引擎,通过 V8 执行真实 JavaScript,同样讲 CDP 协议,面向抓取和 AI agent 自动化。与 Lightpanda 不同,它还有一个亮点——可选的 stealth 隐身模式:提供隐私优先、一致化的浏览器指纹并拦截已知追踪器:
AGENT_BROWSER_OBSCURA_STEALTH=1 agent-browser --engine obscura open example.com
⚠️ 但必须清楚它的实验性身份:官方文档明确指出,Obscura 目前存在可访问性命名、隐藏元素、iframe 与截图保真度方面的差距,CDP 连接成功并不等于与 Chrome 功能对等。若你的任务依赖这些特性,请继续用 Chrome。另外它不支持 WebGPU、自定义 CA 证书、Chrome 启动参数和代理绕过,本地开发页面还需额外设置 OBSCURA_ALLOW_PRIVATE_NETWORK=1。
👉 适合场景:需要真实 JS 执行的轻量抓取、希望单个自包含二进制进 CI、隐私优先的一致化指纹(配合 stealth 模式)。正式投产前建议先在目标页面上充分验证。
一张图看懂 agent-browser 会话录制
下图展示了 agent-browser 在 Dashboard 中对浏览器会话进行录屏时生成的"分镜"效果——每一格都是带时间戳的页面帧,方便回放与核对自动化流程(该能力在 Chrome 引擎下体验最完整):
切换引擎的三种方式
选定引擎后,有三种等价的启用方式:
1. 命令行参数(临时使用)
agent-browser --engine lightpanda open example.com
agent-browser --engine obscura snapshot
2. 环境变量(当前 shell 会话默认)
export AGENT_BROWSER_ENGINE=lightpanda
agent-browser open example.com
3. 配置文件(永久默认)
在 ~/.agent-browser/config.json 或 --config 指定的文件中写入:
{
"engine": "lightpanda"
}
💡 小提示:切换引擎的启动设置后,需要关闭并重新打开会话才能生效。
最终选择建议:一分钟决策指南
- ✅ 默认/正式业务、需要登录态和扩展 → Chrome(不写参数即可,功能最全、最稳定)
- ✅ 批量爬虫、资源受限的 CI、追求极致速度 → Lightpanda
- ✅ 想要单文件轻量引擎、真实 JS 执行、可选隐身指纹 → Obscura(先小范围验证,实验性)
- ✅ 依赖截图保真、iframe、可访问性树等细节功能 → 目前只有 Chrome 最稳妥
一句话总结:Chrome 求稳,Lightpanda 求快,Obscura 求轻。三者共享同一套 CLI 命令,切换成本几乎为零,建议先以 Chrome 跑通流程,再按场景替换引擎做压测对比。
延伸阅读
- Chrome 引擎文档:docs/content/docs/engines/chrome.mdx
- Lightpanda 引擎文档:docs/content/docs/engines/lightpanda.mdx
- Obscura 引擎文档:docs/content/docs/engines/obscura.mdx
- 引擎进程管理源码(CDP 适配层):cli/src/native/cdp/mod.rs、cli/src/native/cdp/lightpanda.rs、cli/src/native/cdp/obscura.rs
