**[→ 完整发布说明](https://github.com/tiliondev/fortress/releases/tag/v151.0.7908.0)**


## 目录

| | |
|---|---|
| **[它是什么](#what-it-is)** · **[快速入门](#quick-start)** | 介绍、安装、第一个脚本、AI代理设置 |
| **[Fortress MCP 协议](#the-fortress-mcp--stealth-browsing-as-agent-tools)** | 面向AI代理的29个隐形浏览器工具（测试版） |
| **[为什么修补引擎而非页面](#why-patch-the-engine-not-the-page)** | 自我暴露JS论点 + 三层检测机制 |
| **[Fortress 与其他方案对比](#how-fortress-compares)** | 对比 puppeteer-stealth · Camoufox · CloakBrowser · 闭源供应商 |
| **[证明：实时检测结果](#proof-live-detector-results)** | CreepJS / Sannysoft / BrowserScan / Cloudflare 及截图 |
| **[配置身份特征](#configure-the-persona)** | `--uxr-*` 指纹表面 |
| **[适配你的技术栈](#works-with-your-stack)** | browser-use · Crawl4AI · Stagehand · LangChain |
| **[构建与验证](#build--verify)** | 从源码复现、验证来源 |
| **[参考](#reference)** | 故障排除 · 常见问题 · 路线图 · 仓库结构 |

---

## 它是什么

Fortress 是一个 Chromium 分支，从引擎内部伪造浏览器指纹。机器人检测器读取的表面（canvas、WebGL、音频、字体、navigator 以及约三十余项）均在 Chromium 的 **C++** 层中被修正，无需在页面之上叠加 JavaScript 补丁层，以免被页面捕获。

它以普通浏览器二进制文件形态发布，暴露 CDP 端点。将 Playwright、Puppeteer 或任何 CDP 客户端指向它，现有自动化代码无需修改即可运行。

JavaScript 隐身补丁会留下一个页面可发现的额外层：`.toString()` 显示覆盖代码的源码，从 iframe 或 worker 重新读取同一原始对象可绕过补丁。Fortress 直接在引擎中修正表面，因此 `navigator.vendor` 解析为真实的 C++ 访问器，报告 `[native code]`，且从每个 realm 读取结果一致。自检页面看到的将是标准 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/`**，因此你可以自行重新构建引擎，并根据源代码验证每一项表层修正。下载文件会自动通过 `SHA256SUMS` 进行 SHA-256 校验。

### 版本

Fortress 基于 **两个 Chromium 内核版本** 发布——根据隐匿性与最新性之间的权衡进行选择：

| 频道 | Chromium 版本 | 使用场景 |
|---|---|---|
| **`stable`** *(默认)* | **149** | 推荐 —— 与大多数真实用户运行的 Chrome 版本一致，因此隐匿性最佳 |
| **`latest`** | **151** | 最新引擎（报告版本略高于稳定版） |```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>

Raw 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`。

### 代理获取的内容

| | 工具 |
|---|---|
| **获取被屏蔽的页面** | `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` → 用于Playwright / Puppeteer / browser-use的CDP URL |

工具带有注释（读取自动批准，写入门控），启动时**预加热**（首次调用约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` | 原生getter在错误的`this`上会抛出一个特定的`TypeError`；简单的垫片保持沉默，而沉默就是信号。 |
| 域重新获取 | 检测器从另一个域中抓取一个原始原语，并在你的函数上使用它： |```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.

| 环境变量 | 用途 |
|---|---|
| `TILION_NO_DEFAULTS=1` | 跳过默认角色（裸启动） |
| `TILION_TZ` / `TILION_LANG` | 快速时区/语言覆盖 |

> [!NOTE]
> **当前角色通过命令行传递。** `--uxr-*` 开关通过 `/proc/<pid>/cmdline` 对所有进程可读，因此每次启动只能设置一个角色，并且对主机上的其他进程可见。`MaskConfig` 运行时即将到来：它将通过 IPC 传递角色，打破每个进程一个角色的限制（参见[下一步计划](#whats-next)）。

---

## 与您的技术栈配合使用

Fortress 在 `:9222` 上暴露原始 CDP，因此它可以嵌入任何支持 Playwright、Puppeteer 或 CDP 的工具。

| 框架 | 连接方式 |
|---|---|
| [**browser-use**](https://github.com/browser-use/browser-use)（约7万星） | `cdp_url="http://localhost:9222"` |
| [**Crawl4AI**](https://github.com/unclecode/crawl4ai)（约5.8万星） | CDP 端点 |
| [**Stagehand**](https://github.com/browserbase/stagehand)（约2.1万星） | `connectOverCDP` |
| [**LangChain**](https://github.com/langchain-ai/langchain) Playwright 工具包 | 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/`），因此大部分补丁可以在上游版本中干净地重新应用；然后，这套严苛的流程会在检测到任何回归时阻止发布。

| 平台 | 状态 |
|---|---|
| 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 通过四个官方渠道发布。其他任何来源都视为不可信：

| | 官方来源 |
|---|---|
| **Source** | [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`，并且 `pip`/`npm` SDK 会在安装时自动为您运行此验证：```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

**或不信任任何东西，自行构建。** 整个分支包含 `patches/` 目录下的 34 个可读补丁；`build/build.sh` 从 Chromium 源码重现二进制文件，因此你可以将构建结果与我们提供的进行对比。

---

## Reference

<details><summary><b>Troubleshooting</b></summary>

<br/>

**仍然被 Cloudflare、DataDome 或 Kasada 拦截。** 大多数情况下是你的 **IP**，而不是指纹：数据中心 IP 段在页面脚本运行前就会被标记。请通过住宅或移动代理路由出口流量并重试；如果问题解决，则指纹是正常的。

**指纹在 Linux 主机上看起来异常。** 默认用户画像（persona）是 Windows，但 TLS 形状和一些面向操作系统的信号会跟随底层机器。请将用户画像与出口流量的操作系统匹配，或设置相应的 `--uxr-*` 标志，使操作系统信息与流量出口一致。

**macOS 拉取 Docker 镜像。** 目前原生 Linux + Windows 二进制文件已发布；macOS 仍需要通过官方 Docker 镜像（`tilion/fortress`）运行 Fortress。请安装 Docker Desktop，或在 Linux/Windows x64 上运行以使用原生二进制文件。

**用户画像出现在 `/proc/<pid>/cmdline` 中。** `--uxr-*` 标志在主机上对其他进程可见，每个启动对应一个用户画像。在运行时 `MaskConfig` 落地之前，请保持每个进程一个用户画像，并避免与不可信代码共享主机。

**检测器标记了某个测试通过的内容。** 检测手段在不断发展。请确认你使用的是最新的 Chromium 重置版本，然后使用测试页面提交 issue。该页面将成为下一个补丁。

</details>

<details><summary><b>FAQ</b></summary>

<br/>

**这是否合法？** Fortress 是一个浏览器工程项目，用于合法的自动化、测试和公开数据抓取。请尊重每个网站的服务条款以及您所在司法管辖区的法律。

**它真的免费吗？** 是的。BSD-3 许可，完全开源，可自行托管。补丁系列已发布，因此你可以自己从源码构建当前引擎。

**为什么不直接使用 puppeteer-stealth 或 undetected-chromedriver？** 它们在页面可以检查浏览器之后才修补 JS/CDP 层，因此会通过 `toString` 和 realm 重新获取暴露自身。Fortress 将伪装移入 C++，页面看到的是原生代码。（参见“为什么要修补引擎，而不是页面”）

**这与 Camoufox 有何不同？** 相同的 C++ 拦截思路。Camoufox 基于 Firefox 分支（约占 3% 流量，一直是个异常），而 Fortress 基于 Chromium 和 V8（主流引擎），因此 Chrome 用户代理从构造上是一致的。

**它会永远通过所有检测吗？** 不会。检测技术不断进步，因此我们提供带日期、可复现的测试套件和每月一次的 Chromium 重置；你随时可以看到当前通过的内容。

</details>

<details><summary><b>Roadmap</b></summary>

<br/>

- [ ] 运行时 JSON 配置集成到 C++ `MaskConfig`（一个二进制文件，多个一致的指纹，命令行无痕迹）
- [ ] 第一方 MCP 服务器以及 Puppeteer / 原生 CDP SDK（可直接用于 AI 代理）
- [ ] 已签名的 Windows `.exe` 和 macOS `.app`
- [ ] `linux/arm64` Docker 镜像
- [ ] 将 `patches/` 迁移到 Brave 风格的 `chromium_src/` 覆盖
- [ ] 发布 reCAPTCHA v3 / DataDome / Kasada 基准测试行（带日期，可复现）

</details>

<details><summary><b>Repo layout</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