بيانات الإعداد التي لم يحددها المستخدم سيتم ملؤها تلقائيًا باستخدام بصمات [BrowserForge](https://github.com/daijro/browserforge)، التي تحاكي التوزيع الإحصائي لخصائص الأجهزة في حركة المرور الواقعية.

[[اطلع على الخصائص المنفذة](https://camoufox.com/fingerprint/)]

---

## استخدام Python

يتوافق Camoufox مع كود Playwright الحالي لديك. كل ما عليك فعله هو تغيير تهيئة المتصفح.

**Sync API**```python
from camoufox.sync_api import Camoufox

with Camoufox() as browser:
    page = browser.new_page()
    page.goto("https://example.com")

[[التثبيت والاستخدام](https://camoufox.com/python/)]

### الاستفادة الكاملة من انتحال العتاد

للإصدارات المستقرة، يجب عليك دائمًا استخدام حزمة pip الرئيسية [`camoufox`](https://pypi.org/project/camoufox/). ومع ذلك، إذا كنت ترغب في الاستفادة من البصمات الخاصة بكل سياق وانتحال العتاد، فاستخدم حزمة [`cloverlabs-camoufox`](https://pypi.org/project/cloverlabs-camoufox/). يتم تحديث هذه الحزمة مع كل إصدار، بينما يتم إصدار الحزمة الرسمية مع تأخير.

تأكد من استخدام بيئة افتراضية لتجنب التعارض بين الحزمتين.

**التثبيت**```bash
pip install cloverlabs-camoufox

**الاستخدام** — واجهة البرمجة مطابقة للحزمة الأصلية:```python
from camoufox.sync_api import Camoufox

with Camoufox() as browser:
    page = browser.new_page()
    page.goto("https://example.com")

المكتبة توجّه تلقائيًا حسب إصدار الثنائي: Firefox ≥ 149 يحمّل `fingerprint-presets-v150.json` (312 إعدادًا مسبقًا تغطي v149–v152، 67 لنظام macOS / 180 لنظام Windows / 65 لنظام Linux)؛ الثنائيات الأقدم تعود إلى الحزمة الأصلية. تتم إعادة كتابة سلاسل UA لتطابق الثنائي النشط، لذا فإن الاشتراك آمن عبر الإصدارات. مرّر قاموس إعدادات مسبقة بدلاً من `True` لتثبيت بصمة معينة.

---

## القدرات

فيما يلي قائمة بالتصحيحات والميزات المنفذة في Camoufox.

### انتحال البصمة

- انتحال خصائص Navigator (الجهاز، المتصفح، اللغة المحلية، إلخ.)
- دعم محاكاة حجم الشاشة، الدقة، إلخ.
- انتحال معاملات WebGL، الامتدادات المدعومة، سمات السياق، وتنسيقات دقة التظليل.
- انتحال أحجام منفذ العرض الداخلية والخارجية للنافذة
- انتحال معدل عينة AudioContext، وزمن الإخراج، والحد الأقصى لعدد القنوات
- انتحال أصوات الأجهزة ومعدلات التشغيل
- انتحال عدد الميكروفونات وكاميرات الويب ومكبرات الصوت المتاحة.
- تتم انتحال ترويسات الشبكة (Accept-Languages و User-Agent) لتطابق خصائص navigator
- انتحال عنوان IP الخاص بـ WebRTC على مستوى البروتوكول
- انتحال الموقع الجغرافي والمنطقة الزمنية واللغة المحلية
- انتحال Battery API
- إلخ.

### تصحيحات التخفي

- يتجنب تسريبات التنفيذ في العالم الرئيسي. كل جافاسكربت وكيل الصفحة معزول (sandboxed)
- يتجنب تسريبات سياق تنفيذ الإطارات
- يصلح اكتشاف `navigator.webdriver`
- يصلح اكتشاف وضع headless في Firefox عبر نوع المؤشر ([#26](https://github.com/daijro/camoufox/issues/26))
- أزال تصحيحات معالجة منع التكبير/عرض meta viewport التي قد تُحدث تسريبات
- يستخدم أحجام شاشة ونافذة غير افتراضية
- يعيد تمكين عزل محتوى fission
- يعيد تمكين PDF.js
- تغيير خصائص إعدادات أخرى قد تُحدث تسريبات
- حركة مؤشر شبيهة بالبشر

### مكافحة بصمة الخطوط

- يستخدم تلقائيًا خطوط النظام الصحيحة لوكيل المستخدم الخاص بك
- مرفق مع خطوط أنظمة Windows و Mac و Linux
- يمنع بصمة مقاييس الخطوط عبر إزاحة عشوائية لتباعد الأحرف

### دعم Playwright

- تنفيذ مخصص لـ Playwright لأحدث إصدار من Firefox
- تصحيحات إعدادات متنوعة لتجنب اكتشاف البوتات

### إزالة التضخم/التحسينات

- أزال/عطّل _العديد والعديد_ من خدمات Mozilla. يعمل أسرع من Mozilla Firefox الأصلي ويستخدم ذاكرة أقل (200 ميجابايت)
- تصحيحات من LibreWolf و Ghostery للمساعدة في إزالة التتبع والانتفاخ
- إعدادات إزالة التضخم من PeskyFox و LibreWolf وغيرها
- تحسينات السرعة والشبكة من FastFox
- أزال جميع حركات CSS
- تنسيق بسيط (Minimalistic)
- إلخ.

### الإضافات

- تحميل إضافات Firefox بدون خادم تصحيح أخطاء عبر تمرير قائمة مسارات إلى خاصية `addons`
- أضاف uBlock Origin مع فلاتر خصوصية مخصصة
- لا يُسمح للإضافات بفتح تبويبات
- يتم تمكين الإضافات تلقائيًا في وضع التصفح الخاص
- يتم تثبيت الإضافات تلقائيًا على شريط الأدوات
- يصلح تسريبات DNS مع جلب uBO المسبق

### واجهة بايثون

- يولّد ويحقن تلقائيًا خصائص جهاز فريدة في Camoufox بناءً على توزيعها الواقعي
- حقن بصمة WebGL وتدويرها
- يستخدم خطوط النظام الصحيحة ومزج الألوان الفرعي (subpixel antialiasing) والتوجيه (hinting) بناءً على نظام التشغيل المستهدف
- يتجنب اكتشاف البروكسي عبر حساب الموقع الجغرافي والمنطقة الزمنية واللغة المحلية المستهدفة من منطقة البروكسي المستهدفة
- يحسب وينتحل لغة المتصفح بناءً على توزيع المتحدثين باللغة في المنطقة المستهدفة للبروكسي
- استضافة خادم بعيد لاستخدام Camoufox مع لغات أخرى تدعم Playwright
- مخزن عرض افتراضي مدمج لتشغيل Camoufox بواجهة رسومية على خادم بدون واجهة
- تبديل تحميل الصور و WebRTC و WebGL
- إلخ.

> [!NOTE]
> لا يدعم Camoufox **بشكل كامل** حقن بصمات Chromium. بعض أنظمة WAF (مثل [Interstitial](https://nopecha.com/demo/cloudflare)) تفحص سلوك محرك Spidermonkey، وهو أمر يستحيل انتحاله.

---

# نظرة عامة على التخفي

## كيف يُخفي Camoufox مكتبة الأتمتة الخاصة به

> [!WARNING]
> **الحالة الحالية اعتبارًا من 2026**:
> حدثت فجوة استمرت عامًا في الصيانة بسبب ظرف شخصي. انخفض أداء Camoufox بسبب إصدار Firefox الأساسي وعدم اتساق بصمات مكتشف مؤخرًا. **Camoufox قيد التطوير النشط حاليًا.**

في Camoufox، تكون جميع أكواد وكيل الصفحة الداخلية لـ Playwright معزولة ومفصولة. وهذا يجعل من المستحيل على الصفحة اكتشاف وجود Playwright عبر فحص الجافاسكربت.

عادةً، يحقن Playwright بعض الجافاسكربت في الصفحة مثل `window.__playwright__binding__` لتنفيذ إجراءات مثل الاستعلام عن العناصر، أو تقييم الجافاسكربت، أو تشغيل سكربتات التهيئة، وهو ما يمكن أن تكتشفه المواقع. في Camoufox، تتم معالجة هذه الإجراءات في نطاق معزول خارج الصفحة. بعبارة أخرى، لم يعد بإمكان المواقع "رؤية" أي جافاسكربت يحقنه Playwright عادةً. وهذا يمنع آثار Playwright تمامًا.

ومع ذلك، حتى مع إخفاء مكتبة الأتمتة، فإن Camoufox ليس محصّنًا ضد عدم اتساق تدوير البصمات. وهذا لا يزال يتطلب صيانة لاكتشافه وإصلاحه.

### تفاعلات الصفحة

تعمل أنظمة مكافحة البوتات أيضًا على تشغيل سكربتات من جهة العميل لمراقبة سلوكك. على سبيل المثال، تبحث عن أنماط في حركات الماوس، والنقرات، والتمرير، والتوقيت بين الإجراءات.

<video controls src="https://github.com/user-attachments/assets/6d33d6af-3537-4603-bf24-6bd3f4f8f455" width="200px" loop muted></video>

يبذل Camoufox قصارى جهده في خوارزمية حركة الماوس الشبيهة بالبشر. خوارزمية الحركة الطبيعية مأخوذة أصلًا من [HumanCursor الخاص بـ riflosnake](https://github.com/riflosnake/HumanCursor) وأُعيدت كتابتها بلغة C++ وعدّلت لمسارات أكثر إدراكًا للمسافة.

ومع ذلك، هذا ليس مثاليًا. قد يظل قابلاً للاكتشاف مع تحليل متطور بما يكفي. (عمل قيد التقدم للمستقبل)

---

## كيف يدوّر Camoufox الهويات

تحتاج وكلاء الذكاء الاصطناعي إلى العمل عبر جلسات عديدة دون التعرض للإبلاغ أو تقييد المعدل. تدوير عنوان IP الخاص بك ليس كافيًا — كل جلسة متصفح تحمل آلاف الإشارات التي تنشئ **بصمة** فريدة. يمكن للموقع رؤية نظام التشغيل، وحدة معالجة الرسومات، دقة الشاشة، الخطوط، المنطقة الزمنية، والمزيد. إذا كانت هذه الإشارات غير متسقة أو غير معتادة، فسيتم حظرك.

### توزيع الحصة السوقية

حتى لو كنت تدوّر عنوان IP لكل مثيل بوت يعمل، يمكن لجدران حماية الوصول للويب استخدام تعلّم الآلة لتحليل حركة المرور الواردة لاكتشاف ما إذا كانت غير طبيعية. إذا كانت حصة Linux السوقية 5% ثم أصبحت فجأة 20%، فهذا مؤشر خطر. سيطالبون جميع مستخدمي Linux دون قيد أو شرط بإكمال كابتشا.

يستخدم Camoufox مولّد بصمات [BrowserForge](https://github.com/daijro/browserforge) لمحاكاة التوزيع الإحصائي لبيانات الأجهزة في حركة المرور الواقعية. على سبيل المثال، سيجعل Camoufox متصفحك يبدو كمستخدم Linux بنسبة 5% من الوقت. ومن هذه الـ 5%، سينتحل دقة شاشة 2560x1440 بنسبة 9.5% من الوقت ووحدة معالجة رسومات Intel HD بنسبة 27.5% من الوقت.

### كيف يمكن اكتشاف Camoufox؟

يمكن لـ Camoufox انتحال بصمات بحصة سوقية صحيحة. ومع ذلك، **يجب أن تكون البصمات متسقة داخليًا أيضًا.** وكيل مستخدم Windows مع وحدة معالجة رسومات Apple M1، ووكيل مستخدم MacOS مع عارض DirectX الخاص بـ Windows، وجهاز محمول بدقة شاشة سطح مكتب — كلها مستحيلة، وستُعلَّم باعتبارها مريبة.

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

---

## كيف يقارن Camoufox بالحلول الأخرى؟

### الحلول القائمة على الجافاسكربت

في الماضي، حاول المطورون حقن الجافاسكربت لانتحال هذه القيم، لكنه لا يعمل بشكل موثوق لأن الجافاسكربت لا يمكنه انتحال كل شيء. التغطية غير المكتملة تسبب بصمات غير متسقة. على سبيل المثال، سيقوم نظام مكافحة البوتات بوضع علامة عليك إذا كان User Agent لطلب الشبكة لا يطابق User Agent الخاص بـ navigator.

بالإضافة إلى ذلك، يمكن اكتشاف جميع الجافاسكربت المحقونة بطريقة ما. يمكن لأنظمة مكافحة البوتات التحقق مما إذا كان `Object.getOwnPropertyDescriptor` يكشف عن خاصية مكتوبة فوق أخرى، أو إذا كانت دالة `toString()` لم تعد تُرجع `[native code]` (مما يكشف أنها اختُطفت)، أو إذا كانت البيانات في سياق النافذة لا تطابق سياق خيط العامل (worker thread). الحلول البديلة لا توصلك إلا إلى حد معين، لكن سيكون هناك دائمًا طريقة لاكتشاف حقن الجافاسكربت إذا بحثت بعمق كافٍ.

#### نهج Camoufox

نظرًا لأن Camoufox يعترض الاستدعاءات على مستوى تنفيذ C++ للمتصفح، فإن جميع الكائنات والخصائص المختطفة تظهر أصلية. لا يوجد اختطاف جافاسكربت يمكن اكتشافه.

يحاول Camoufox أيضًا توليد بصمات متسقة وقابلة للتصديق باستخدام Browserforge. ومع ذلك، لا يزال هذا قابلاً للاكتشاف عبر طرق معقدة لاكتشاف البصمات مثل عدم تطابق البيانات (كما وصفنا سابقًا).

<hr width=50>

### المكتبات القائمة على CDP

CDP (بروتوكول أدوات مطوري Chrome) هو بروتوكول أتمتة مدمج في Chromium و Firefox. ومع ذلك، لا يبذل CDP أي جهد لإخفاء حقيقة أنه بروتوكول أتمتة، ويعرض الكثير من وظائفه في نطاق الصفحة. بعض الطرق الشائعة هي التحقق مما إذا كان `navigator.webdriver` صحيحًا، أو اكتشافه أثناء قراءة مصحح الأخطاء المكدسي (stack debugger)، أو فحص متغيرات يحقنها ChromeDriver في كائن المستند للاتصال الداخلي، والمزيد.

#### نهج Camoufox

بينما يستخدم Playwright بروتوكول CDP للتحكم في Chromium، فإنه يستخدم _Juggler_ لـ Firefox. Juggler هو بروتوكول مخصص طُوّر قبل أن يدعم Firefox بروتوكول CDP ([المستودع الأصلي](https://github.com/puppeteer/juggler)). وهو وحدة مميزة داخل Firefox، وليست جزءًا من نواة المتصفح. وهذا يجعل من الأسهل تعديل والتحكم فيما يُكشف للصفحة.

يصحّح Camoufox Juggler ليمنحه "نسخة" معزولة خاصة به من الصفحة للعمل عليها. يمكن لـ Playwright قراءة وتعديل نسخته الخاصة من الصفحة بحرية. يبدو كل شيء يعمل بشكل طبيعي بالنسبة له، لكن الصفحة الحقيقية غير متأثرة تمامًا بهذه التغييرات. كما لا يمكن للصفحة اكتشاف متى تتم قراءة الأشياء (عبر حيل مثل اختطاف الـ getters) أو إضافة مستمعين لمراقبة العناصر.

بالإضافة إلى ذلك، يرسل Juggler مدخلاته مباشرة عبر معالجات إدخال المستخدم الأصلية في Firefox، مما يعني أنها تُعالج بالطريقة نفسها تمامًا كما لو كنت تستخدم المتصفح بشكل طبيعي. كما يصحّح Camoufox وضع headless في Firefox ليبدو كما لو كان يعمل في نافذة عادية. ولكن كخطة احتياطية، يمكن لمكتبة بايثون تشغيل Camoufox في [شاشة افتراضية](https://camoufox.com/python/virtual-display/) إذا تسرب وضع headless يومًا ما.

---

<h1 align="center">نظام البناء</h1>

> [!WARNING]
> المحتوى أدناه مخصص للمهتمين ببناء وتصحيح أخطاء Camoufox. لتعليمات استخدام Playwright، انظر [هنا](https://github.com/daijro/camoufox/tree/main/pythonlib#camoufox-python-interface).

### نظرة عامة

فيما يلي رسم تخطيطي لنظام البناء وأوامر make المرتبطة به:```mermaid
graph TD
    FFSRC[Firefox Source] -->|make fetch| REPO

    subgraph REPO[Camoufox Repository]
        PATCHES[Fingerprint masking patches]
        ADDONS[uBlock & B.P.C.]
        DEBLOAT[Debloat/optimizations]
        SYSTEM_FONTS[Win, Mac, Linux fonts]
        JUGGLER[Patched Juggler]
    end

    subgraph Local
    REPO -->|make dir| PATCH[Patched Source]
    PATCH -->|make build| BUILD[Built]
    BUILD -->|make package-linux| LINUX[Linux Portable]
    BUILD -->|make package-windows| WIN[Windows Portable]
    BUILD -->|make package-macos| MAC[macOS Portable]
    end

بعد ذلك، قم ببناء الكود المصدري لـ Camoufox باستخدام الأمر التالي:```bash
make dir

> [!NOTE]
> لم يتم اختبار مثبّت التبعيات حتى الآن إلا على نظام macOS.

بعد ذلك، عليك تهيئة نظامك لتتمكن من بناء Camoufox. ما عليك سوى القيام بذلك مرة واحدة فقط، ويتم ذلك عن طريق تشغيل الأمر التالي:```bash
make bootstrap

بالنسبة للبناءات الجديدة، `i686` مدعوم فقط لنظام Windows. يتم تخطي مجموعات الهدف/البنية غير المدعومة.

<details>
<summary>
معلمات CLI
</summary>```bash
Options:
  -h, --help            show this help message and exit
  --target {linux,windows,macos} [{linux,windows,macos} ...]
                        Target platforms to build
  --arch {x86_64,arm64,i686} [{x86_64,arm64,i686} ...]
                        Target architectures to build for each platform
  --bootstrap           Bootstrap the build system
  --clean               Clean the build directory before starting

Example:
$ python3 multibuild.py --target linux windows macos --arch x86_64 arm64

2. ابنِ رقع Camoufox لمنصة وبنية معمارية مستهدفة:```bash
docker run -v "$(pwd)/dist:/app/dist" camoufox-builder --target <os> --arch <arch>

يمكن تعديل التصحيحات وإنشاؤها وإزالتها وإدارتها من هنا.

<img src="https://assets.kitploit.com/production/public/readmes/41473/19bffc384c42fb6eb69b3ee59622daed4770cf0f11ffe39401eca57a7d2457f4.png">

### كيفية إنشاء تصحيح

1. في واجهة المطور، انقر على **إعادة تعيين مساحة العمل**.
2. قم بإجراء التغييرات اللازمة في مجلد `camoufox-*/`. يمكنك اختبار تغييراتك باستخدام `make build` و `make run`.
3. بعد الانتهاء من إجراء التغييرات، انقر على **كتابة مساحة العمل إلى تصحيح** واحفظ ملف التصحيح.

### كيفية العمل على تصحيح موجود

1. في واجهة المطور، انقر على **تحرير تصحيح**.
2. اختر التصحيح الذي تريد تحريره. ستتم إعادة تعيين مساحة العمل إلى حالة التصحيح المحدد.
3. بعد الانتهاء من إجراء التغييرات، اضغط على **كتابة مساحة العمل إلى تصحيح** واستبدل ملف التصحيح الموجود.

---

## تصحيح أخطاء التسريب

هذا مخطط تدفق يوضح عمليتي لتحديد التسريبات دون إزالة تشويش جافاسكريبت WAF. تعيد الطريقة تقديم ميزات Camoufox تدريجيًا إلى الكود المصدري لفايرفوكس حتى يرفع موقع الاختبار علامة التنبيه.

تتطلب هذه العملية نظام لينكس ويفترض أنك قمت بتثبيت أدوات بناء فايرفوكس (انظر [هنا](https://github.com/daijro/camoufox?tab=readme-ov-file#build-cli)).

<details>
<summary>
انظر مخطط التدفق...
</summary>```mermaid
flowchart TD
    A[Start] --> B[Does website flag in the official Firefox?]
    B -->|Yes| C[Likely bad IP/rate-limiting. If the website fails on both headless and headful mode on the official Firefox distribution, the issue is not with the browser.]
    B -->|No| D["Run make ff-dbg(1) and build(2) a clean distribution of Firefox. Does the website flag in Firefox **headless** mode(4)?"]
    D -->|Yes| E["Does the website flag in headful mode(3) AND headless mode(4)?"]
    D -->|No| F["Open the developer UI(5), apply config.patch, then rebuild(2). Does the website still flag(3)?"]
    E -->|No| G["Enable privacy.resistFingerprinting in the config(6). Does the website still flag(3)?"]
    E -->|Yes| C
    G -->|No| H["In the config(6), enable FPP and start omitting overrides until you find the one that fixed the leak."]
    G -->|Yes| I[If you get to this point, you may need to deobfuscate the Javascript behind the website to identify what it's testing.]
    F -->|Yes| K["Open the developer UI, apply the playwright bootstrap patch, then rebuild. Does it still flag?"]
    F -->|No| J["Omit options from camoufox.cfg(6) and rerun(3) until you find the one causing the leak."]
    K -->|No| M[Juggler needs to be debugged to locate the leak.]
    K -->|Yes| L[The issue has nothing to do with Playwright. Apply the rest of the Camoufox patches one by one until the one causing the leak is found.]
    M --> I