**[→ ملاحظات الإصدار الكاملة](https://github.com/tiliondev/fortress/releases/tag/v151.0.7908.0)**


## المحتويات

| | |
|---|---|
| **[ما هو](#what-it-is)** · **[بداية سريعة](#quick-start)** | ما هو، التثبيت، أول سكريبت، إعداد وكيل الذكاء الاصطناعي |
| **[The Fortress MCP – stealth browsing as agent tools](#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 · البائعين المغلقين |
| **[إثبات: نتائج الكاشف المباشر](#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, audio, fonts, navigator، وحوالي ثلاثين أخرى) في **C++** الخاص بـ Chromium، بدون طبقة تصحيح JavaScript موضوعة في الأعلى لتتمكن الصفحة من اكتشافها.

يتم شحنه كملف ثنائي متصفح عادي يعرض نقطة نهاية CDP. قم بتوجيه Playwright أو Puppeteer أو أي عميل CDP إليه وستعمل أتمتتك الحالية دون تغيير.

يترك تصحيح JavaScript الخفي طبقة إضافية يمكن للصفحة العثور عليها: يُظهر `.toString()` مصدر التجاوز، وإعادة الحصول على نفس البدائية من iframe أو worker تتجاوزها. تقوم Fortress بتصحيح السطح في المحرك بدلاً من ذلك، لذا فإن `navigator.vendor` يحل إلى getter 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/`**، مما يسمح لك بإعادة بناء المحرك بنفسك والتحقق من كل تصحيح سطحي مقابل المصدر. يتم التحقق من التنزيلات باستخدام SHA-256 مقابل ملف `SHA256SUMS` الخاص بالإصدار تلقائياً.

### الإصدارات

يُصدر Fortress على **قاعدتين كروميوم** — اختر المفاضلة بين الاندماج والحداثة:

| القناة | كروميوم | متى تستخدم |
|---|---|---|
| **`stable`** *(افتراضي)* | **149** | موصى به — يتطابق مع إصدار كروم الذي يستخدمه غالبية المستخدمين الحقيقيين، لذا فهو ينصهر بشكل أفضل |
| **`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

---

## The Fortress MCP — تصفح متخفي كأدوات وكيل &nbsp;<sub>Beta</sub>

بروتوكول CDP الخام مخصص للكود الذي تكتبه. أما **Fortress MCP** فهو للوكلاء الذين يستدعون **الأدوات**: خادم [بروتوكول سياق النموذج](https://modelcontextprotocol.io) يمنح Claude أو Cursor أو أي عميل MCP متصفحًا متخفيًا، بحيث بمجرد حظر جلب (fetch)، فإنه يستدعي أداة ويحصل على الصفحة. **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>الحصن</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` (العثور على API JSON الخاص) |
| **قيادة صفحة** | `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 لـ 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 re-acquisition) هي التي تهزم كل تصحيحات العالم الرئيسي. يلتقط الكاشف أولية نقية من عالم آخر ويوجهها إلى دالتك:```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 عن CDP الخام على `:9222`، لذا فهو يعمل تحت أي شيء يستخدم Playwright أو Puppeteer أو CDP.

| الإطار | الاتصال عبر |
|---|---|
| [**browser-use**](https://github.com/browser-use/browser-use) (حوالي 70 ألف نجمة) | `cdp_url="http://localhost:9222"` |
| [**Crawl4AI**](https://github.com/unclecode/crawl4ai) (حوالي 58 ألف نجمة) | نقطة نهاية CDP |
| [**Stagehand**](https://github.com/browserbase/stagehand) (حوالي 21 ألف نجمة) | `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/`)، لذا معظمها يُعاد تطبيقها بسلاسة عبر إصدارات المنبع؛ ثم يمنع 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`، وتقوم أدوات `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` بإعادة إنتاج الثنائي من مصدر كروميوم، لذا يمكنك مقارنة ما بنيته مع ما نرسله.

---

## مرجع

<details><summary><b>استكشاف الأخطاء وإصلاحها</b></summary>

<br/>

**لا يزال محظورًا على Cloudflare أو DataDome أو Kasada.** في معظم الأحيان، يكون هذا هو **عنوان IP** الخاص بك، وليس بصمتك: حيث يتم وضع علامة على نطاق مركز البيانات قبل تشغيل أي نص للصفحة. وجّه حركة المرور الخارجة عبر بروكسيات سكنية أو محمولة وأعد المحاولة؛ إذا تمت إزالة الحظر، فالبصمة كانت جيدة.

**تبدو البصمة غير صحيحة على مضيف لينكس.** الشخصية الافتراضية هي Windows، ولكن شكل TLS وبعض الإشارات الموجهة لنظام التشغيل تتبع الجهاز الأساسي. طابق الشخصية مع نظام تشغيل الخروج، أو قم بتعيين العلامات `--uxr-*` المناسبة بحيث يتوافق سرد نظام التشغيل مع مكان مغادرة حركة المرور منه.

**macOS يسحب صورة Docker.** يتم توزيع ثنائيات لينكس الأصلي وويندوز اليوم؛ لا يزال macOS يشغل Fortress عبر صورة Docker الرسمية (`tilion/fortress`). قم بتثبيت Docker Desktop، أو قم بتشغيله على لينكس/ويندوز x64 للحصول على الثنائي الأصلي.

**تظهر الشخصية في `/proc/<pid>/cmdline`.** العلامات `--uxr-*` قابلة للقراءة بواسطة عمليات أخرى على المضيف، شخصية واحدة لكل إطلاق. حتى يتم تطبيق `MaskConfig` في وقت التشغيل، احتفظ بشخصية واحدة لكل عملية وتجنب مشاركة المضيف مع كود غير موثوق.

**يكتشف كاشف شيئًا يمر به الاختبار القاسي.** طرق الكشف تتطور. تأكد من أنك على أحدث إعادة بناء لكروميوم، ثم افتح مشكلة مع صفحة الاختبار. تصبح تلك الصفحة التصحيح التالي.

</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 (المحرك الأغلبية)، لذا فإن وكيل مستخدم Chrome متماسك بالبناء.

**هل سيتجاوز كل شيء إلى الأبد؟** لا. طرق الكشف تتطور باستمرار، لذا نرسل اختبارًا قاسيًا مؤرخًا وقابلًا للتكرار وإعادة بناء شهري لكروميوم؛ يمكنك دائمًا رؤية ما يعمل بالضبط اليوم.

</details>

<details><summary><b>خريطة الطريق</b></summary>

<br/>

- [ ] تكوين JSON في وقت التشغيل إلى `MaskConfig` في C++ (ثنائي واحد، بصمات متماسكة متعددة، لا شيء على سطر الأوامر)
- [ ] خادم MCP من الطرف الأول بالإضافة إلى Puppeteer / حزم SDK لـ raw-CDP (بديل جاهز لوكلاء الذكاء الاصطناعي)
- [ ] ملفات `.exe` لـ Windows و `.app` لـ macOS موقعة برمجيًا
- [ ] `linux/arm64` Docker image
- [ ] نقل `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