Lightpanda Browser
SHA-256用 Zig 从零打造的无头浏览器,比 Headless Chrome 省 16 倍内存、快 9 倍,专为 AI 自动化而生。
专为 AI 设计的超轻量无头浏览器
核心功能
- 用 Zig 从零自研的浏览器引擎,不是 Chromium 套壳
- 内存占用仅为 Headless Chrome 的约十六分之一,速度快约 9 倍
- 兼容 CDP 和 WebDriver BiDi 协议,可直接对接 Puppeteer 和 Playwright
- 内置 AI Agent 模式,用自然语言即可操控浏览器,支持主流大模型和本地模型
- 原生 MCP 服务,可让 Claude 等 AI 客户端直接操作网页
避坑指南
- •没有原生 Windows 版本,Windows 用户需通过 WSL2 使用;Linux 预编译版依赖 glibc,Alpine 等 musl 系统上无法直接运行,需从源码编译;作为全新引擎,对重度依赖复杂 JavaScript 的页面兼容性可能不如真实 Chrome,关键业务上线前务必先测试目标网站;AGPL-3.0 协议有传染性,闭源商业集成前需评估合规风险。
适用场景
- AI Agent 的大规模网页浏览、点击和数据采集
- 低成本替代 Headless Chrome 运行爬虫和自动化脚本
- 通过 MCP 为大模型应用提供网页读取和操作能力
- 内存受限的服务器或容器环境下的网页自动化任务
详细介绍
Lightpanda 是一款用 Zig 语言从零编写的开源无头浏览器,专为 AI 智能体和网页自动化设计。与 Puppeteer 加 Headless Chrome、Playwright 等基于 Chromium 的方案不同,它并非浏览器套壳,而是全新实现的引擎:实测抓取真实网页时内存占用仅为 Headless Chrome 的十六分之一(123MB 对 2GB),执行速度快约 9 倍,能显著降低规模化爬虫和 AI 网页浏览的服务器成本。它完整支持 CDP 和 WebDriver BiDi 协议,现有 Puppeteer、Playwright 脚本几乎无需改动即可接入。内置 AI Agent 模式,支持用自然语言驱动浏览器,兼容 Anthropic、OpenAI、Gemini、OpenRouter 及 Ollama 本地模型,并可导出无需大模型即可回放 deterministic 脚本。原生 MCP 服务让 Claude 等 AI 客户端直接获得网页操作能力。提供 Linux、macOS 二进制和 Docker 镜像,Windows 用户可通过 WSL2 使用。采用 AGPL-3.0 协议开源。
常见问题与排障 (1)
故障排除为什么在 Lightpanda 中启用请求拦截后,fetch() 在收到 HTTP 401 响应时会以 'TypeError: fetch error' 被拒绝?
这是 Lightpanda 的一个 bug(存在于 1.0.1 和 main @3476970a 中)。当使用 Fetch.enable({handleAuthRequests: true}) 时——这正是 Puppeteer 的 page.setRequestInterception(true) 所发送的内容——即使响应中没有 WWW-Authenticate/Proxy-Authenticate 头,Lightpanda 也会将每个 401/407 响应视为 HTTP 认证质询。它会发出带有空质询(source: "", scheme: "")的 Fetch.authRequired,而当客户端以 Default 或 CancelAuth(Puppeteer 的默认行为)回复时,Lightpanda 会以 AbortAuthChallenge 中止请求,而不是将 401 传递给页面。因此,使用 cookie/session 认证并返回裸 401 的 SPA 会看到 fetch() 被拒绝。变通方法:(1) 通过原始 CDP 并设置 handleAuthRequests: false 来启用拦截——这样 http_request_auth_required 监听器永远不会被注册,传输不会被挂起,401 会到达页面。(2) 用排除 API 的 URL 模式来限定 Fetch.enable 的作用范围,例如 Fetch.enable({patterns: [{urlPattern: '*/assets/*'}], handleAuthRequests: true})——不匹配该模式的请求会绕过拦截并收到真实的 401。Chrome 在两个方面有所不同:它仅在存在真实质询头时才触发 Fetch.authRequired,并且对于 Default/CancelAuth 应答,它会取消认证流程,但仍会传递原始的 401 响应。请关注 issue #4018,跟踪使 Lightpanda 与 Chrome 对齐的修复。
标签
快速上手
安装软件
根据你的发行版安装对应的包(dpkg / rpm / AppImage)
通过 Homebrew 安装:brew install lightpanda-io/browser/lightpanda,或从 GitHub nightly 发布页下载对应平台的二进制文件
在终端运行 lightpanda version 验证安装是否成功
用 lightpanda fetch --dump html 网址 直接抓取网页内容
- 通过 Homebrew 安装:brew install lightpanda-io/browser/lightpanda,或从 GitHub nightly 发布页下载对应平台的二进制文件
- 在终端运行 lightpanda version 验证安装是否成功
- 用 lightpanda fetch --dump html 网址 直接抓取网页内容
已提供 SHA-256 校验码,下载后可自行核对文件完整性
该校验码提取自 GitHub 官方 Release 页面
SHA256 校验码
1fcca0ae7684f470780de611a56e9a8ea612d5ff21e37dbb48905ebac5b918a7该校验码提取自 GitHub Release 页面,下载后请自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件,未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
通过 Homebrew 安装的,运行 brew uninstall lightpanda 即可;手动下载的二进制文件直接删除该文件即可;Docker 用户依次执行 docker rm lightpanda 和 docker rmi lightpanda/browser 删除容器和镜像。软件不会在系统中残留其他文件。
无额外依赖
下载后即可直接使用,无需安装其他运行环境
遇到问题?查看下方 FAQ
1 FAQ