⚡ VulnScan Pro

ماسح ثغرات أمنية سيبرانية احترافي مبني باستخدام Python 3.13 وPyQt6. مصمم لـ تقييمات الأمان المصرَّح بها، والبحث التعليمي، والأمن الدفاعي.

⚠ إشعار قانوني

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

الميزات

لقطة الشاشة

التثبيت

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

• Python 3.10 أو أحدث (يُفضَّل 3.13)
• pip

الخطوات

# 1. Navigate to the project directory
cd "VulnScan_Pro"

# 2. (Recommended) Create a virtual environment
python -m venv venv
venv\Scripts\activate          # Windows
# source venv/bin/activate     # Linux / macOS

# 3. Install dependencies
pip install -r requirements.txt

# 4. Launch the application
python main.py

الاستخدام

بدء الفحص

1. انقر على فحص جديد في الشريط الجانبي
2. أدخل هدفك:
   • عنوان IP واحد: 192.168.1.1
   • نطاق CIDR: 192.168.1.0/24
   • نطاق IP: 192.168.1.1-254
   • اسم المضيف: myserver.local
3. اختر إعدادًا مسبقًا للمنافذ (يُنصح باستخدام المنافذ الشائعة للفحوصات السريعة)
4. اضبط عدد الخيوط والمهلة الزمنية حسب الحاجة
5. انقر على ▶ بدء الفحص

عرض النتائج

تظهر النتائج تلقائيًا في صفحة النتائج بعد كل فحص.
كل نتيجة تُظهر:

• معرّف CVE واسمه
• الخطورة ودرجة CVSS
• وصفًا مفصّلًا
• نصيحة المعالجة
• إصدار الخدمة المكتشف

إنشاء التقارير

1. انتقل إلى التقارير
2. اختر فحصًا مكتملًا
3. انقر على إنشاء تقرير PDF
4. اختر موقع الحفظ

تصفية النتائج

استخدم شريط التصفية أعلى صفحة النتائج للتصفية حسب:

• مستوى الخطورة
• عنوان IP للمضيف
• رقم المنفذ
• اسم الخدمة

هيكل المشروع

VulnScan_Pro/
├── main.py                  # Application entry point
├── requirements.txt
├── core/
│   ├── scanner.py           # Multithreaded port scanner (QThread)
│   ├── service_detector.py  # Banner grabbing & service fingerprinting
│   ├── vuln_engine.py       # CVE matching engine
│   ├── risk_calculator.py   # CVSS-weighted risk score
│   └── scheduler.py         # Recurring scan scheduler
├── gui/
│   ├── main_window.py       # Main window with sidebar navigation
│   ├── dashboard.py         # Statistics dashboard with charts
│   ├── scan_page.py         # Scan configuration & execution
│   ├── results_page.py      # Findings browser with filtering
│   ├── history_page.py      # Historical scan management
│   ├── reports_page.py      # PDF report generation
│   ├── settings_page.py     # Application preferences
│   └── widgets/
│       ├── stat_card.py     # Metric summary card
│       ├── charts.py        # DonutChart, BarChart, LineChart
│       └── severity_badge.py# Severity pill badge
├── database/
│   ├── db_manager.py        # SQLite CRUD operations
│   └── vuln_db.py           # Local vulnerability database (40+ CVEs)
├── reports/
│   └── pdf_generator.py     # ReportLab PDF report builder
└── utils/
    ├── validators.py         # Input validation
    ├── network_utils.py      # Socket utilities
    └── logger.py             # Centralised logging

قاعدة بيانات الثغرات

تغطي قاعدة بيانات CVE المحلية الخدمات الشائعة بما في ذلك:

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

صُممت هذه الأداة من أجل:

• ✅ اختبار أنظمتك الخاصة
• ✅ اختبارات الاختراق المصرَّح بها
• ✅ مختبرات الأمن السيبراني التعليمية
• ✅ تقييم الأمن الدفاعي
• ❌ فحص الأنظمة دون إذن
• ❌ الاستطلاع الخبيث
• ❌ أي نشاط غير قانوني

ملاحظات حول البنية

• تعدد الخيوط: جميع عمليات الإدخال/الإخراج الشبكية تعمل داخل عمال QThread باستخدام ThreadPoolExecutor لاختبار المنافذ بالتوازي. لا تتعطل واجهة المستخدم الرسومية أبدًا.
• قاعدة البيانات: SQLite مع وضع WAL وفرض قيود المفاتيح الأجنبية عبر db_manager.py.
• الرسوم البيانية: أدوات مخصصة مبنية على QPainter — دون الحاجة إلى مكتبة رسوم بيانية خارجية.
• التقارير: إطار عمل ReportLab Platypus مع تنسيق داكن ذي هوية بصرية مميزة.