
Cloudflare 开源 Kitesurf:基于 Dioxus Blitz 的智能体浏览器引擎
来源标题:Kitesurf now open source – Cloudflare's agentic browser on Dioxus Blitz
Cloudflare 将 Kitesurf 开源,这是一个运行在 Cloudflare Workers 上的实验性浏览器引擎,可在无 Chrome 或浏览器容器的情况下解析 HTML、应用 CSS、执行页面 JavaScript 并渲染截图。它支持 Chrome DevTools Protocol(CDP),可配合 Puppeteer 等 CDP 客户端使用。运行 Kitesurf 需要 Workers Paid 计划提供的 Dynamic Workers 功能。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
Kitesurf 是一个实验性的浏览器引擎,运行在 Cloudflare Workers 上。它解析 HTML、应用 CSS、执行页面 JavaScript 并渲染截图,全程不需要 Chrome 或浏览器容器。
Kitesurf 使用 Chrome DevTools Protocol (CDP),因此可以配合 Puppeteer 等 CDP 客户端使用。
Kitesurf 需要 Cloudflare Dynamic Workers 来为页面创建隔离的 worker。Dynamic Workers 属于 Workers Paid 套餐的一部分。
本地开发使用 wrangler dev。要在 Cloudflare 上运行 Kitesurf,需要 Cloudflare Workers Paid 套餐。
Bazelisk,以 bazel 命令安装。
Bazel 负责构建一切。它会自行下载固定版本的 Bazel、Rust 工具链、wasm-bindgen 和 binaryen。
Node.js 22 或更高版本
pnpm 9.15.4,仓库已在 package.json 中固定该版本
在 macOS 上需要 GNU tar(brew install gnu-tar)
Rust 通过 rustup 安装,仅用于编辑 vendored crate 补丁。rust-toolchain.toml 固定的 nightly 版本与 Bazel 使用的相同。
如果尚未安装 pnpm,请单独安装:
npm install --global pnpm@9.15.4
本地构建与运行
克隆仓库并安装依赖:
git clone https://github.com/cloudflare/kitesurf.git cd kitesurf pnpm install --frozen-lockfile
构建并启动本地引擎:
pnpm run dev
引擎监听 http://127.0.0.1:8787。访问 http://127.0.0.1:8787/health 可确认其正在运行。
根 URL 显示着陆页。页面上有一个在 Chrome DevTools 中打开 URL 的表单、示例页面,以及供 agent 和其他客户端使用的 CDP 端点。参见「使用 Chrome DevTools」。
pnpm run dev 会先用 Bazel 构建 WebAssembly 模块以及页面和渲染器 bundle,然后启动 wrangler dev。首次构建会编译 Rust 核心及其 vendored crate,耗时较长;后续构建会复用 Bazel 的缓存。
如果 8787 端口已被占用,请设置 KITESURF_PORT:
KITESURF_PORT=8799 pnpm run dev
使用 Puppeteer 连接
在将要控制 Kitesurf 的项目中安装 puppeteer-core。然后连接到浏览器 WebSocket 端点:
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();
如果你选择了不同的端口,请使用 KITESURF_PORT 中的端口。HTTP 发现端点位于 http://127.0.0.1:8787/json/version。
使用 pnpm run dev 时,在 Chrome 中打开 http://127.0.0.1:8787/。输入要检查的 URL,或选择一个示例页面。DevTools 会在该页面的标签页中打开。要直接进入 DevTools,请打开 http://127.0.0.1:8787/?url=https://example.com,或打开 http://127.0.0.1:8787/?inspect=1 以获得空白页面。
如果你构建了捆绑的前端,pnpm run dev 会从引擎自身的源提供它。参见「使用捆绑的 DevTools 前端」。
否则,DevTools 前端来自 chrome-devtools-frontend.appspot.com,即 Google 为 Chrome 托管的构建版本。托管的前端有以下限制:
如果你选择了不同的本地端口,请使用 KITESURF_PORT 中的端口。Chrome 通过普通 HTTP 和 WebSocket 连接发现目标。chrome://inspect 工作流无法访问 HTTPS 引擎。请配合本地引擎使用。
Kitesurf 提供的是 CDP 端点,而不是完整的 Chrome 实现。部分 Chrome DevTools 功能尚不可用。我们正在逐步增加更多支持。
Puppeteer 和其他 CDP 客户端可以连接到 ws://127.0.0.1:8787/devtools/browser。
Kitesurf 可以从自身的源提供 Chrome DevTools 前端。这样 DevTools 无需托管前端即可工作,也不受其权限提示和 127.0.0.1 限制的影响。已部署的引擎始终使用这份副本。该前端是 Google 为 Chromium 发布的预构建版本。默认构建不包含它。
--config=devtools Bazel 选项会将前端加入构建。首次使用该选项构建时会下载前端(约 250 MB)。Bazel 会将下载内容保留在缓存中供后续构建使用。
要构建一次前端,请在仓库根目录运行以下命令:
bazel run --config=devtools //packages/engine:dev_build
要将前端包含在每次本地构建中,请将该选项添加到 .bazelrc.user。Git 会忽略此文件。之后 pnpm run build 和 pnpm run dev 都会包含前端。
echo 'common --config=devtools' >> .bazelrc.user
构建会将前端复制到 packages/engine/public/inspector/。Git 会忽略此目录。不带该选项的构建会删除它。要关闭前端,请从 .bazelrc.user 中删除该行。
按上述方法构建前端。
使用 pnpm run dev 启动引擎。当构建包含前端时,引擎会提供捆绑的前端;否则提供托管的前端。
在 Chrome 中打开 http://127.0.0.1:8787/。输入要检查的 URL,或选择一个示例页面。DevTools 会在该页面的标签页中打开。
要从某个页面开始,请打开 http://127.0.0.1:8787/?url=https://example.com。
使用能解决问题的最小步骤:
要再次复制前端文件,请删除副本并重新构建:
rm -rf packages/engine/public/inspector bazel run --config=devtools //packages/engine:dev_build
要再次解压归档(例如在修改 bazel/devtools_frontend.BUILD 之后),请重新获取后再构建:
bazel fetch --force --repo=@devtools_frontend --config=devtools bazel run --config=devtools //packages/engine:dev_build
Bazel 从缓存中解压归档。要从 Google 重新下载归档,请在 bazel fetch 命令中添加 --repository_cache=。
不要为此使用 bazel clean --expunge。它还会删除 WebAssembly 构建和 Bazel 缓存的其余部分。
保持两个固定版本对应同一 Chrome 版本。修改 MODULE.bazel 后,下一次构建会下载新的归档。
pnpm 脚本是 Bazel 的前端封装:
pnpm run build # bazel run //packages/engine:dev_build pnpm run check # 类型检查、bundle 和仓库检查 pnpm run test:unit # 引擎 vitest 和 Rust 宿主测试 pnpm run test:e2e <file-substring>
(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。