lightpanda-io/browser - 快速上手

项目介绍快速开始学习路径项目截图 2 贡献者 19 增长趋势代码统计生态关系项目时间线项目竞品依赖分析上榜历史

Lightpanda Browser 5分钟快速开始

Lightpanda是一个专为AI与自动化设计的无头浏览器，内存占用低、启动快，兼容Playwright和Puppeteer。

环境要求

支持的操作系统

Linux macOS Windows (通过WSL2)

运行环境

Lightpanda二进制文件最新nightly版本必需

所需工具

Docker (可选)

通过容器快速运行

操作步骤

安装Lightpanda

根据你的操作系统下载并安装Lightpanda二进制文件。

Linux x86_64安装命令

curl -L -o lightpanda https://nightly.link/lightpanda-io/browser/workflows/build/main/lightpanda-linux-x86_64.zip && unzip lightpanda && chmod +x lightpanda

macOS aarch64安装命令

curl -L -o lightpanda https://nightly.link/lightpanda-io/browser/workflows/build/main/lightpanda-macos-aarch64.zip && unzip lightpanda && chmod +x lightpanda

预期结果：：下载并解压后，当前目录出现可执行文件lightpanda。

Windows用户需在WSL2中运行Linux命令。

启动CDP服务器

运行Lightpanda并启动Chrome DevTools Protocol服务器，以便通过Puppeteer等工具控制浏览器。

启动CDP服务器在端口9222

./lightpanda --remote-debugging-port=9222

预期结果：：终端显示服务器启动信息，如'CDP server listening on port 9222'。

保持此终端运行，不要关闭。

运行Puppeteer脚本

在另一个终端中，使用Node.js和Puppeteer连接Lightpanda并执行简单操作。

连接Lightpanda，访问example.com并打印标题

node -e "const puppeteer = require('puppeteer'); (async () => { const browser = await puppeteer.connect({ browserWSEndpoint: 'ws://localhost:9222' }); const page = await browser.newPage(); await page.goto('https://example.com'); console.log(await page.title()); await browser.close(); })();"

预期结果：：输出'Example Domain'，表示成功访问网页。

确保已安装Node.js和Puppeteer（npm install puppeteer）。

验证成功

如果步骤3输出网页标题，说明Lightpanda已成功运行并与Puppeteer集成。

终端显示'Example Domain'

无错误信息

快速提示

安装

使用Docker快速启动：docker run -p 9222:9222 ghcr.io/lightpanda-io/browser:latest

配置

禁用遥测：设置环境变量LIGHTPANDADISABLETELEMETRY=true

支持

Lightpanda处于Beta阶段，如遇问题请提交GitHub issue

常见问题

命令'./lightpanda'找不到

确保在解压后的目录中运行，或添加路径到PATH。

Puppeteer连接失败

检查CDP服务器是否运行在端口9222，并确保防火墙允许连接。

内存或性能问题

Lightpanda设计为低内存占用，如异常可尝试重启或检查系统资源。

下一步

探索更多功能

尝试网络拦截、代理支持等高级特性，参考项目文档。

贡献代码

项目接受Pull Requests，但需签署CLA。

报告问题

在GitHub提交issue，附上详细复现步骤。