专为 AI Agent 而生:Cloudflare 开源浏览器 Kitesurf 部署指南

举报
yd_262695662 发表于 2026/11/16 10:42:54 2026/11/16
【摘要】 Kitesurf 需要通过 CLI 推送代码加 Dashboard 配置才能完成部署:开通 Workers Paid 计划、本地编译推送、开启 Access 安全鉴权,再通过 CDP 接入 Puppeteer。本文一步步讲清完整流程。

由于 Kitesurf 底层需要通过 Bazel 编译 Rust/Wasm 核心,无法直接在网页端拉取 Git 仓库构建,完整部署需要"CLI 推送代码 + Cloudflare Dashboard 配置权限与安全防护"配合完成(若不想自建,也可直接在 Dashboard 左侧 Compute → Browser Run 中调用官方托管 API 并加上 browser=kitesurf 参数)。

第 1 步:在 Dashboard 开通 Workers Paid 计划

Kitesurf 依赖 Dynamic Workers 动态拉起页面隔离实例,该功能仅对付费版开放。

  • 登录 Cloudflare Dashboard,在左侧导航栏进入 Workers & Pages → Plans。
  • 订阅 Workers Paid 计划($5/月起,包含每月 3,000 万 CPU 毫秒和 1,000 个独立 Dynamic Workers 实例额度)。

第 2 步:本地编译并推送到你的 Workers 账号

确保本地已安装 Node.js 22+、pnpm 和 Bazelisk,克隆官方仓库并一键发布:

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

首次编译耗时较长,完成后 Wrangler 会自动将名为 kitesurf 的 Worker 上传至你的账号。

第 3 步:在 Dashboard 开启安全鉴权(必做)

警告: Kitesurf 开源版本身不包含任何身份验证,默认生成的 kitesurf.<你的子域>.workers.dev 地址是公开的,若不加保护,任何人都能借用你的出口发起请求并消耗你的付费额度。

  • 回到 Cloudflare Dashboard,进入 Workers & Pages,点击刚部署好的 kitesurf 服务。
  • 切换到 Settings(设置)→ Domains & Routes(域与路由)。
  • 找到 *.workers.dev 这一行,点击右侧操作菜单中的 Enable Access(启用 Access),按提示绑定 Cloudflare Access(Zero Trust)登录策略或 Service Token。

第 4 步:测试与接入

完成 Access 保护后,在浏览器打开你的 Worker 域名并完成身份验证,即可看到内置的 Chrome DevTools 调试界面。在自动化代码中,直接通过 CDP 协议连接即可:

import puppeteer from 'puppeteer-core';

const browser = await puppeteer.connect({
  browserWSEndpoint: 'wss://kitesurf.<你的子域>.workers.dev/devtools/browser',
  headers: {
    // 填入你在 Cloudflare Access 配置的 Service Token
    'CF-Access-Client-Id': '你的_CLIENT_ID',
    'CF-Access-Client-Secret': '你的_CLIENT_SECRET',
  },
});

const page = await browser.newPage();
await page.goto('https://example.com');
await page.screenshot({ path: 'result.png' });
await browser.disconnect();
【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。