**[→ полные примечания к релизу](https://github.com/tiliondev/fortress/releases/tag/v151.0.7908.0)**


## Содержание

| | |
|---|---|
| **[Что это такое](#what-it-is)** · **[Быстрый старт](#quick-start)** | что это такое, установка, первый скрипт, настройка ИИ-агента |
| **[Fortress MCP](#the-fortress-mcp--stealth-browsing-as-agent-tools)** | 29 инструментов скрытного браузера для ИИ-агентов (бета) |
| **[Зачем патчить движок, а не страницу](#why-patch-the-engine-not-the-page)** | тезис о самораскрывающемся JS + три уровня обнаружения |
| **[Как Fortress сравнивается](#how-fortress-compares)** | сравнение с puppeteer-stealth · Camoufox · CloakBrowser · закрытые вендоры |
| **[Доказательства: результаты live-детекторов](#proof-live-detector-results)** | CreepJS / Sannysoft / BrowserScan / Cloudflare, со скриншотами |
| **[Настройка персоны](#configure-the-persona)** | поверхность отпечатка `--uxr-*` |
| **[Работает с вашим стеком](#works-with-your-stack)** | browser-use · Crawl4AI · Stagehand · LangChain |
| **[Сборка и проверка](#build--verify)** | воспроизведение из исходников, проверка происхождения |
| **[Справка](#reference)** | устранение неполадок · FAQ · дорожная карта · структура репозитория |

---

## Что это такое

Fortress — это форк Chromium, который подменяет отпечаток браузера изнутри движка. Поверхности, которые считывают детекторы ботов (canvas, WebGL, audio, шрифты, navigator и ещё около тридцати), исправляются в **C++** коде Chromium, без слоя JavaScript-патчей поверх, которые страница могла бы обнаружить.

Он поставляется как обычный бинарник браузера, предоставляющий CDP-эндпоинт. Направьте на него Playwright, Puppeteer или любой CDP-клиент, и ваша существующая автоматизация будет работать без изменений.

JavaScript-стелс-патч оставляет дополнительный слой, который страница может обнаружить: `.toString()` показывает исходный код переопределения, а повторное получение того же примитива из iframe или воркера обходит его. Fortress исправляет поверхность прямо в движке, поэтому `navigator.vendor` обращается к настоящему C++ геттеру, сообщает `[native code]` и возвращает одно и то же значение из любого контекста. Страница, проверяющая себя, видит обычный Chromium. Именно поэтому ваша автоматизация проходит там, где раньше её обнаруживали, а оставшиеся блокировки связаны с вашими прокси и поведением, а не с браузером. В разделе [Зачем патчить движок, а не страницу](#why-patch-the-engine-not-the-page) подробно описана механика обнаружения.```python
from tilion_fortress import Fortress
from playwright.sync_api import sync_playwright

with Fortress() as f:                                   # launches the stealth engine on a CDP endpoint
    with sync_playwright() as p:
        browser = p.chromium.connect_over_cdp(f.cdp_url)
        page = browser.new_page()
        page.goto("https://bot.sannysoft.com")
        page.screenshot(path="all-green.png")

import { Fortress } from "tilion-fortress";
import { chromium } from "playwright";

const f = await Fortress.launch();                      // stealth engine on a CDP endpoint
const browser = await chromium.connectOverCDP(f.cdpUrl);
const page = await browser.newPage();
await page.goto("https://browserscan.net");
await browser.close();
await f.close();

> [!TIP]
> SDK поставляется со скомпилированной сборкой **плюс `patches/`**, так что вы можете пересобрать движок самостоятельно и проверить каждое исправление на соответствие исходному коду. Загрузки автоматически проверяются по SHA-256 относительно файла `SHA256SUMS` релиза.

### Версии

Fortress поставляется на **двух базах Chromium** — выбирайте компромисс между маскировкой и актуальностью:

| Канал | Chromium | Когда использовать |
|---|---|---|
| **`stable`** *(по умолчанию)* | **149** | Рекомендуется — соответствует версии Chrome, которую использует большинство реальных пользователей, поэтому лучше всего маскируется |
| **`latest`** | **151** | Новейший движок (сообщает версию немного новее, чем stable) |```python
Fortress().start()                     # Python: stable (149) by default
Fortress(channel="latest").start()     # opt into 151

await Fortress.launch();               // Node: stable (149) by default
await Fortress.launch({ channel: "latest" });

docker run --rm -p 9222:9222 tilion/fortress:149   # or :151
# or set FORTRESS_CHANNEL=latest for either SDK

## Fortress MCP — скрытый браузинг в виде инструментов агента &nbsp;<sub>Beta</sub>

Сырой CDP предназначен для кода, который вы пишете. **Fortress MCP** — для агентов, вызывающих **инструменты**: сервер [Model Context Protocol](https://modelcontextprotocol.io), который предоставляет Claude, Cursor или любому MCP-клиенту скрытый браузер, поэтому как только запрос блокируется, он просто вызывает инструмент и получает страницу. **29 инструментов, локально и бесплатно** — `fetch_protected_page`, `extract_page`, `crawl_site`, `recon_site_apis`, `search_web`, `run_browser_task`, `save_profile`, `get_stealth_cdp_endpoint` и другие.

<p align="center"><img src="https://assets.kitploit.com/production/public/readmes/795/8f328e2498b09d7433208c5b4a9002450643537f2ee6b0519ac10420ef581bf3.gif" alt="Тот же сайт, тот же запрос: обычный браузер блокируется PerimeterX, в то время как агент с Fortress MCP возвращает чистый JSON" width="760"/></p>

<sub><i>Реальный, датированный запуск против <b>stockx.com</b> (PerimeterX). Обычный браузер получает <b>HTTP 403 — «Доступ запрещён»</b>; агент с Fortress MCP возвращает чистый JSON — тот же сайт, тот же запрос. Воспроизведите это из репозитория фреймворка.</i></sub>

### Настройте за 30 секунд

Два способа запуска — выберите один. `npx` требует Python в PATH; `pip` устанавливает его напрямую:```bash
pip install "tilion[mcp]"      # command:  tilion-mcp
#   —or, zero-install—
npx -y tilion-mcp              # auto-runs the server via uv (no global install)

<sub>Предпочитаете npx? Используйте <code>"command": "npx", "args": ["-y", "tilion-mcp"]</code>. Перезапустите Claude, и появятся инструменты <b>fortress</b>.</sub>

**Claude Code** (CLI) — одна строка:```bash
claude mcp add fortress -- tilion-mcp          # or:  claude mcp add fortress -- npx -y tilion-mcp

Затем просто попросите своего агента — *«получить цену с этой страницы StockX»* — и он сам вызовет `fetch_protected_page`.

### Что получает агент

| | tools |
|---|---|
| **Получение заблокированных страниц** | `fetch_protected_page` · `read_page` · `get_page_html` · `search_web` |
| **Структурированные данные** | `extract_page` (с учетом схемы) · `extract_document` (PDF/DOCX/XLSX) |
| **Целые сайты** | `crawl_site` (авто-SPA) · `recon_site_apis` (найти частный JSON API) |
| **Управление страницей** | `page_elements` · `click_button` · `fill_field` · `press_key` · `wait_for` · `evaluate_js` |
| **Многошаговые потоки** | `run_browser_task` (вход, пагинация, бесконечная прокрутка, оформление заказа, …) |
| **Захват / аутентификация** | `screenshot_page` · `save_page` · `download_file` · `save_profile` / `load_profile` |
| **Свой собственный** | `get_stealth_cdp_endpoint` → CDP-URL для Playwright / Puppeteer / browser-use |

Инструменты аннотированы (чтение — автоодобрение, запись — шлюз), **предварительно прогреты** при запуске (~100 мс первый вызов), безопасны для параллельной работы, защищены от тайм-аутов и SSRF-атак. Размещенная конечная точка с **жилым исходящим трафиком скоро появится**.

→ Полная таблица 29 инструментов, бенчмарки и навыки агента: **[`mcp/`](https://github.com/tiliondev/fortress/blob/HEAD/mcp/README.md)**

---

## Почему патчить движок, а не страницу

Обычный подход патчит `navigator.webdriver`, подделывает поставщика WebGL и переопределяет `navigator.plugins` из скрипта. CreepJS и подобные детекторы всё равно его отмечают, и причина **структурная**, а не ещё одно незакрытое свойство. JavaScript-подмена — это функция, стоящая на месте нативной. Детекторы откладывают возвращаемое значение в сторону и выясняют, является ли возвращающий объект нативным:

| Признак | Почему это ловит JS-подмену |
|---|---|
| Саморазоблачение `toString` | Нативный метод преобразуется в строку как `function get vendor() { [native code] }`; переопределённый — в свой собственный исходный код, так что один `.toString()` ловит это. |
| Дескриптор и `hasOwnProperty` | `getOwnPropertyDescriptor` раскрывает переопределённые свойства, а `hasOwnProperty('toString')` возвращает `true` на подменённой функции, тогда как нативная возвращает `false`. |
| `failsTypeError` | Нативные геттеры выбрасывают определённый `TypeError` при неправильном `this`; наивная заглушка молчит, и тишина — это сигнал. |

Повторное получение realm — это то, что побеждает любой патч основного мира. Детектор захватывает неизменный примитив из другого realm и натравливает его на вашу функцию:```js
const iframe = document.createElement('iframe'); document.body.appendChild(iframe);
const realToString = iframe.contentWindow.Function.prototype.toString;
realToString.call(navigator.__lookupGetter__('vendor')); // returns your source code. Caught.

| Env var | Назначение |
|---|---|
| `TILION_NO_DEFAULTS=1` | Пропустить стандартную персону (чистый запуск) |
| `TILION_TZ` / `TILION_LANG` | Быстрое переопределение часового пояса / языка |

> [!NOTE]
> **Персона сегодня передается через командную строку.** Флаги `--uxr-*` доступны для чтения всем процессам через `/proc/<pid>/cmdline`, поэтому на один запуск приходится одна персона, и она видна другим процессам на хосте. Следом появится среда выполнения `MaskConfig`: она будет передавать персону через IPC и снимет ограничение на одну персону на процесс (см. [что дальше](#whats-next)).

---

## Работает с вашим стеком

Fortress предоставляет сырой CDP на порту `:9222`, поэтому он встраивается в любое решение, поддерживающее Playwright, Puppeteer или CDP.

| Фреймворк | Подключение |
|---|---|
| [**browser-use**](https://github.com/browser-use/browser-use) (~70k звезд) | `cdp_url="http://localhost:9222"` |
| [**Crawl4AI**](https://github.com/unclecode/crawl4ai) (~58k звезд) | CDP конечная точка |
| [**Stagehand**](https://github.com/browserbase/stagehand) (~21k звезд) | `connectOverCDP` |
| [**LangChain**](https://github.com/langchain-ai/langchain) Playwright toolkit | Playwright CDP |
| **Playwright / Puppeteer** (Python и JS) | `connect_over_cdp` / `connect` |```python
from playwright.sync_api import sync_playwright
with sync_playwright() as p:
    browser = p.chromium.connect_over_cdp("http://localhost:9222")   # Fortress under the hood

Вывод: `out/Fortress/chrome`. Форк состоит из 34 небольших одноповерхностных патчей (`patches/`), поэтому большинство из них чисто применяются при обновлениях upstream; затем «перчатка» (gauntlet) блокирует релиз при любых регрессиях.

| Платформа | Статус |
|---|---|
| Linux x64 (нативный) · **Windows x64 (нативный)** · любая ОС через Docker | <img src="https://raw.githubusercontent.com/tiliondev/fortress/HEAD/docs/assets/icons/check.svg" width="15" alt="yes"> **поставляется** |
| Установщики с цифровой подписью · macOS `.app` · `linux/arm64` | в процессе |

### Проверьте, что это действительно наше

Fortress поставляется из четырех официальных каналов. Ко всему остальному относитесь как к недоверенному:

| | Официальный источник |
|---|---|
| **Исходный код** | [github.com/tiliondev/fortress](https://github.com/tiliondev/fortress) |
| **Docker** | [`tilion/fortress`](https://hub.docker.com/r/tilion/fortress) |
| **Python** | [`tilion-fortress`](https://pypi.org/project/tilion-fortress/) |
| **Node** | [`tilion-fortress`](https://www.npmjs.com/package/tilion-fortress) |

**Проверьте загрузку.** Каждый релиз включает `SHA256SUMS`, а SDK для `pip`/`npm` выполняют эту проверку за вас при установке:```bash
BASE=https://github.com/tiliondev/fortress/releases/download/v151.0.7908.0
curl -LO $BASE/tilion-fortress-linux-x64.tar.gz
curl -Ls $BASE/SHA256SUMS | sha256sum -c --ignore-missing     # -> OK

**Или ничему не доверяйте и пересоберите его.** Весь форк состоит из 34 читаемых патчей в `patches/`; `build/build.sh` воспроизводит бинарник из исходников Chromium, так что вы можете сравнить то, что собрали, с тем, что мы поставляем.

---

## Справочник

<details><summary><b>Устранение неполадок</b></summary>

<br/>

**Всё ещё блокируется Cloudflare, DataDome или Kasada.** В большинстве случаев это ваш **IP**, а не отпечаток: диапазон дата-центра получает флаг до выполнения любого скрипта страницы. Направьте исходящий трафик через резидентные или мобильные прокси и повторите попытку; если блокировка снята, отпечаток был в порядке.

**Отпечаток выглядит неправильно на хосте Linux.** Персона по умолчанию — Windows, но форма TLS и некоторые сигналы, связанные с ОС, следуют за основной машиной. Сопоставьте персону с вашей исходящей ОС или установите соответствующие флаги `--uxr-*`, чтобы история ОС соответствовала тому, откуда исходит трафик.

**macOS использует образ Docker.** Нативные бинарники для Linux и Windows поставляются сегодня; macOS всё ещё запускает Fortress через официальный образ Docker (`tilion/fortress`). Установите Docker Desktop или запускайте на Linux/Windows x64 для нативного бинарника.

**Персона отображается в `/proc/<pid>/cmdline`.** Флаги `--uxr-*` читаемы другими процессами на хосте, одна персона на запуск. Пока не появится runtime `MaskConfig`, держите одну персону на процесс и избегайте общего хоста с недоверенным кодом.

**Детектор отмечает то, что gauntlet проходит.** Обнаружение движется. Убедитесь, что вы на текущем rebase Chromium, затем откройте issue с тестовой страницей. Эта страница станет следующим патчем.

</details>

<details><summary><b>Часто задаваемые вопросы</b></summary>

<br/>

**Это законно?** Fortress — это проект по разработке браузера для легитимной автоматизации, тестирования и сбора общедоступных данных. Уважайте условия использования каждого сайта и законы вашей юрисдикции.

**Он действительно бесплатный?** Да. BSD-3, полностью открытый и размещаемый самостоятельно. Серия патчей опубликована, так что вы можете собрать текущий движок из исходников самостоятельно.

**Почему бы просто не использовать puppeteer-stealth или undetected-chromedriver?** Они патчат слой JS/CDP *после* того, как страница может проверить браузер, поэтому они раскрывают себя через `toString` и повторное получение области. Fortress переносит подмену в C++, где страница находит нативный код. (См. «Почему патчить движок, а не страницу».)

**Чем это отличается от Camoufox?** Та же идея перехвата на C++. Camoufox форкает Firefox (~3% трафика, постоянная аномалия), в то время как Fortress форкает Chromium и V8 (основной движок), поэтому User-Agent Chrome согласован по построению.

**Будет ли он проходить всё всегда?** Нет. Обнаружение постоянно развивается, поэтому мы поставляем датированный, воспроизводимый gauntlet и ежемесячный rebase Chromium; вы всегда можете точно увидеть, что проходит сегодня.

</details>

<details><summary><b>План развития</b></summary>

<br/>

- [ ] Конфигурация JSON времени выполнения в C++ `MaskConfig` (один бинарник, множество согласованных отпечатков, ничего в командной строке)
- [ ] Собственный MCP-сервер и SDK для Puppeteer / raw-CDP (замена для AI-агентов)
- [ ] Подписанные кодом Windows `.exe` и macOS `.app`
- [ ] Образ Docker `linux/arm64`
- [ ] Перенести `patches/` на переопределения в стиле Brave `chromium_src/`
- [ ] Опубликованные строки бенчмарков reCAPTCHA v3 / DataDome / Kasada (датированные, воспроизводимые)

</details>

<details><summary><b>Структура репозитория</b></summary>```
patches/     34 per-surface C++ patches (+ series), the source of truth for the fork
build/       args.gn, build.sh, apply-patches.sh, rebase-monthly.sh, windows/, macos/
packaging/   tilion launcher, fonts.conf, Dockerfile, .deb + bundle builders
fonts/       33 metric-compatible Windows-named fonts (incl. color emoji)
sdk/         python + node (tilion-fortress) prebuilt-binary SDKs
tools/       gauntlet.py, the CreepJS / Sannysoft / BrowserScan CI gate
docs/        GAUNTLET_RESULTS, BUILD_NATIVE, BENCHMARK