مولد تقارير Masscan

أداة بايثون تُنشئ تصورات HTML تفاعلية مبنية على React من مخرجات JSON لـ masscan، وتتميز برسم بياني للشبكة موجه بالقوة باستخدام D3.js.

لقطة شاشة

الميزات

الرسم البياني التفاعلي للشبكة

• تصور D3.js موجه بالقوة يُظهر طوبولوجيا الشبكة
• هيكل هرمي: الإنترنت → الفئة A (/8) → الفئة B (/16) → الفئة C (/24) → المضيفون → المنافذ
• سحب وتكبير لاستكشاف الشبكة
• عُقد ملونة حسب النوع (مضيفون، منافذ، قطاعات الشبكة)

البحث والتصفية

• بحث حي - تصفية المضيفين والمنافذ أثناء الكتابة
• بادئة بحث المنافذ - استخدم : للبحث في المنافذ فقط (مثل :443)
• دعم الأحرف البدل - استخدم * لمطابقة الأنماط (مثل :*443, :80*, :*8*)
• تسليط الضوء في الوقت الفعلي على العقد المطابقة في الرسم البياني

نافذة تفاصيل المضيف

• انقر على أي عقدة في الرسم البياني لعرض معلومات مفصلة
• عُقد المضيف تعرض جميع المنافذ المفتوحة مع أوصاف الخدمات
• عُقد المنافذ تُظهر معلومات الخدمة والبروتوكول ومستوى خطر الأمان
• شارات الأمان ملونة: عالية (أحمر)، متوسطة (أصفر)، منخفضة (أخضر مزرق)، آمنة (سماوي)
• روابط إلى وثائق كل خدمة

تصدير PDF

• تقارير PDF احترافية بتنسيق داكن
• صفحة عنوان مع إحصائيات موجزة
• لقطة شاشة للرسم البياني ملتقطة من العرض الحالي
• ملخص تنفيذي بلغة طبيعية
• تفاصيل المضيف منظمة حسب فئة الشبكة

التنقل الجانبي

• قائمة بجميع المضيفين المكتشفين مع منافذهم المفتوحة
• انقر لتسليط الضوء على المضيف والعقد الفرعية في الرسم البياني
• شارات المنافذ للتعرف السريع

التثبيت

من المصدر

# استنساخ أو تنزيل المشروع
cd masscan_report

# تثبيت التبعيات (اختياري، مطلوب فقط لتوليد PDF أثناء التطوير)
pip install pyinstaller  # فقط إذا كنت تبني ملفًا تنفيذيًا

ملف تنفيذي مستقل

قم بتنزيل masscan_report.exe من مجلد dist/ - لا حاجة لتثبيت بايثون.

الاستخدام

سطر الأوامر

# باستخدام بايثون
python masscan_report.py <input_json> [-o output.html]

# باستخدام الملف التنفيذي
masscan_report.exe <input_json> [-o output.html]

أمثلة

# إنشاء تقرير بمخرجات افتراضية (report.html)
python masscan_report.py scans/home.json

# تحديد ملف مخرجات مخصص
python masscan_report.py scans/network_scan.json -o network_report.html

# باستخدام الملف التنفيذي
.\dist\masscan_report.exe .\scans\home.192.168.10000.json

تنسيق الإدخال

تتوقع الأداة تنسيق مخرجات JSON من masscan:

[
  {"ip": "192.168.1.1", "timestamp": "1234567890", "ports": [
    {"port": 80, "proto": "tcp", "status": "open", "reason": "syn-ack", "ttl": 64}
  ]},
  {"ip": "192.168.1.1", "timestamp": "1234567891", "ports": [
    {"port": 443, "proto": "tcp", "status": "open", "reason": "syn-ack", "ttl": 64}
  ]}
]

قم بإنشاء هذا باستخدام masscan:

masscan 192.168.1.0/24 -p1-65535 --rate 1000 -oJ scan_results.json

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

بناء الجملة للبحث

هيكل المشروع

masscan_report/
├── masscan_report.py      # النص الرئيسي
├── port_descriptions.py   # قاعدة بيانات المنافذ (أكثر من 6700 سطر)
├── scans/                  # ملفات فحص نموذجية
│   ├── home.json
│   └── home.192.168.10000.json
├── dist/
│   └── masscan_report.exe # ملف تنفيذي مستقل
├── report.html            # المخرجات المولدة
└── README.md

قاعدة بيانات أوصاف المنافذ

يحتوي port_descriptions.py على معلومات مفصلة لأكثر من 130 منفذًا شائعًا تتضمن:

• اسم الخدمة ووصفها
• تفاصيل فنية
• تقييم مخاطر الأمان
• روابط للتوثيق

بناء الملف التنفيذي

pip install pyinstaller
pyinstaller --onefile --name masscan_report --add-data "port_descriptions.py;." masscan_report.py

سيتم إنشاء الملف التنفيذي في dist/masscan_report.exe.

المتطلبات

• بايثون 3.8+ (للتشغيل من المصدر)
• متصفح ويب حديث (لعرض التقارير)
• لا حاجة لحزم بايثون إضافية (يستخدم المكتبة القياسية فقط)

الترخيص

MIT License

المساهمة

نرحب بالمساهمات! لا تتردد في تقديم المشكلات وطلبات السحب.