Ferret

الوكيل الوسيط (MITM) التعاوني لمختبرات الاختراق الأمني.

التقط حركة HTTP، وأضف تعليقات توضيحية للطلبات باستخدام الذكاء الاصطناعي، ونفذ جلسات صيد (hunt)، وأعد تشغيل حركة المرور، وتتبع النتائج من واجهة واحدة.

بداية سريعة · الميزات · لقطات الشاشة · الإعدادات · الأمان · المساهمة

---

بداية سريعة

التثبيت

git clone https://github.com/synlace/ferret.git
cd ferret

cp .env.example .env   # اختياري
just up

أو استخدم Docker Compose مباشرة:

docker compose up --build -d

فتح Ferret

الخدمة	الرابط
الواجهة (UI)	http://localhost:3000
API	http://localhost:8000
الوكيل (Proxy)	127.0.0.1:1337

افتح:

http://localhost:3000

سيطلب منك معالج الإعداد الأولي تعيين كلمة مرور واختيار مزود ذكاء اصطناعي.

المتطلبات

• Docker
• Docker Compose
• just

---

نظرة عامة

Ferret هو وكيل اعتراض HTTP بمساعدة الذكاء الاصطناعي، مصمم لمختبرات الاختراق الأمني.

وجّه متصفحك أو أداة سطر الأوامر أو سير عمل الاختبار إلى:

127.0.0.1:1337

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

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

---

الميزات

الميزة	الوصف
وكيل اعتراض	التقاط حركة HTTP وHTTPS عبر mitmproxy.
سجل الطلبات	تصفح وتصفية وفحص وإعادة تشغيل حركة المرور الملتقطة.
تعليقات AI	إثراء الطلبات بسياق ذي صلة بالأمان.
صيد (Hunts)	تشغيل جلسات صيد بمساعدة الذكاء الاصطناعي عبر حركة المرور الملتقطة.
نتائج (Findings)	تتبع الثغرات مع درجة الخطورة والمضيف والنوع والدليل والحالة.
Snare	اعتراض وتعديل الطلبات أو الاستجابات أثناء التدفق.
Gnaw	علامات تبويب على نمط المكرر لتعديل وإعادة إرسال طلبات HTTP.
مساحات العمل (Workspaces)	أدلة scripts/ و tests/ و notes/ لكل جلسة.
المشاريع (Projects)	فصل سجل الطلبات والنتائج ومساحات العمل ومفاتيح API.
المصادقة	تسجيل الدخول بكلمة مرور، وملفات تعريف الارتباط للجلسة، ووصول اختياري عبر مفتاح API، وTOTP 2FA.
تخزين محلي أولاً	بيانات مدعومة بقاعدة SQLite مخزنة في دليل محلي مربوط (bind-mounted).

---

لقطات الشاشة

الصيد (Hunts) - جلسات صيد بمساعدة الذكاء الاصطناعي تبحث في سجل الطلبات، وتكتب وتشغل الاختبارات، وتنشئ النتائج.

---

السجل (History) - سجل كامل لطلبات الوكيل مع تعليقات AI والتوقيت ورموز الحالة ومحررين مدمجين للطلب/الاستجابة.

---

النتائج (Findings) - متتبع للثغرات مع درجة الخطورة والمضيف والنوع والأوصاف التي يولدها AI ومقتطفات الأدلة.

---

الإعدادات (Settings) - إدارة شهادة CA وكلمة المرور والمصادقة الثنائية (2FA) ومزود AI ومفاتيح API وحالة الوكيل.

---

معالج الإعداد (Setup wizard) - الإعداد الأولي لإنشاء كلمة المرور وتكوين مزود AI.

---

استخدام الوكيل

قم بتكوين متصفحك أو أداة سطر الأوامر أو عميل الاختبار لاستخدام:

HTTP proxy:  127.0.0.1:1337
HTTPS proxy: 127.0.0.1:1337

لاعتراض HTTPS، قم بتنزيل وتثبيت شهادة CA الخاصة بـ mitmproxy من صفحة الإعدادات (Settings).

---

المصادقة

يتطلب Ferret المصادقة في كل تثبيت.

تسجيل الدخول عبر المتصفح

1. افتح الواجهة لأول مرة.
2. قم بتعيين كلمة مرور في معالج الإعداد.
3. أكمل إعداد مزود AI.
4. سجل الدخول على /login.
5. يصدر Ferret ملف تعريف ارتباط جلسة HttpOnly و SameSite=Strict لمدة 24 ساعة.

المصادقة الثنائية

يمكن تفعيل 2FA القائمة على TOTP من صفحة الإعدادات.

بمجرد التفعيل، يلزم إدخال رمز مصادقة صالح عند تسجيل الدخول.

الوصول عبر API

قم بتعيين مفتاح API ثابت في .env:

FERRET_API_KEY=مفتاح-سري-عشوائي-خاص-بك

ثم استخدمه كرمز حامل (Bearer token):

curl -H "Authorization: Bearer مفتاح-سري-عشوائي-خاص-بك" \
  http://localhost:8000/api/requests

يتم فحص ملفات تعريف الارتباط للجلسة ورموز الحامل بشكل مستقل.

---

الإعدادات

انسخ .env.example إلى .env لتكوين Ferret مسبقاً.

يمكن أيضاً تكوين معظم إعدادات مزود AI من معالج الإعداد.

المتغير	القيمة الافتراضية	الوصف
FERRET_API_KEY	-	رمز حامل ثابت للوصول البرمجي إلى API
OPENROUTER_MODEL	google/gemini-3-flash-preview	نموذج OpenRouter الافتراضي
PROXY_HOST	0.0.0.0	عنوان ربط الوكيل
PROXY_PORT	1337	منفذ الوكيل
UI_PORT	3000	منفذ الواجهة
FERRET_DATA_DIR	./data	دليل البيانات الدائم
NEXT_PUBLIC_API_URL	http://localhost:8000	رابط API المستخدم من قبل المتصفح
NEXT_PUBLIC_SIGINT_URL	-	رابط JSON اختياري لخلاصة SIGINT/الأخبار

---

مزودات AI المدعومة

المزود	النوع
OpenRouter	سحابي - واجهة موحدة عبر العديد من النماذج
OpenAI	سحابي - GPT-4o, o1 وغيرها
Anthropic	سحابي - نماذج Claude
Gemini	سحابي - نماذج Google Gemini
DeepSeek	سحابي - نماذج DeepSeek
Mistral	سحابي - نماذج Mistral
Ollama	محلي - تشغيل النماذج على جهازك
LM Studio	محلي - تشغيل النماذج على جهازك

يمكن إكمال إعداد المزود من معالج التشغيل الأول.

---

أوامر just