资讯 Kitesurf 开源:在 Workers 上跑无头浏览器,Puppeteer 连本地 8787 端口就能截图

2026-11-22 21:30:47

Kitesurf 开源:在 Workers 上跑无头浏览器,Puppeteer 连本地 8787 端口就能截图

Cloudflare 于 11 月 13 日将面向 AI 智能体的 Kitesurf 以 Apache-2.0 许可证开源,支持本地运行和自行部署。它完全跑在 Workers 上,能解析 HTML、应用 CSS、执行页面 JavaScript 并生成截图,不需要启动浏览器容器。

  • 项目地址:https://github.com/cloudflare/kitesurf
  • 官网:https://kitesurf.dev/
  • 仓库描述:Kitesurf is an experimental browser engine that runs on Cloudflare Workers.(Apache-2.0,TypeScript)

运行方式与内部结构

Kitesurf 支持 Chrome DevTools Protocol(CDP),Puppeteer 等客户端通过该协议连接。Cloudflare 的设计目标是给智能体提供轻量的网页访问与交互能力,减少完整 Chromium 所需的 CPU 和内存开销,并借助全球 Workers 网络按需扩展。这些是设计目标,公告没有给出性能实测结果。

引擎内部由三部分配合:

  • Engine:管理浏览器会话与客户端连接
  • PageScript:执行页面及其 JavaScript
  • PageRenderer:绘制结果

仓库的 packages 目录将各模块分开放置,包含引擎、Rust 核心、DOM 兼容层、渲染器和 Kitesurf CLI。

底层结合 Cloudflare 开发平台与 API,以及编译为 WebAssembly 的开源 Rust 组件:Blitz 负责 HTML 解析、DOM、布局和绘制,Stylo 处理 CSS 解析、层叠及计算样式;只有当 JavaScript 无法在 Dynamic Workers 中执行时,才以 Boa 在 WebAssembly 里运行脚本;Linebender 系列库提供文字布局和二维图形,Krilla 生成 PDF。第三方项目保留各自许可证,声明列在仓库的 NOTICE 文件中。

本地跑通步骤

先满足仓库列出的构建要求,然后:

git clone https://github.com/cloudflare/kitesurf
cd kitesurf
pnpm install --frozen-lockfile
pnpm run dev

首次构建会编译 Rust 核心及依赖,后续构建复用缓存。wrangler 随后在 http://127.0.0.1:8787 启动本地开发服务,可以直接打开该地址,通过 Chrome DevTools 试用页面。

用 puppeteer-core 连接这个本地实例做自动化:

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: 'shot.png' });

await browser.disconnect();

智能体运行框架同样可以指向这个本地 CDP 端口,让智能体操作 Kitesurf。

部署与前提条件

在仓库根目录执行 pnpm run deploy,即可将引擎部署到自己的 Cloudflare 账户,使用自己管理的实例。Cloudflare 另外提供 Browser Run 作为托管 API。

自部署有一项明确条件:账户必须使用 Workers Paid plan,因为 Kitesurf 依赖 Dynamic Workers 为页面创建隔离的 Worker。

什么场景合适,什么场景不合适

适合的方向:

  • 智能体抓取静态或半动态页面:解析 HTML、应用 CSS、执行页面脚本、截图这条链路够用。
  • 内存与启动开销敏感:不用拉起完整 Chromium 容器。
  • 需要全球边缘部署:跟随 Workers 网络分发,按需扩展。

需要谨慎的方向:

  • 重 JS 的 SPA:页面脚本执行走 Dynamic Workers,复杂前端行为的覆盖度需要实测。
  • 依赖真实 Chrome 行为:这是另一套引擎实现,不是 Chromium。
  • 视频、Canvas 等富媒体渲染:原文未涉及相关能力。
  • 对兼容性要求高的既有流程:Cloudflare 表示项目仍在密集开发,当前工作集中在提高网页兼容性、可靠性和效率,并引导开发者查看 Web Platform Tests 的进展。

Cloudflare 未公布性能基准,需自行验证。 具体网站和自动化流程能否正常运行,仍要开发者自己跑一遍。

参与贡献

项目欢迎 fork 和贡献,但提交代码前要先读贡献指南:开 issue 附上最小复现或拟议方案,获得维护者认可后再提 PR。范围清楚、带测试和证据的修复更容易审查。贡献也可以是一张能复现渲染错误的小页面、一条失败的自动化流程,或一处清楚的文档订正。

推荐文章

程序员茄子在线接单