# إضافة Chrome (إصدار تجريبي)

> URL: https://foura.ai/ar/docs/dashboard/chrome-extension
> Updated: 2026-11-05
> Index: https://foura.ai/llms.txt

تضيف إضافة FourA لمتصفح Chrome أداتين إلى متصفحك. توجه **النافذة المنبثقة** متصفح Chrome عبر أحد مستخدمي الـ proxy لديك على [proxy port](https://foura.ai/docs/api/proxy-port). وتحول **علامة تبويب FourA في DevTools** أي طلب ترسل الصفحة إلى استدعاء API جاهز.

الإضافة في مرحلة تجريبية (beta). وهي غير متوفرة في Chrome Web Store بعد، لذا يثبتها Chrome في وضع المطور، ولا تزال شاشاتها وإعداداتها عرضة للتغيير. تتطلب Chrome بإصدار 116 أو أحدث وتعمل على جميع الخطط، بما في ذلك الخطة المجانية.

## التثبيت

يتوفر ملف zip في لوحة التحكم: افتح **Extension** أسفل **Tools** في الشريط الجانبي وانقر على **Download**.

1. نزل ملف zip وفك ضغطه. احتفظ بالمجلد: يقوم Chrome بتحميل الإضافة منه.
2. افتح `chrome://extensions` وفعل **Developer mode** من الزاوية العلوية اليمنى.
3. انقر على **Load unpacked** واختر المجلد بعد فك الضغط.
4. ثبت FourA من أيقونة قطعة الأحجية في شريط الأدوات. تكون الأيقونة رمادية عندما تكون FourA معطلة، وتعرض نقطة خضراء أثناء توجيه حركة المرور.

### التحديثات

تتحقق الإضافة من وجود إصدار جديد مرة كل ساعة وعند فتح النافذة المنبثقة، كما يتحقق خيار **Check now** ضمن **Version** في إعدادات النافذة المنبثقة مباشرة. عند توفر إصدار جديد، تعرض النافذة المنبثقة الإصدار مع زر **Download**. فك ضغط الإصدار الجديد واختر مجلده عبر **Load unpacked**. تحدث FourA نفسها وتحتفظ بإعداداتك أيا كان المجلد الذي أتى منه الإصدار الجديد. إذا قمت بفك ضغطه فوق المجلد الحالي، يكفي النقر على **Reload FourA**. وإذا كنت تقوم بالترقية من الإصدار 0.3.1 أو أقدم، فسيتم تثبيتها كبطاقة جديدة لمرة واحدة: اختر مستخدم الـ proxy مجددا وأزل البطاقة القديمة.

## قبل أن تبدأ

- مستخدم proxy. أنشئ مستخدما في صفحة **Proxy** داخل لوحة التحكم: راجع [Proxy](https://foura.ai/docs/dashboard/proxy).
- تسجيل الدخول إلى لوحة التحكم في متصفح Chrome نفسه. تقرأ الإضافة مستخدمي الـ proxy لديك من لوحة التحكم فقط. وفي حال عدم فتح أي علامة تبويب للوحة التحكم، فإنها تفتح واحدة في الخلفية لقراءتها ثم تغلقها مجددا.

## التصفح عبر FourA

تحتوي النافذة المنبثقة على ثلاث صفحات: **الاتصال** و**الموقع الجغرافي** و**الإعدادات**.

### الاتصال

1. افتح FourA من شريط الأدوات واختر مستخدم الـ proxy الذي يستخدمه هذا المتصفح.
2. اضغط على المفتاح الرئيسي.
3. طالع **Address sites see**. تقيس FourA هذا العنوان عبر النفق بدلا من افتراضه بناء على إعداداتك، وتعرض **Your address** بجانبه للمقارنة.

يوضح **Traffic this period** حجم حركة مرور الـ proxy المستهلكة من خطتك.

### الموقع الجغرافي

- **الشبكة:** **مشتركة** (مجموعتنا، حركة بيانات الخطة) أو **Premium** (عناوين سكنية، تُسحب من رصيد premium الخاص بخطتك). في الشبكة المشتركة، خيار **استخدام premium عندما يتعذر على المشتركة تحميل صفحة** يعتمد مخرج premium عند فشل الشبكة المشتركة في تمرير الطلب. يعمل هذا فقط إذا كانت خطتك تتضمن حركة بيانات premium مع بقاء رصيد متاح.
- **البلد:** أي بلد افتراضياً. البلدان المستخدمة مؤخراً متاحة بنقرة واحدة.
- **المنطقة** و**المدينة** و**مشغل الشبكة:** لحسابات premium فقط، بعد تحديد البلد.
- **العنوان:** خيار **الاحتفاظ بواحد** يثبت المخرج نفسه، وخيار **جديد مع كل طلب** يغيره عند كل طلب، وخيار **عنوان جديد** ينتقل لعنوان جديد فوراً. في premium مع تفعيل **الاحتفاظ بواحد**، يحدد **الاحتفاظ به لمدة** فترة تثبيت العنوان، بالدقائق أو الساعات.

الإعدادات المرتبطة بهذه الخيارات تطابق ما يوثقه منفذ proxy في [منفذ Proxy](https://foura.ai/docs/api/proxy-port).

### الإعدادات

- **ما يمر عبر النفق:** **كل شيء باستثناء** قائمة معينة، أو **هذه فقط**. يغطي `example.com` نطاقاته الفرعية، ويعمل `*` كرمز بديل (wildcard)، ويمثل `203.0.113.0/24` نطاقاً.
- **عدم تمرير الشبكة المحلية أو هذا الجهاز عبر النفق مطلقاً:** الأسماء بدون نقطة، و`localhost`، و`.local` ونطاقات العناوين الخاصة تظل على اتصالك المباشر، بصرف النظر عما تحتويه القائمة.
- **السماح لصفحات http:// العادية باستخدام اتصالي المباشر:** ينقل منفذ proxy الاتصالات المشفرة فقط. عند إيقاف الخيار، لا يتم تحميل صفحات `http://` العادية. عند تفعيله، يتم التحميل عبر اتصالك المباشر ويشاهد الموقع عنوانك الحقيقي.
- **منع WebRTC من الالتفاف على proxy:** يغلق مساراً يمكن للصفحة استغلاله لقراءة عنوانك الحقيقي أثناء تشغيل النفق.
- **نوافذ التصفح المتخفي:** تستخدم النفق أيضاً. لا يستطيع FourA تقديم كلمة مرور proxy هناك إلا بعد منح الإذن: `chrome://extensions`، ثم FourA، ثم **التفاصيل**، ثم **السماح في وضع التصفح المتخفي**. حتى ذلك الحين، سيطلب Chrome كلمة المرور في وضع التصفح المتخفي.
- **المظهر:** **النظام** أو **فاتح** أو **داكن** للنافذة المنبثقة.
- **عنوان proxy للأدوات الأخرى:** يظهر مستخدم proxy المحدد بصيغة URL الخاص بـ proxy مع كلمة المرور، للصقه في أي عميل يدعمه. عامله ككلمة مرور سرية.
- **مستخدمو proxy:** خيار **إعادة التحميل من لوحة التحكم** يجلب مستخدمي proxy الذين أنشأتهم أو عدلتهم. خيار **إلغاء الحفظ على هذا الكمبيوتر** يحذفهم من هذا المتصفح.

### عند تحول الأيقونة إلى اللون الأحمر

تشير الأيقونة الحمراء مع رقم إلى عدد الاتصالات التي رفضها proxy في الدقيقة الأخيرة. افتح FourA لمعرفة السبب. الأسباب الأكثر شيوعاً:

- **اتصالات متزامنة كثيرة جدًا:** تم تجاوز الحد المسموح به للأنفاق المفتوحة في خطتك. سيتم تحميل أجزاء من الصفحة مجددًا فور إغلاق الاتصالات.
- **اتصالات جديدة كثيرة جدًا خلال هذه الدقيقة:** تم تجاوز الحد المسموح به للأنفاق الجديدة في الدقيقة في خطتك. انتظر دقيقة قبل إعادة التحميل، لأن كل محاولة تُحسب أيضًا.
- **تم استنفاد حركة مرور proxy لهذه الفترة** أو **تم استنفاد حركة المرور المتميزة (Premium):** أضف رصيد حركة مرور من صفحة **Billing** أو انتظر الفترة التالية.
- **الـ proxy غير مشمول في خطتك:** راجع الخطط المتاحة في صفحة **Billing**.
- **لم يقبل الـ proxy كلمة المرور:** ربما تم تدوير مستخدم الـ proxy أو حذفه من لوحة التحكم. حدده مرة أخرى.
- **إضافة أخرى تتحكم في الـ proxy:** طالما تحتفظ إضافة أخرى بإعدادات proxy في Chrome، لن يوجه FourA أي حركة مرور. عطل تلك الإضافة، ثم أوقف المفتاح وأعد تشغيله.

تتوفر حدود خطتك الحالية في صفحة [Usage & Limits](https://foura.ai/docs/dashboard/quota).

## تحويل طلب إلى استدعاء API

1. افتح DevTools في أي صفحة واختر علامة تبويب **FourA**، بجوار Network (أو خلف `»` عندما تكون نافذة DevTools ضيقة). إذا كانت DevTools مفتوحة أثناء تثبيت FourA، فأغلقها وأعد فتحها.
2. أعد تحميل الصفحة. تعرض علامة التبويب طلبات الصفحة تمامًا كما تفعل Network. يكون خيار **Hide ads and analytics** مفعلاً افتراضيًا، ويقتصر خيار **This site only** على طلبات الصفحة نفسها.
3. اكتب نصًا تراه في الصفحة داخل حقل **Find in responses** للعثور على الطلب الذي يتضمنه. حدد الطلب لعرض **Headers** و **Payload** و **Response** الخاصة به.
4. أسفل **FourA call**، اختر المحرك (Single أو Proxy Finder أو Browser)، ولدعم Proxy Finder حدد **Exit country** اختياريًا، ثم انسخ الاستدعاء كصيغة curl أو Python أو Node أو MCP. يتضمن الاستدعاء الـ headers و cookies التي استخدمتها الصفحة. يكون خيار **Present the same browser and system as this window** مفعلاً افتراضيًا: يطلب الاستدعاء ملف تعريف المتصفح المطابق لنسخة Chrome هذه، أو يرسل User-Agent الخاص بهذه النافذة عند اختيار Browser.
5. انقر على **Open in the playground** لتحميل الاستدعاء في [Playground](https://foura.ai/docs/dashboard/playground) داخل لوحة التحكم، أو **Run through FourA** لتنفيذه. بعد التشغيل، يعرض **The browser got** و **FourA got** استجابة الصفحة واستجابتنا جنبًا إلى جنب.

يتيح النقر بزر الماوس الأيمن على أي طلب خيارات النسخ نفسها، بالإضافة إلى **Copy URL** و **Copy response** و **Open in a new tab**.

### مفتاح API للتشغيل

يستخدم خيار **Run through FourA** مفتاح API ورصيده. يمكنك ضبطه في **Settings** الخاصة بعلامة التبويب:

1. انقر على **Choose from your dashboard** وحدد مفتاحًا، أو الصق مفتاحًا في **Or paste an API key**.
2. حدد خيار **Keep the key on this computer** للاحتفاظ به بعد إغلاق Chrome. وبخلاف ذلك، سيظل محفوظًا حتى إغلاق Chrome فقط.
3. يؤدي خيار **Forget the key** إلى حذفه.

تفتح أداة Playground مع تحديد المفتاح نفسه إذا كان ينتمي إلى حسابك. وإلا، فستطلب منك اختيار مفتاح.

## التكلفة

الإضافة مجانية. تُحسب حركة المرور التي ترسلها عبر نقاط الخروج التابعة لنا ضمن حصة الـ proxy الخاصة بخطتك، تماما مثل أي عميل آخر على منفذ الـ proxy. التكلفة الناتجة عن عمليات الاستدعاء التي تشغلها من DevTools مطابقة لأسعار الـ API. راجع [الخطط والاحتساب](https://foura.ai/docs/guides/plans-and-metering).

## ما يتم تخزينه وإرساله

- يبقى مستخدم الـ proxy المختار وكلمة مروره على هذا الكمبيوتر.
- يبقى مفتاح الـ API الذي تختاره في علامة تبويب DevTools حتى يتم إغلاق Chrome، أو يُحفظ على هذا الكمبيوتر عند طلبك.
- لا يتم تخزين أو إرسال أي بيانات إلينا بخصوص الصفحات التي تزورها.
- تلقائيا، تستعلم الإضافة من ipinfo.io (أو Cloudflare ثم api.ipify.org عندما يكون الأول مشغولا) لمعرفة العنوان الذي يراه الموقع، وتستعلم من foura.ai مرة كل ساعة وعند فتح الإضافة للتحقق من الإصدار الحالي، وتقرأ مستخدمي الـ proxy وقائمة الدول من لوحة التحكم الخاصة بك، وتبحث عن عنوان الـ proxy عبر dns.google أو Cloudflare. كل شيء آخر يحدث فقط عند الضغط على زر ما.
- يؤدي نسخ استدعاء يتضمن ملفات cookie إلى إعادة تشغيل الجلسة التي سجلت الدخول إليها. تعامل معه ككلمة مرور ولا تلصقه في أي مكان عام.
- عند تغيير أحد الإعدادات أثناء تشغيل المفتاح، يمسح FourA بيانات اعتماد الـ proxy المحفوظة في Chrome لضمان وصول التحديد الجديد إلى الـ proxy. يشمل المسح عنوان الـ proxy فقط: تبقى ملفات cookie كما هي، وكذلك تسجيل دخولك إلى لوحة التحكم.

## القيود

- ينشئ متصفحك اتصاله المشفر الخاص عبر النفق، لذا يرى الموقع عنواننا ومتصفحك. الصفحات التي تتحقق من هوية المرسل، وتصيير المتصفح الكامل، تتم معالجتها بواسطة الـ API: راجع [فحوصات الموقع](https://foura.ai/docs/api/site-checks).
- متصفح Chrome هو الوحيد الذي صُممت الإضافة له واختُبرت عليه.
