Kitesurf: браузерный движок внутри Cloudflare Workers

· 6 мин чтения
browser-automation cloudflare-workers open-source rust screenshots
📂 Исходный код на GitHub

Экспериментальный браузерный движок на Cloudflare Workers: рендеринг HTML, CSS и JavaScript и скриншоты страниц без Chrome. Говорит на протоколе CDP, работает с Puppeteer и другими CDP-клиентами.

Kitesurf: браузерный движок внутри Cloudflare Workers

Kitesurf — экспериментальный браузерный движок от Cloudflare, который целиком живёт внутри Workers. Он разбирает HTML, применяет CSS, исполняет JavaScript страницы и отрисовывает скриншоты. Для всего этого ему не нужен ни Chrome, ни контейнер с браузером. Проект распространяется под лицензией Apache 2.0, написан на TypeScript с ядром на Rust и собрал около 1,2 тысячи звёзд на GitHub.

Главная особенность движка — он говорит на протоколе Chrome DevTools Protocol (CDP). К нему подключаются обычные CDP-клиенты: Puppeteer, встроенный инспектор Chrome, любые инструменты автоматизации. В README отдельно упоминаются агенты: движок создавался в том числе для них, и на главной странице движка есть готовые CDP-эндпоинты для агентских сценариев.

Как устроен движок

Внутри Kitesurf — несколько известных open-source проектов на Rust:

Компонент Что делает
Blitz Разбор HTML, DOM, раскладка и отрисовка
Stylo Разбор CSS, каскад и вычисленные стили (CSS-движок из проекта Servo)
Boa Интерпретатор JavaScript, исполняет код страницы внутри WebAssembly
Parley и Vello из набора Linebender Раскладка текста и двумерная графика
Krilla Генерация PDF

Свои Rust-зависимости Kitesurf патчит. Наборы патчей лежат в каталоге scripts/patches, применяет их сам Bazel.

Изоляция страниц устроена так: для каждой страницы движок запускает отдельный воркер. Это возможно благодаря Dynamic Workers — специальной привязке Worker Loader в конфигурации движка. Возможность требует платного тарифа Workers Paid. Локальная разработка работает и без него — через wrangler dev.

Запуск локально

Понадобятся:

  • 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 — только если будете править патчи вендорных крейтов. Версия закреплена в rust-toolchain.toml.

Установить 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

Команда pnpm run dev собирает WebAssembly-модули и бандлы страницы и рендерера через Bazel, затем стартует wrangler dev. Первая сборка компилирует Rust-ядро вместе с вендорными крейтами и занимает время. Следующие проходят быстрее — Bazel переиспользует кеш.

Движок слушает http://127.0.0.1:8787. Проверить, что он жив, можно на /health. Если порт занят, укажите другой:

KITESURF_PORT=8799 pnpm run dev

Подключение Puppeteer

Ставим 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-discovery: http://127.0.0.1:8787/json/version.

Отладка страниц в DevTools

На корневом URL локального движка открывается страница с формой «открыть URL в DevTools», примерами страниц и CDP-эндпоинтами. Можно сразу открыть конкретный адрес: http://127.0.0.1:8787/?url=https://example.com. Для пустой страницы — ?inspect=1.

Работает и страница chrome://inspect в Chrome:

  1. Откройте chrome://inspect/#devices — вручную, через адресную строку: страницы не могут ставить ссылки на chrome://.
  2. Включите Discover network targets.
  3. Нажмите Configure... и добавьте 127.0.0.1:8787.
  4. В блоке Remote Target нажмите inspect рядом с kitesurf.
  5. Введите адрес страницы в строку над скринкастом.

По умолчанию локальный движок отдаёт фронтенд DevTools, который хостит Google — тот же билд, что у Chrome. У этого варианта три ограничения: Chrome спросит разрешение на доступ к chrome-devtools-frontend.appspot.com, при отказе DevTools перестанет подключаться, а сам фронтенд умеет соединяться только с 127.0.0.1 — на задеплоенном движке он не заработает.

Поэтому Kitesurf умеет отдавать фронтенд DevTools со своего же origin. За это отвечает опция Bazel --config=devtools: первая такая сборка скачает фронтенд (около 250 МБ), дальше архив живёт в кеше Bazel. Собранные файлы попадают в packages/engine/public/inspector/. Для деплоя это настраивать не нужно — там фронтенд входит в сборку всегда.

Важно понимать границы: Kitesurf даёт CDP-эндпоинт, а не полную реализацию Chrome. Часть функций DevTools пока не работает, поддержку постепенно добавляют.

Деплой в Cloudflare

Движок разворачивается одной командой из корня репозитория:

pnpm run deploy

Команда собирает движок через Bazel и загружает через Wrangler. Без флага --name воркер получит имя kitesurf. Полезные режимы: pnpm run deploy --dry-run — сборка без загрузки, pnpm run deploy:preview — загрузка версии без переключения трафика. Деплой всегда собирается с --config=devtools, так что фронтенд DevTools включён автоматически.

Перед деплоем прочитайте предупреждение из README — оно серьёзное. У движка нет собственной аутентификации. Тот, кто знает URL, сможет:

  • открывать DevTools и ходить по интернету через ваш движок;
  • подключать Puppeteer и других CDP-клиентов;
  • отправлять запросы, которые исходят с вашего аккаунта Cloudflare;
  • тратить ваш CPU-тайм и оплаченные Dynamic Workers.

Адрес вида kitesurf.<ваш-поддомен>.workers.dev публичный и предсказуемый. Поэтому сразу после деплоя закройте воркер через Cloudflare Access из набора Zero Trust. Между деплоем и включением Access движок открыт всем — чтобы исключить это окно, включите Access для всех воркеров аккаунта заранее.

CDP-клиент через Access подключается с сервис-токеном:

  1. Создайте Access service token.
  2. Добавьте политику с действием Service Auth, которая разрешает этот токен.
  3. Передавайте заголовки токена в WebSocket-подключении:
const browser = await puppeteer.connect({
  browserWSEndpoint: "wss://<worker-host>/devtools/browser",
  headers: {
    "CF-Access-Client-Id": process.env.CF_ACCESS_CLIENT_ID,
    "CF-Access-Client-Secret": process.env.CF_ACCESS_CLIENT_SECRET,
  },
});

Токен даёт тот же доступ, что и залогиненный пользователь, — храните его как пароль.

Что внутри репозитория

Код разбит на пакеты:

Пакет Что это
engine Cloudflare Worker и CDP-сервер
page-script DOM и рантайм JavaScript страницы
page-renderer Рендерер записанных сцен страницы
dom-shim DOM API внутри страничного воркера
core Rust-код раскладки, отрисовки и JS-движка
renderer-core Rust-растеризатор сцен для отрисовки страниц
scene-host-wasm Локальная растеризация сцен для терминального клиента
kitesurf-cli Терминальный клиент

Репозиторий появился в конце сентября 2026 года и активно развивается. Правила для контрибьюторов описаны в CONTRIBUTING.md, сообщения о проблемах безопасности — в SECURITY.md. Для команд, которые уже работают в экосистеме Cloudflare, Kitesurf закрывает задачу «дать агенту страницы» без Chrome и контейнеров — на привычном протоколе CDP.

Источник: https://github.com/cloudflare/kitesurf