项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-10 · 当前星标 ★ 41625
使用教程
环境要求
- 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
上一篇:argo-events
下一篇:obscura
同类项目推荐
YandexStation
开源
把 Yandex 音箱接入 Home Assistant,实现语音和自动化控制
Управление Яндекс.Станцией и другими устройст···
BrowserPilot
开源
一句话让浏览器替你干活,自动研究、抓取、操作网页。
Open‑source alternative to Perplexity Comet, director.ai and firecrawl combined
Press-Ticket
开源
一个后台管完所有客服渠道,工单自动归集,效率翻倍
O sistema de multicanais "Press-Ticket" foi projetado para oferecer uma solução ef···
TikTok-Compilation-Video-Generat···
开源
自动抓取TikTok素材,一键合成合集视频,多用户VPS部署。
A system of bots that collects clips automatically via custom made filters, lets you···
browser-agent-py
开源
用大白话指挥浏览器干活,省去写代码的麻烦。
AI Browser Agent is an advanced Browser AI tool developed by Oxylabs AI Studio that ···
welsonjs
开源
用 JavaScript 在 Windows 上直接构建 AI 自动化应用
WelsonJS - Built-in JavaScript for Industrial Automation on Windows
geekgeekrun
开源
一键海投,自动开聊,让求职像刷剧一样轻松
牛人快跑 - GeekGeekRun,求职找工作自动化工具,基于 Puppeteer、Electron。界面友好,简···
wexflow
开源
拖拽配置工作流,让重复任务自动跑起来
Workflow Automation Engine
puppeteer
开源
用 JavaScript 轻松操控无头浏览器,搞定自动化测试与网页抓取。
JavaScript API for Chrome and Firefox
