选择并完成安装

根据你的操作系统，从README中选择一种最方便的方式安装Lightpanda。新手推荐直接下载预编译的二进制文件（Nightly Builds）或使用Docker镜像。例如，在Linux上使用提供的curl命令下载并赋予执行权限。

Windows用户请使用WSL2，并按照Linux指南在WSL中安装Lightpanda，在Windows主机上安装Puppeteer。

验证安装并运行第一个命令

打开终端，运行 `./lightpanda --help` 查看帮助信息。然后尝试使用 `dump` 命令快速抓取一个网页的HTML内容，例如：`./lightpanda dump https://example.com`。

这会让你立刻看到Lightpanda的工作效果，确认安装成功。

启动CDP服务器

在终端中运行 `./lightpanda server` 启动Chrome DevTools Protocol服务器。默认会在9222端口监听。

保持这个终端窗口打开，服务器会持续运行。

使用Puppeteer连接

1. 创建一个新的Node.js项目或目录。 2. 安装Puppeteer Core（`npm install puppeteer-core`），因为它更轻量且允许连接任意浏览器。 3. 参考README中的示例代码，编写一个简单的脚本，通过 `browserWSEndpoint` 连接到 `ws://localhost:9222`，然后打开页面并获取标题。

确保你的Puppeteer脚本在Lightpanda的CDP服务器启动后才运行。示例代码是连接的关键。

执行基础自动化操作

修改你的Puppeteer脚本，尝试更多操作，如： - 在页面中执行JavaScript (`page.evaluate`) - 模拟点击页面元素 - 在表单中输入文本 观察Lightpanda的执行速度和内存占用。

探索启动参数

再次查看 `./lightpanda --help`，了解其他有用的命令行选项，例如： - `--obeyrobots`：遵守robots.txt - `--proxy-server`：设置代理 - `--disable-telemetry` 或设置环境变量 `LIGHTPANDA_DISABLE_TELEMETRY=true` 来禁用遥测。

了解这些选项可以帮助你更好地控制浏览器的行为，适应不同的使用场景（如爬虫）。

查阅功能实现状态

浏览README中的“Status”和功能列表（带复选框的部分）。了解哪些核心Web API（如Fetch、XHR、Cookies）已实现，明确当前项目的Beta状态和局限性。

这能帮助你设定合理的预期，知道哪些复杂的网页操作可能暂时不支持，避免踩坑。

尝试Docker部署

如果你之前用的是二进制文件，现在可以尝试使用Docker方式运行Lightpanda。这更便于在服务器环境或隔离容器中部署。运行README中提供的docker命令。

Docker镜像已经包含了所有依赖，是最干净的运行方式。

学习如何反馈问题

如果遇到脚本在Lightpanda上运行失败： 1. 首先确认脚本在Chrome/Chromium上是否能正常运行。 2. 阅读README中关于Playwright支持的免责声明，理解兼容性问题的原因。 3. 如果确定是Lightpanda的问题，准备按照Issue模板（查看GitHub Issues页面）提交报告，并附上能复现问题的最小代码片段和最后已知可用的脚本版本。