METATRON

مساعد اختبار اختراق يعمل بالذكاء الاصطناعي باستخدام نموذج لغوي محلي على لينكس (Parrot OS)

🔱 METATRON

مساعد اختبار اختراق يعمل بالذكاء الاصطناعي

📌 ما هو ميتاترون؟

ميتاترون هو مساعد اختبار اختراق يعمل بواجهة سطر أوامر (CLI) يعتمد على الذكاء الاصطناعي ويعمل بالكامل على جهازك المحلي — لا سحابة، لا مفاتيح API، لا اشتراكات.

أنت تقدم له عنوان IP أو نطاق الهدف. يقوم بتشغيل أدوات الاستطلاع الحقيقية (nmap, whois, whatweb, curl, dig, nikto)، ويغذي جميع النتائج إلى نموذج الذكاء الاصطناعي المحلي، ويقوم الذكاء الاصطناعي بتحليل الهدف، وتحديد الثغرات، واقتراح الاستغلالات، والتوصية بالإصلاحات. يتم حفظ كل شيء في قاعدة بيانات MariaDB مع سجل كامل للمسح.

✨ الميزات

• 🤖 تحليل ذكاء اصطناعي محلي — يعمل بواسطة metatron-qwen عبر Ollama، يعمل بدون إنترنت 100%
• 🔍 استطلاع آلي — nmap, whois, whatweb, curl headers, dig DNS, nikto
• 🌐 بحث ويب — بحث DuckDuckGo + بحث CVE (بدون حاجة لمفتاح API)
• 🗄️ قاعدة بيانات MariaDB — سجل كامل للمسح مع 5 جداول مترابطة
• ✏️ تعديل / حذف — تعديل أي نتيجة محفوظة مباشرة من سطر الأوامر
• 🔁 حلقة وكيل — يمكن للذكاء الاصطناعي طلب تشغيل أدوات إضافية أثناء التحليل
• 🚫 بدون مفاتيح API — كل شيء مجاني ومحلي
• 📤 تصدير التقارير

يتيح لك Metatron تصدير نتائج المسح إلى صيغ تقارير نظيفة قابلة للمشاركة عن طريق اختيار '2.view history' -> تحديد الرقم التسلسلي والتصدير

📄 PDF — تقارير ثغرات احترافية 🌐 HTML — تقارير قابلة للعرض في المتصفح

🖥️ لقطات الشاشة

القائمة الرئيسية

أدوات الاستطلاع تعمل على الهدف

metatron-qwen يقوم بتحليل نتائج المسح

تم حفظ الثغرات في قاعدة البيانات

تصدير نتائج المسح بصيغة PDF و/أو HTML

🧱 المكونات التقنية

⚙️ التثبيت

1. استنساخ المستودع

git clone https://github.com/sooryathejas/METATRON.git
cd METATRON

2. إنشاء وتفعيل البيئة الافتراضية

python3 -m venv venv
source venv/bin/activate

3. تثبيت تبعيات بايثون

pip install -r requirements.txt

4. تثبيت أدوات النظام

sudo apt install nmap whois whatweb curl dnsutils nikto

🤖 إعداد نموذج الذكاء الاصطناعي

الخطوة 1 — تثبيت Ollama

curl -fsSL https://ollama.com/install.sh | sh

الخطوة 2 — تحميل النموذج الأساسي

ollama pull huihui_ai/qwen3.5-abliterated:9b

⚠️ يتطلب هذا النموذج 8.4 جيجابايت من ذاكرة الوصول العشوائي على الأقل. إذا كان نظامك يحتوي على سعة أقل، استخدم الإصدار 4b:

root@kitploit:~

ollama pull huihui_ai/qwen3.5-abliterated:4b

ثم قم بتعديل Modelfile وتغيير سطر FROM إلى النموذج 4b.

الخطوة 3 — بناء النموذج المخصص metatron-qwen

يحتوي المستودع على Modelfile الذي يعدل النموذج الأساسي مع معلمات مخصصة لاختبار الاختراق:

ollama create metatron-qwen -f Modelfile

يقوم هذا بإنشاء نموذج metatron-qwen المحلي الخاص بك مع:

• نافذة سياق 16,384 رمزًا
• درجة حرارة: 0.7
• Top-k: 10
• Top-p: 0.9

الخطوة 4 — التحقق من وجود النموذج

ollama list

يجب أن ترى metatron-qwen في القائمة.

🗄️ إعداد قاعدة البيانات

الخطوة 1 — التأكد من تشغيل MariaDB

sudo systemctl start mariadb
sudo systemctl enable mariadb

الخطوة 2 — إنشاء قاعدة البيانات والمستخدم

mysql -u root

CREATE DATABASE metatron;
CREATE USER 'metatron'@'localhost' IDENTIFIED BY '123';
GRANT ALL PRIVILEGES ON metatron.* TO 'metatron'@'localhost';
FLUSH PRIVILEGES;
EXIT;

الخطوة 3 — إنشاء الجداول

mysql -u metatron -p123 metatron

CREATE TABLE history (
  sl_no     INT AUTO_INCREMENT PRIMARY KEY,
  target    VARCHAR(255) NOT NULL,
                      scan_date DATETIME NOT NULL,
                      status    VARCHAR(50) DEFAULT 'active'
);

CREATE TABLE vulnerabilities (
  id          INT AUTO_INCREMENT PRIMARY KEY,
  sl_no       INT,
  vuln_name   TEXT,
  severity    VARCHAR(50),
                              port        VARCHAR(20),
                              service     VARCHAR(100),
                              description TEXT,
                              FOREIGN KEY (sl_no) REFERENCES history(sl_no)
);

CREATE TABLE fixes (
  id       INT AUTO_INCREMENT PRIMARY KEY,
  sl_no    INT,
  vuln_id  INT,
  fix_text TEXT,
  source   VARCHAR(50),
                    FOREIGN KEY (sl_no) REFERENCES history(sl_no),
                    FOREIGN KEY (vuln_id) REFERENCES vulnerabilities(id)
);

CREATE TABLE exploits_attempted (
  id           INT AUTO_INCREMENT PRIMARY KEY,
  sl_no        INT,
  exploit_name TEXT,
  tool_used    TEXT,
  payload      LONGTEXT,
  result       TEXT,
  notes        TEXT,
  FOREIGN KEY (sl_no) REFERENCES history(sl_no)
);

CREATE TABLE summary (
  id           INT AUTO_INCREMENT PRIMARY KEY,
  sl_no        INT,
  raw_scan     LONGTEXT,
  ai_analysis  LONGTEXT,
  risk_level   VARCHAR(50),
                      generated_at DATETIME,
                      FOREIGN KEY (sl_no) REFERENCES history(sl_no)
);

🚀 الاستخدام

يحتاج Metatron إلى نافذتي طرفية (terminal) للتشغيل.

الطرفية 1 — تحميل نموذج الذكاء الاصطناعي

ollama run metatron-qwen

انتظر حتى تظهر رسالة >>>. هذا يعني أن النموذج محمل في الذاكرة وجاهز. يمكنك ترك هذه الطرفية تعمل في الخلفية.

الطرفية 2 — تشغيل Metatron

cd ~/METATRON
source venv/bin/activate
python metatron.py

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

1. تظهر القائمة الرئيسية:

  [1]  New Scan
  [2]  View History
  [3]  Exit

2. اختر [1] New Scan → أدخل الهدف:

[?] Enter target IP or domain: 192.168.1.1

أو

[?] Enter target IP or domain: example.com

3. اختر أدوات الاستطلاع للتشغيل:

  [1] nmap
  [2] whois
  [3] whatweb
  [4] curl headers
  [5] dig DNS
  [6] nikto
  [a] Run all (except nikto)
  [n] Run all + nikto (slow)

4. يقوم Metatron بتشغيل الأدوات، ويغذي النتائج إلى الذكاء الاصطناعي، ويطبع التحليل.

5. يتم حفظ كل شيء في MariaDB تلقائيًا.

6. بعد المسح يمكنك تعديل أو حذف أي نتيجة.

📁 هيكل المشروع

METATRON/
├── metatron.py       ← نقطة الدخول الرئيسية لواجهة سطر الأوامر
├── db.py             ← اتصال MariaDB وجميع عمليات CRUD
├── tools.py          ← مشغلات أدوات الاستطلاع (nmap, whois, الخ)
├── llm.py            ← واجهة Ollama وحلقة إرسال أدوات الذكاء الاصطناعي
├── search.py         ← بحث ويب DuckDuckGo والبحث عن CVEs
├── Modelfile         ← إعدادات النموذج المخصص لـ metatron-qwen
├── requirements.txt  ← تبعيات بايثون
├── .gitignore        ← يستبعد venv, pycache, ملفات db
├── LICENSE           ← رخصة MIT
├── README.md         ← هذا الملف
└── screenshots/      ← لقطات شاشة للطرفية للتوثيق

🗃️ مخطط قاعدة البيانات

جميع الجداول الخمسة مرتبطة بواسطة sl_no (رقم الجلسة) من جدول history:

history              ← one row per scan session (sl_no is the spine)
    │
    ├── vulnerabilities   ← vulns found, linked by sl_no
    │       │
    │       └── fixes     ← fixes per vuln, linked by vuln_id + sl_no
    │
    ├── exploits_attempted ← exploits tried, linked by sl_no
    │
    └── summary           ← full AI analysis dump, linked by sl_no

⚠️ إخلاء مسؤولية

هذه الأداة مخصصة للأغراض التعليمية واختبار الاختراق المصرح به فقط.

• استخدم Metatron فقط على الأنظمة التي تمتلكها أو لديك إذن كتابي صريح لاختبارها.
• مسح الأنظمة أو استغلالها بدون إذن غير قانوني.
• المؤلف غير مسؤول عن أي إساءة استخدام لهذه الأداة.

👤 المؤلف

Soorya Thejas

• GitHub: @sooryathejas

📄 الرخصة

هذا المشروع مرخص بموجب رخصة MIT — انظر ملف LICENSE للتفاصيل.