ماسح VirusTotal

نص برمجي بلغة Python لتحليل جميع الملفات باستخدام واجهة برمجة تطبيقات VirusTotal، مع مسح المجلدات والمجلدات الفرعية بشكل متكرر. محسن لنظام Windows.

الميزات

• مسح جميع الملفات في مجلد ومجلداته الفرعية
• إعدادات عبر ملف .env - حفظ مفتاح API والإعدادات
• وضع تفاعلي - يعمل أيضاً بدون ملف .env
• محسن لنظام Windows - معالجة صحيحة للمسارات وترميز UTF-8
• تسجيل كامل - تسجل جميع الأحداث والأخطاء في ملف .log
• تصدير CSV - حفظ النتائج في ملف CSV (مفصول بفاصلة منقوطة)
• تقدير الوقت - يظهر الوقت المتبقي والمنقضي في الوقت الفعلي
• يحترم حد 4 ملفات في الدقيقة لواجهة API المجانية
• يعرض رابط تحليل VirusTotal لكل ملف
• يعرض النتائج بتنسيق X/Y (مثال: 0/70 يعني 0 إيجابي من 70 محرك مكافحة فيروسات)
• معالجة قوية للأخطاء (الملفات المقفلة، عدم وجود أذونات، إلخ)
• عداد تقدم فوري مع النسبة المئوية
• ملخص مفصل عند الانتهاء مع إحصائيات ووقت إجمالي
• قائمة بالملفات التي تم تخطيها مع الأسباب
• البحث عن التجزئة قبل الرفع - يوفر الوقت وعرض النطاق الترددي عن طريق التحقق مما إذا كان الملف موجوداً بالفعل في VirusTotal

المتطلبات

• Python 3.6 أو أحدث
• مفتاح API لـ VirusTotal (مجاني)
• Windows (محسن، لكنه يعمل على أنظمة أخرى)

التثبيت

1. قم بتنزيل الملفات إلى جهاز الكمبيوتر الخاص بك

2. تثبيت التبعيات:

pip install -r requirements.txt

3. احصل على مفتاح API الخاص بك من VirusTotal:
   • انتقل إلى https://www.virustotal.com/gui/my-apikey
   • سجل أو قم بتسجيل الدخول (إنه مجاني)
   • انسخ مفتاح API الخاص بك

الاستخدام

الخيار 1: استخدام ملف .env (موصى به)

1. انسخ ملف .env.example إلى .env:

   root@kitploit:~

   cp .env.example .env
   

2. قم بتحرير ملف .env وأضف الإعدادات الخاصة بك:

   root@kitploit:~

   VIRUSTOTAL_API_KEY=your_actual_api_key_here
   SCAN_FOLDER=C:\Users\username\Desktop\my_files
   

3. قم بتشغيل النص البرمجي:

   root@kitploit:~

   python virustotal_scanner.py
   

سيقوم النص البرمجي بتحميل الإعدادات تلقائياً من ملف .env.

الخيار 2: الوضع التفاعلي (بدون .env)

إذا كنت تفضل عدم استخدام ملف .env، فسيطلب النص البرمجي المعلومات:

python virustotal_scanner.py

سيطلب النص البرمجي ما يلي:

1. مفتاح API الخاص بك من VirusTotal
2. مسار المجلد الذي تريد مسحه

مثال استخدام:

Enter your VirusTotal API key: a1b2c3d4e5f6...

Enter the folder path to scan: C:\Users\username\Desktop\my_files

Do you want to continue? (y/n): y

أمثلة مسارات صالحة على Windows:

• C:\Users\username\Documents\my_files
• C:\Users\username\Desktop\folder
• . (النقطة = المجلد الحالي)
• يمكنك سحب المجلد وإفلاته في الطرفية

الملفات المُنشأة

بعد تشغيل النص البرمجي، سيتم إنشاء الملفات التالية تلقائياً:

virustotal_scan.log

ملف سجل بجميع الأحداث:

• بداية المسح ونهايته
• كل ملف تمت معالجته
• الأخطاء والتحذيرات
• الإحصائيات النهائية

virustotal_results.csv

ملف CSV بالنتائج (مفصول بفاصلة منقوطة):

• تاريخ ووقت التحليل
• اسم الملف
• المسار الكامل
• الحجم بالبايت
• تجزئة SHA256
• الاكتشافات الإيجابية
• إجمالي محركات مكافحة الفيروسات
• نسبة الاكتشاف
• الحالة (نظيف/مكتشف)
• رابط VirusTotal

يمكن فتح ملف CSV باستخدام Excel أو Google Sheets أو أي برنامج جداول بيانات.

مثال على المخرجات

================================================================================
  VIRUSTOTAL SCANNER - COMPLETE FOLDER SCAN
================================================================================
Folder: C:\Users\username\Desktop\my_files
API limit: 4 files per minute
Maximum file size: 32 MB
================================================================================

Counting files...
Total files found: 15

Starting analysis...

================================================================================
Progress: [1/15]
================================================================================

[*] Analyzing: document.pdf
    Path: C:\Users\username\Desktop\my_files\document.pdf
  Uploading file...
  Waiting for analysis results...
  Analysis in progress... (attempt 1/30)

  >> URL: https://www.virustotal.com/gui/file/abc123...
  >> Detections: 0/70

================================================================================
Progress: [2/15]
================================================================================

[*] Analyzing: program.exe
    Path: C:\Users\username\Desktop\my_files\program.exe
  Uploading file...
  Waiting for analysis results...

  >> URL: https://www.virustotal.com/gui/file/def456...
  >> Detections: 2/70

[!] Rate limit reached: Waiting 15 seconds...

================================================================================
  FINAL SCAN SUMMARY
================================================================================

ANALYZED FILES:
--------------------------------------------------------------------------------

1. [CLEAN] 0/70
   File: C:\Users\username\Desktop\my_files\document.pdf
   URL: https://www.virustotal.com/gui/file/abc123...

2. [DETECTED] 2/70
   File: C:\Users\username\Desktop\my_files\program.exe
   URL: https://www.virustotal.com/gui/file/def456...

================================================================================
SKIPPED FILES:
--------------------------------------------------------------------------------

1. C:\Users\username\Desktop\my_files\large_file.iso
   Reason: File too large (650.50 MB)

2. C:\Users\username\Desktop\my_files\system.dll
   Reason: No read permissions

================================================================================
  STATISTICS
================================================================================
Total files found: 15
Files analyzed: 13
Files skipped: 2
  - Clean files (0 detections): 12
  - Files with detections: 1
================================================================================

القيود والاعتبارات

حدود واجهة برمجة التطبيقات المجانية:

• 4 ملفات في الدقيقة (ينتظر النص البرمجي تلقائياً)
• الحد الأقصى للحجم: 32 ميغابايت لكل ملف
• سيتم تخطي الملفات الأكبر حجماً تلقائياً

الملفات التي يتم تخطيها:

• الملفات الأكبر من 32 ميغابايت
• الملفات الفارغة (0 بايت)
• الملفات التي لا تملك أذونات قراءة
• الملفات المقفلة من قبل النظام

ملاحظات أمنية مهمة

• حافظ على سرية مفتاح API الخاص بك - لا تشاركه
• يتم تحليل الملفات علناً - لا ترفع ملفات سرية
• تتم مشاركة الملفات مع مجتمع الأمن - بمجرد رفعها، تصبح عامة
• VirusTotal مخصص لتحليل الأمن - استخدمه بمسؤولية
• لا ترفع بيانات شخصية أو حساسة للشركات

ماذا يفعل النص البرمجي؟

1. يجد جميع الملفات في المجلد والمجلدات الفرعية
2. يتحقق من أن كل ملف صالح للتحليل
3. يتحقق مما إذا كانت تجزئة الملف موجودة بالفعل في VirusTotal (يوفر الوقت وعرض النطاق)
4. يرفع كل ملف إلى VirusTotal إذا لم يتم العثور عليه (مع احترام حد 4 ملفات في الدقيقة)
5. ينتظر نتائج التحليل
6. يعرض الرابط والاكتشافات (مثال: 0/70، 5/70)
7. يُنشئ ملخصاً كاملاً في النهاية

استكشاف الأخطاء وإصلاحها

خطأ: "Invalid API key"

• تحقق من أنك قمت بنسخ مفتاح API الخاص بك بشكل صحيح
• احصل على مفتاح جديد من https://www.virustotal.com/gui/my-apikey

خطأ: "Access denied to file"

• بعض ملفات النظام محمية
• قم بتشغيل البرنامج كمسؤول إذا كنت بحاجة لتحليل ملفات النظام

النص البرمجي بطيء جداً

• هذا طبيعي: واجهة API المجانية محدودة بـ 4 ملفات في الدقيقة
• إذا كان لديك 100 ملف، فسيستغرق حوالي 25 دقيقة

الملفات التي تم تخطيها

• تحقق من الملخص النهائي لمعرفة سبب تخطيها
• الملفات الأكبر من 32 ميغابايت لا يمكن تحليلها باستخدام واجهة API المجانية

الترخيص

MIT License - Copyright (c) 2025 neorai

هذا المشروع مجاني ومفتوح المصدر. يمكنك استخدامه وتعديله وتوزيعه بحرية. انظر ملف LICENSE للحصول على التفاصيل.