Kitesurf
Kitesurf 是运行在 Cloudflare Workers 之上的实验性浏览器引擎。它获取页面、执行页面 JavaScript、完成布局与绘制,并支持 Chrome DevTools Protocol,因此现有工具可直接驱动它,且无需 Chromium 进程或容器。
访问 cloudflare/kitesurf项目简介
Kitesurf 是运行在 Cloudflare Workers 之上的实验性浏览器引擎。它获取页面、执行页面 JavaScript、完成布局与绘制,并支持 Chrome DevTools Protocol,使现有工具能够驱动它;其后没有 Chromium 进程或容器。项目将其描述为面向 Agent 的无状态 Web 浏览器。
核心功能
- 作为运行在 Cloudflare Workers 上的实验性浏览器引擎,无需 Chromium 进程或容器;获取页面并执行页面 JavaScript,完成布局与绘制;支持 Chrome DevTools Protocol,可由 Puppeteer 等 CDP 客户端驱动;提供面向 Agent 的无状态浏览器,并可在渲染时通过 DevTools 检查 DOM、控制台与网络;可从真实页面生成截图、PDF 和渲染后的 HTML;附带终端客户端,在支持时使用 kitty graphics,其他环境使用纯文本。
适用场景
- 在 Chrome DevTools 中检查页面渲染,包括 DOM、控制台与网络;通过 Puppeteer 等 CDP 客户端驱动页面导航与截图;从真实页面生成截图、PDF 或渲染后的 HTML;使用 Kitesurf 终端客户端在终端浏览 Web。
快速开始
- 克隆仓库并用 pnpm install --frozen-lockfile 安装依赖;用 pnpm run dev 构建并启动本地引擎,本地引擎监听 8787 端口,可通过健康检查端点确认运行;将 Puppeteer 等 CDP 客户端连接到本地 8787 端口的浏览器 WebSocket 端点;用 brew install cloudflare/cloudflare/kitesurf 安装终端客户端,并以 kitesurf -m ansi 启动。
部署与要求
- 在 Cloudflare 上运行 Kitesurf 需要 Cloudflare Workers Paid 计划;本地开发使用 wrangler dev,部署时由 Bazel 构建并通过 Wrangler 上传,使用 wrangler login 或 CLOUDFLARE_ACCOUNT_ID 与 CLOUDFLARE_API_TOKEN;由于引擎自身没有身份验证,部署需要 Cloudflare Access 等认证层;构建需要安装为 bazel 的 Bazelisk、Node.js 22 或更新版本、pnpm 9.15.4,macOS 上还需 GNU
采用前须知
- 许可证:Apache-2.0。在使用、修改或分发项目前,请确认其具体条款。