Kitesurf: браузерный движок внутри Cloudflare Workers
📂 Исходный код на GitHubЭкспериментальный браузерный движок на Cloudflare Workers: рендеринг HTML, CSS и JavaScript и скриншоты страниц без Chrome. Говорит на протоколе CDP, работает с Puppeteer и другими CDP-клиентами.
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:
- Откройте
chrome://inspect/#devices— вручную, через адресную строку: страницы не могут ставить ссылки наchrome://. - Включите Discover network targets.
- Нажмите Configure... и добавьте
127.0.0.1:8787. - В блоке Remote Target нажмите inspect рядом с kitesurf.
- Введите адрес страницы в строку над скринкастом.
По умолчанию локальный движок отдаёт фронтенд 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 подключается с сервис-токеном:
- Создайте Access service token.
- Добавьте политику с действием Service Auth, которая разрешает этот токен.
- Передавайте заголовки токена в 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