CEREBRO-RED v2 (إصدار بحثي)

مجموعة اختبار اختراق مستقلة LLM محلي

إطار بحثي احترافي للاكتشاف الآلي للثغرات في نماذج LLM المحلية باستخدام التجريب الوكالي والتحول العدائي التكيفي (AAM).

أهداف البحث

• تنفيذ خوارزمية PAIR (التنقية التكرارية الآلية للموجهات) من arxiv.org/abs/2310.08419
• تقييم دلالي باستخدام LLM كحكم مع استدلال سلسلة الأفكار
• هندسة مركزة على القياس عن بُعد للتحليل بمستوى الأوراق البيضاء
• دعم متعدد المزودين لـ LLM (Ollama, Azure OpenAI, OpenAI)

العمارة

المجموعة التقنية

• الخلفية: FastAPI (async/await), Pydantic (أنواع صارمة), Uvicorn
• بوابة LLM: litellm (محول عالمي لـ Ollama/Azure/OpenAI)
• قاعدة البيانات: SQLite (التجارب) + JSONL (سجلات التدقيق)
• الواجهة الأمامية: React + Vite + TailwindCSS + ShadcnUI + Recharts
• الحاوية: Docker + Docker Compose

تعرض العمارة النظامية المكونات الرئيسية وسريان البيانات

الوحدات الأساسية

1. المنسق (backend/core/engine.py): معالجة دُفعية غير متزامنة مع تراجع أسي
2. المحول (backend/core/mutator.py): خوارزمية PAIR مع استراتيجيات التحول
3. الحكم (backend/core/judge.py): LLM كحكم مع تقييم سلسلة الأفكار
4. القياس عن بُعد (backend/core/telemetry.py): مسجل تدقيق JSONL آمن للخيوط

لوحة التحكم الأمامية

توفر الواجهة الأمامية القائمة على React واجهة شاملة لإدارة التجارب ومراقبة التقدم وتحليل النتائج.

واجهة لوحة التحكم الرئيسية تعرض نظرة عامة على التجارب والإحصائيات

عرض إدارة التجارب مع تحديثات الحالة في الوقت الفعلي وقائمة التجارب

نظرة عامة كاملة على واجهة المستخدم تعرض جميع الميزات المتاحة

نتائج التجارب والتحليل

عرض النتائج يظهر مخرجات التجارب واكتشافات الثغرات والتحليل المفصل

لوحة الإعدادات والتكوين لتخصيص معلمات التجارب

المراقبة في الوقت الفعلي

لوحة مراقبة في الوقت الفعلي مع تقدم التجارب الحية ومؤشرات الحالة

عرض القياس عن بُعد يظهر سجلات التدقيق التفصيلية وأحداث النظام ومقاييس الأداء

عرض سجلات مفصل مع إمكانيات التصفية والبحث

لوحة مقاييس الأداء والإحصائيات

نظرة عامة على حالة النظام تعرض فحوصات الصحة وحالة المكونات

توثيق API

واجهة توثيق API تفاعلية مع مستكشف النقاط الطرفية

للاطلاع على توثيق العمارة التفصيلي، راجع docs/ARCHITECTURE.md.

البداية السريعة

المتطلبات الأساسية

• Docker 24.0+
• Docker Compose 2.20+
• تشغيل Ollama على المضيف (أو مفاتيح API لـ Azure/OpenAI)

إعداد Docker

إذا كان Docker غير قيد التشغيل، قم بتشغيل برنامج الخدمة Docker:```bash

Start Docker daemon

sudo systemctl start docker

Enable Docker to start on boot

sudo systemctl enable docker

Add your user to the docker group (to run Docker without sudo)

sudo usermod -aG docker $USER

Apply group changes (logout/login or use newgrp)

newgrp docker

OR logout and login again for changes to take effect

**تحقق من أن Docker قيد التشغيل**:```bash
docker --version
docker compose version

التثبيت

1. استنساخ المستودع: ```bash git clone https://github.com/Leviticus-Triage/cerebro-red-v2.git cd cerebro-red-v2

2. تهيئة البيئة: ```bash cp .env.example .env

   Edit .env with your LLM provider credentials

3. هام: تحقق من المنفذ 8000 ```bash

   Falls Port 8000 belegt ist:

   lsof -i :8000 # Finde Prozess

   Oder ändere Port in .env: CEREBRO_PORT=8001

4. ابدأ الخلفية (هام - يجب تشغيله!): ```bash

   Option 1: Automatisch (empfohlen)

   ./START_BACKEND.sh

   Option 2: Docker

   docker compose up -d cerebro-backend

   Option 3: Lokal

   cd backend uvicorn main:app --reload --port 9000

5. تحقق من حالة الخلفية: ```bash curl http://localhost:9000/health

   Sollte {"status": "healthy", ...} zurückgeben

6. تشغيل الاختبارات السريعة: ```bash ./QUICK_TEST_EXAMPLES.sh

7. لوحة التحكم:

   • واجهة برمجة التطبيقات الخلفية: http://localhost:9000
   • واجهة المستخدم الأمامية: http://localhost:3000 (اختياري: docker compose up -d cerebro-frontend)
   • وثائق واجهة برمجة التطبيقات: http://localhost:9000/docs

   

   واجهة المستخدم الأمامية تعرض إدارة التجارب والمراقبة

---

بدء التشغيل السريع: النشر المحلي مقابل السحابي

النشر المحلي (Ollama)

الأفضل لـ: الاختبارات التي تركز على الخصوصية، لا تكاليف API، التشغيل دون اتصال.```bash

1. Install and start Ollama

curl -fsSL https://ollama.ai/install.sh | sh ollama pull llama3.2:3b ollama serve

2. Configure .env for local

cat > .env << 'EOF' TARGET_MODEL=ollama/llama3.2:3b ATTACKER_MODEL=ollama/llama3.2:3b JUDGE_MODEL=ollama/llama3.2:3b OLLAMA_BASE_URL=http://host.docker.internal:11434

Relaxed circuit breaker for local (slower responses)

CIRCUIT_BREAKER_FAILURE_THRESHOLD=15 CIRCUIT_BREAKER_TIMEOUT=120 CIRCUIT_BREAKER_JITTER_ENABLED=true EOF

3. Start services

docker compose up -d

4. Verify

curl http://localhost:9000/health | jq

### النشر السحابي (OpenAI)

الأفضل لـ: استجابات أسرع، تحويرات عالية الجودة، اختبار إنتاجي.```bash
# 1. Configure .env for cloud
cat > .env << 'EOF'
TARGET_MODEL=openai/gpt-4o-mini
ATTACKER_MODEL=openai/gpt-4o-mini
JUDGE_MODEL=openai/gpt-4o-mini
OPENAI_API_KEY=sk-your-key-here

# Standard circuit breaker for cloud
CIRCUIT_BREAKER_FAILURE_THRESHOLD=10
CIRCUIT_BREAKER_TIMEOUT=60
CIRCUIT_BREAKER_JITTER_ENABLED=true
EOF

# 2. Start services
docker compose up -d

# 3. Verify
curl http://localhost:9000/health | jq

النشر الهجين (متعدد المزودين)

مناسب لـ: تحسين التكلفة (هدف منخفض التكلفة، مهاجم/حكم عالي الجودة).```bash

Configure .env for hybrid

cat > .env << 'EOF'

Target on local Ollama (cheap, many requests)

TARGET_MODEL=ollama/llama3.2:3b OLLAMA_BASE_URL=http://host.docker.internal:11434

Attacker and Judge on OpenAI (quality matters)

ATTACKER_MODEL=openai/gpt-4o-mini JUDGE_MODEL=openai/gpt-4o-mini OPENAI_API_KEY=sk-your-key-here

Balanced circuit breaker

CIRCUIT_BREAKER_FAILURE_THRESHOLD=12 CIRCUIT_BREAKER_TIMEOUT=90 EOF

---

##  مستويات التفصيل