Network Sentinel - أداة مراقبة وتحليل الشبكة المتقدمة

أداة مفتوحة المصدر مكتوبة بلغة Python تستخدم مكتبات Flask و Scapy لتوفير مراقبة وتحليل شبكتك المحلية في الوقت الحقيقي، مع واجهة ويب تفاعلية تعرض الأجهزة المتصلة، المنافذ المفتوحة، وتحليل الحزم.

---

المميزات

• اكتشاف الأجهزة النشطة على الشبكة المحلية.
• مسح المنافذ المفتوحة والخدمات الشائعة.
• التقاط وتحليل الحزم (Packets) الحية.
• واجهة ويب سهلة الاستخدام تعرض بيانات الشبكة بشكل تفاعلي.
• إمكانية حفظ لقطات من حالة الشبكة للحفظ والمراجعة لاحقاً.
• تنبيهات بالبريد الإلكتروني عند اكتشاف أجهزة جديدة (اختياري).

---

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

• Python 3.8 أو أحدث
• pip مثبتة (مدير الحزم الخاص ببايثون)
• صلاحيات root أو sudo لتشغيل تحليل الحزم (Scapy)

---

نصيحة مهمة : استخدم معاها اداة https://github.com/sb3lr/scanWAS للعثور على جميع ip الموجودة على الشبكة

مشكلة التثبيت في البيئات المدارة (Externally Managed Environment)

في توزيعات Linux الحديثة (مثل Debian و Ubuntu)، قد تواجه الخطأ التالي عند تثبيت الحزم:

error: externally-managed-environment

× This environment is externally managed
╰─> To install Python packages system-wide, try apt install python3-xyz.
...

---

الحل: إنشاء وتفعيل بيئة افتراضية (Virtual Environment)

الخطوات:

1. إنشاء بيئة افتراضية جديدة:

python3 -m venv venv

2. تفعيل البيئة الافتراضية:

• على Linux/macOS:

source venv/bin/activate

• على Windows (PowerShell):

.\venv\Scripts\Activate.ps1

3. تحديث pip وتثبيت المتطلبات:

pip install --upgrade pip
pip install -r requirements.txt

---

التثبيت والتشغيل خطوة بخطوة

1. نسخ المستودع أو تحميل الملفات

2. إنشاء البيئة الافتراضية وتفعيلها (كما في الخطوات السابقة)

3. تثبيت المتطلبات:

pip install -r requirements.txt

4. تشغيل البرنامج:

sudo ./venv/bin/python main.py
or
sudo python main.py

5. فتح المتصفح وزيارة الصفحة:

http://localhost:5000/

---

ملاحظات هامة

• تأكد من ضبط اسم واجهة الشبكة في ملف main.py (السطر: interface = 'enp6s0') حسب جهازك، قد تكون wlan0 أو اسم آخر.

• قد تحتاج لتشغيل البرنامج بصلاحيات root:

sudo python main.py

• المجلد snapshots/ سيُستخدم لحفظ اللقطات (Snapshots) الخاصة بالشبكة.

---

هيكل المشروع

NetworkSentinel/
├── main.py             # الكود الرئيسي
├── dashboard.html      # صفحة الواجهة الرسومية
├── requirements.txt    # مكتبات بايثون المطلوبة
├── sentinel.log        # ملف سجلات التشغيل (ينشأ تلقائياً)
└── snapshots/          # مجلد حفظ لقطات الشبكة

---

محتوى ملف requirements.txt

Flask
scapy

---

الدعم والمساهمة

• يمكنك فتح مشكلة (Issue) أو طلب إضافة مميزات جديدة عبر GitHub.
• المساهمة مرحب بها عن طريق إنشاء فرع جديد ورفع Pull Request.

---

ترخيص المشروع

هذا المشروع مرخص تحت رخصة MIT - راجع ملف LICENSE لمزيد من التفاصيل.

---

إذا واجهت أي مشكلة أو أردت المساعدة في التثبيت أو الاستخدام، لا تتردد في التواصل معي!

---

تم بحمد الله