browser

为 AI 打造的极速无头浏览器，让网页自动化更轻更快。

Lightpanda 是一个专为 AI 和自动化场景设计的无头浏览器，使用 Zig 语言编写，主打轻量和高性能。它解决了传统无头浏览器（如 Chromium）资源占用高、启动慢的问题，为 AI 代理、网页抓取和自动化测试提供更高效的浏览器内核。核心能力包括支持 CDP（Chrome DevTools Protocol），可无缝对接 Playwright 和 Puppeteer 等主流自动化工具，同时提供极低的内存和 CPU 消耗，使得在服务器或边缘设备上大规模并行运行成为可能。Lightpanda 的目标是成为 AI 时代的基础浏览器设施，让 AI 能更快、更省地理解和操作网页。

开源 unknown 自动化工作流

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 35516

维护状态活跃

是否开源是

定价模式 unknown

项目数据

分类自动化工作流

开发团队lightpanda-io

所属国家

官网地址https://lightpanda.io

GitHubhttps://github.com/lightpanda-io/browser

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议AGPL-3.0

主要语言Zig

技术栈/模型browser,browser-automation,cdp,headless,lightpanda,playwright,puppeteer,zig

GitHub 星标★ 35516

30天Star增速

HF 下载量

上线时间2023-02-07 00:00:00

最近更新2026-09-22 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-10

浏览次数5

使用教程

难度：入门约 10 分钟部署方式：命令行工具 6 步

环境要求

Linux（x86_64/aarch64）或 macOS（aarch64/x86_64）；Linux 发布二进制依赖 glibc
Windows 无原生二进制，需在 WSL2 内按 Linux 步骤安装（可用 wsl --install 初始化）
使用 Docker 方式需已安装 Docker，镜像支持 amd64 与 arm64
从源码构建需 Zig 工具链，另可用 make 简化构建

安装与启动步骤

1Homebrew 安装

macOS 或 Linux 上可用 Homebrew 直接安装官方 nightly 版本，最省事，无需手动管理二进制文件。
```
brew install lightpanda-io/browser/lightpanda
```

2下载 Linux 二进制

从 nightly 发布页下载 x86_64 版本并赋予执行权限。aarch64 版本也在同一发布页提供。

curl -L -o lightpanda https://github.com/lightpanda-io/browser/releases/download/nightly/lightpanda-x86_64-linux && 
chmod a+x ./lightpanda

3下载 macOS 二进制

macOS aarch64 用户下载对应二进制并赋权；x86_64 版本可在同一发布页获取。

curl -L -o lightpanda https://github.com/lightpanda-io/browser/releases/download/nightly/lightpanda-aarch64-macos && 
chmod a+x ./lightpanda

4Docker 启动 CDP 服务

官方镜像启动容器，把 Lightpanda 的 CDP 服务暴露在本机 9222 端口，供自动化客户端连接。
```
docker run -d --name lightpanda -p 127.0.0.1:9222:9222 lightpanda/browser:nightly
```
5验证安装

运行 version 子命令确认二进制可正常执行，README 建议在正式使用前先做这一步校验。
```
./lightpanda version
```
6从源码构建运行

克隆仓库后可用 make build 构建正式版、make build-dev 构建调试版，也可直接用 zig build run 运行。
```
make build
```

关键配置

配置项	必填	说明	示例
`CDP 服务端口`	是	Docker 方式下映射到宿主机的 CDP 端口，Puppeteer/Playwright 通过它连接	`-p 127.0.0.1:9222:9222`
`--insecure-disable-tls-host-verification`	否	运行 WPT 测试时使用的启动参数，关闭 TLS 主机校验	`zig build run -- --insecure-disable-tls-host-verification`
`-Doptimize=ReleaseFast`	否	以 ReleaseFast 模式构建，适合跑全量测试时加速	`zig build -Doptimize=ReleaseFast run`

如何确认成功

执行 ./lightpanda version 能正常输出版本信息；Docker 方式可用 docker ps 确认容器在运行且 9222 端口已映射。

常见问题

Q：Windows 上可以直接安装吗？

A：不能，Lightpanda 没有原生 Windows 二进制。需先执行 wsl --install 安装 WSL2 并重启，再在 WSL 内按 Linux 步骤安装；客户端可在 WSL 或 Windows 主机上运行，WSL 会自动转发 localhost:9222。

Q：在 Alpine 等 musl 发行版里运行报 cannot execute: required file not fo

A：Linux 发布二进制链接的是 glibc，musl 系统缺少对应动态链接器。改用 glibc 基础镜像（如 debian:bookworm-slim、ubuntu:24.04），或从源码自行构建。

Q：怎么和 Playwright、Puppeteer 配合使用？

A：Lightpanda 支持 CDP 协议，可直接对接这些主流自动化工具，客户端连接本机 9222 端口即可；Docker 方式已把该端口映射出来。

Q：源码构建慢或测试太久怎么办？

A：全量 WPT 测试耗时很长，README 建议改用 releaseFast 模式构建：zig build -Doptimize=ReleaseFast run。日常构建也可用 make build 或 make build-dev。

注意事项

README 提供的是 nightly 构建，版本更新较快，生产使用前建议先验证版本
Linux 二进制依赖 glibc，容器场景请避开 Alpine 等 musl 基础镜像
验证步骤（./lightpanda version）建议在正式跑自动化任务前先执行

核心亮点

Zig 编写，启动速度和内存占用远低于 Chromium 系无头浏览器
原生支持 CDP，兼容 Playwright/Puppeteer 生态，迁移成本低
专为 AI 代理设计，支持高并发实例，适合大规模自动化任务

不足之处

项目尚处早期，对复杂网页和现代 Web 特性的支持可能不完整
文档和社区生态相对薄弱，遇到问题可参考资源有限

适用场景

AI 代理自动浏览网页、提取信息或执行操作
大规模网页抓取和内容采集，降低基础设施成本
CI/CD 中的自动化测试，替代重量的无头浏览器

替代项目

Playwright、Puppeteer、Headless Chrome

项目介绍

browser 是自动化工作流领域的开源项目，由 lightpanda-io 开发，2023 年首次发布。

在全站 13,014 个收录项目中，它的 GitHub 星标数（35,516）位列前 2%，在自动化工作流分类的 503 个项目里位列前 3%。

近 44 天，它的 GitHub 星标从 33,690 增加到 35,516，净增 1,826。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-22。从国内网络环境看，可直接访问。

它主要面向的使用场景是：AI代理自动浏览网页、提取信息或执行操作。同类可对比的替代方案包括 Playwright、Puppeteer、Headless Chrome。

上一篇：argo-events

下一篇：obscura