LightPanda Browser Vibe 项目

项目简介

LightPanda 是一款从零编写的无头浏览器，专为 AI 代理和自动化场景设计。它不是 Chromium 分支，也不是 WebKit 补丁，而是使用 Zig 语言全新构建的浏览器内核。在性能对比测试中，LightPanda 内存峰值仅为 Headless Chrome 的 1/16，执行速度快 9 倍，100 页抓取仅需 5 秒（Chrome 需 46 秒）。

核心功能

全新浏览器内核：使用 Zig 语言从零编写，绕过 Chromium 和 WebKit 的历史包袱，体积小、启动快、内存占用极低。

主流自动化协议兼容：通过 CDP（Crome DevTools Protocol）接口，兼容 Puppeteer、Playwright 等主流自动化工具的现有脚本，零成本迁移。

多平台支持：提供 Homebrew（macOS/Linux）、AUR（Arch Linux）、官方 Docker 镜像（Linux amd64/arm64）和二进制下载，覆盖 macOS（x86_64 + aarch64）、Linux（glibc）和 WSL2 环境。

机器人协议遵守：内置 --obey-robots 选项，抓取时自动遵守 robots.txt 规则，适合合规爬虫场景。

多种输出格式：支持直接输出 HTML、Markdown（自动转换）、PNG 截图和 PDF 文档，无需额外处理步骤。

灵活的等待策略：支持 --wait-until（网络空闲）、--wait-ms（固定延迟）、--wait-selector（DOM 元素出现）和 --wait-script（自定义脚本）等多种等待方式，确保动态内容完整加载。

Docker 一键部署：官方提供 Docker 镜像，一行命令启动 CDP 服务器，无需本地安装。

技术实现

LightPanda 的核心设计理念是"无历史包袱"。传统浏览器为了兼容数以百万计的网页，需要维护复杂的布局引擎和渲染管线，导致体积臃肿、内存占用高。LightPanda 放弃对老旧网页的兼容，专注于现代 Web 标准的精准实现，换取极致的性能表现。

架构上，LightPanda 采用纯 CDP 协议与外部自动化客户端通信。启动后作为 CDP 服务器运行（默认端口 9222），Puppeteer/Playwright 通过 WebSocket 连接后，可完全像控制 Chrome 一样控制 LightPanda。

快速上手

第一步：下载安装（Linux）

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

第二步：启动 CDP 服务器

./lightpanda serve --obey-robots --log-format pretty --log-level info --host 127.0.0.1 --port 9222

第三步：用 Puppeteer 连接

import puppeteer from 'puppeteer-core';

const browser = await puppeteer.connect({ browserWSEndpoint: "ws://127.0.0.1:9222", });

const context = await browser.createBrowserContext(); const frame = await context.newPage(); await frame.goto('https://example.com', {waitUntil: "networkidle0"}); const links = await frame.evaluate(() => { return Array.from(document.querySelectorAll('a')).map(row => row.getAttribute('href')); }); await browser.disconnect();

第四步：直接抓取页面

./lightpanda fetch --obey-robots --dump markdown https://example.com/

适用人群

AI 代理开发者：需要频繁抓取网页内容的 AI 应用（如 RAG、知识库构建），LightPanda 的速度和成本优势明显。

爬虫工程师：需要合规、稳定、低资源占用的批量网页抓取方案，Docker 一键部署适合大规模集群。

自动化测试团队：需要轻量级浏览器环境进行 UI 自动化测试，相比 Chrome 可节省 80%+ 的内存。

需要替代 Selenium/Playwright 的轻量化场景：现有方案太重，LightPanda 提供更简单高效的替代。

官方链接

官网：https://lightpanda.io GitHub：https://github.com/lightpanda-io/browser Docker Hub：https://hub.docker.com/r/lightpanda/browser