EyeWitness - أداة التقاط لقطات الشاشة للمواقع

EyeWitness مصممة لالتقاط لقطات شاشة للمواقع، وتقديم معلومات عن رؤوس الخادم، والتعرف على بيانات الاعتماد الافتراضية إن وجدت. مدعومة الآن بمتصفح Chromium لموثوقية أفضل وسهولة تثبيت أكبر.

🚀 الميزات الرئيسية

• دعم عبر المنصات - ويندوز، لينكس، وماك
• مدعوم بـ Chromium - لقطات شاشة موثوقة بدون رأس مع Google Chrome/Chromium
• إدارة الموارد التكيفية - التعديل التلقائي وفقًا لقدرات النظام
• دعم ملفات الإعدادات - حفظ الإعدادات المفضلة لديك
• التحقق من صحة الروابط - فحوصات مسبقة للتأكد من صحة الروابط
• تتبع التقدم مع الوقت المقدر - معرفة الوقت المتبقي لانتهاء الفحص بدقة
• تحسين معالجة الأخطاء - أنواع أخطاء محددة مع إرشادات قابلة للتنفيذ
• تنسيقات إدخال متعددة - ملفات نصية، Nmap XML، Nessus XML
• بيئة افتراضية معزولة - لا تضارب في النظام وتجاوز PEP 668

🔒 بنية البيئة الافتراضية

يستخدم EyeWitness الآن البيئات الافتراضية لـ Python لجميع عمليات التثبيت، مما يوفر:

✅ الفوائد الرئيسية

• لا تضارب في النظام - جميع حزم Python مثبتة في بيئة معزولة
• لا مشاكل PEP 668 - تجاوز تام لأخطاء "externally-managed-environment" على Kali/Linux الحديث
• تناسق عبر المنصات - نفس النهج على ويندوز، لينكس، وماك
• تنظيف سهل - حذف مجلد eyewitness-venv/ لإزالة كل شيء
• جاهز للإنتاج - معالجة تلقائية للأخطاء والتراجع عند الفشل

🚀 كيف يعمل

1. إعداد ينشئ البيئة الافتراضية - مجلد eyewitness-venv/ مع Python معزول
2. تفعيل البيئة الافتراضية - أمر بسيط لدخول البيئة المعزولة
3. جميع الحزم مثبتة في العزلة - لا تأثير على نظام Python لديك
4. تشغيل EyeWitness بشكل طبيعي - أوامر Python القياسية تعمل داخل البيئة الافتراضية

📁 هيكل الملفات بعد التثبيت

EyeWitness/
├── eyewitness-venv/          # 🔒 البيئة الافتراضية (حزم Python المعزولة)
│   ├── bin/activate          # نص التفعيل لينكس/ماك
│   └── Scripts/activate.bat  # نص التفعيل ويندوز
├── Python/
│   └── EyeWitness.py         # 📜 البرنامج النصي الرئيسي (يعمل في البيئة الافتراضية)
└── setup/                    # نصوص الإعداد والمتطلبات

📦 خيارات التثبيت

🔥 جديد: يستخدم EyeWitness الآن البيئات الافتراضية لـ Python لعدم وجود تضارب وتثبيت مضمون عبر جميع المنصات!

ملاحظة: دعم Docker قيد التطوير حاليًا. يُرجى استخدام خيارات التثبيت الأصلية أدناه في الوقت الحالي.

🪟 تثبيت ويندوز

إعداد آلي مع بيئة Python الافتراضية:

# 1. افتح PowerShell كمسؤول
# 2. انتقل إلى مجلد EyeWitness
cd path\to\EyeWitness\setup

# 3. قم بتشغيل نص الإعداد (ينشئ البيئة الافتراضية)
.\setup.ps1

# 4. اختبر التثبيت بتفعيل البيئة الافتراضية
cd ..
eyewitness-venv\Scripts\activate.bat
python Python\EyeWitness.py --single https://example.com

ما يتم تثبيته:

• 🔒 بيئة Python افتراضية معزولة (eyewitness-venv/)
• تبعيات Python في البيئة الافتراضية (selenium، إلخ)
• متصفح Google Chrome (إذا لم يكن موجودًا)
• ChromeDriver للأتمتة

🐧 تثبيت لينكس

إعداد جاهز للإنتاج مع بيئة Python الافتراضية:

# 1. انتقل إلى مجلد الإعداد
cd EyeWitness/setup

# 2. قم بتشغيل نص الإعداد (ينشئ البيئة الافتراضية)
sudo ./setup.sh

# 3. اختبر التثبيت بتفعيل البيئة الافتراضية
cd ..
source eyewitness-venv/bin/activate
python Python/EyeWitness.py --single https://example.com

ما يتم تثبيته:

• 🔒 بيئة Python افتراضية معزولة (eyewitness-venv/)
• جميع حزم Python في البيئة الافتراضية (تجاوز تام لـ PEP 668)
• متصفح Chromium و ChromeDriver من خلال حزم النظام
• دعم الشاشة الافتراضية (xvfb)

🎯 الفوائد:

• ✅ لا تضارب PEP 668 - البيئة الافتراضية تتجاوز جميع القيود
• ✅ لا مشاكل في حزم النظام - جميع تبعيات Python معزولة
• ✅ تنظيف سهل - فقط احذف مجلد eyewitness-venv/
• ✅ جاهز للإنتاج - تراجع تلقائي عند فشل التثبيت

توزيعات لينكس المدعومة:

• Ubuntu 20.04+ / Linux Mint
• Debian 10+ / Kali Linux
• CentOS 8+ / RHEL / Rocky Linux
• Arch Linux / Manjaro
• Alpine Linux

🍎 تثبيت ماك

إعداد قائم على Homebrew مع بيئة Python الافتراضية:

# 1. قم بتثبيت Chrome عبر Homebrew
brew install --cask google-chrome

# 2. انتقل إلى مجلد الإعداد وشغل الإعداد
cd EyeWitness/setup
sudo ./setup.sh

# 3. اختبر التثبيت بتفعيل البيئة الافتراضية
cd ..
source eyewitness-venv/bin/activate
python Python/EyeWitness.py --single https://example.com

ما يتم تثبيته:

• 🔒 بيئة Python افتراضية معزولة (eyewitness-venv/)
• تبعيات Python في البيئة الافتراضية
• متصفح Chrome (عبر Homebrew)
• ChromeDriver للأتمتة

🎯 أمثلة الاستخدام

🚀 كيفية استخدام EyeWitness

بعد تشغيل نص الإعداد، قم بتفعيل البيئة الافتراضية وشغل EyeWitness:

🐧 لينكس/ماك:

# 1. قم بتفعيل البيئة الافتراضية
source eyewitness-venv/bin/activate

# 2. شغل EyeWitness (أنت الآن في البيئة المعزولة)
python Python/EyeWitness.py --single https://example.com
python Python/EyeWitness.py -f urls.txt
python Python/EyeWitness.py -x nmap_scan.xml
python Python/EyeWitness.py -f urls.txt -d /path/to/output

# 3. عند الانتهاء، قم بتعطيل البيئة الافتراضية
deactivate

🪟 ويندوز:

# 1. قم بتفعيل البيئة الافتراضية
eyewitness-venv\Scripts\activate.bat

# 2. شغل EyeWitness (أنت الآن في البيئة المعزولة)
python Python\EyeWitness.py --single https://example.com
python Python\EyeWitness.py -f urls.txt
python Python\EyeWitness.py -x nmap_scan.xml
python Python\EyeWitness.py -f urls.txt -d C:\path\to\output

# 3. عند الانتهاء، قم بتعطيل البيئة الافتراضية
deactivate

📄 ملفات الإعدادات

# قم بتفعيل البيئة الافتراضية أولاً
source eyewitness-venv/bin/activate  # لينكس/ماك
eyewitness-venv\Scripts\activate.bat # ويندوز

# إنشاء ملف إعدادات نموذجي
python Python/EyeWitness.py --create-config

# استخدام ملف إعدادات
python Python/EyeWitness.py -f urls.txt --config ~/.eyewitness/config.json

🔍 التحقق من صحة الروابط

# قم بتفعيل البيئة الافتراضية أولاً
source eyewitness-venv/bin/activate  # لينكس/ماك
eyewitness-venv\Scripts\activate.bat # ويندوز

# التحقق من صحة الروابط دون التقاط لقطات شاشة
python Python/EyeWitness.py -f urls.txt --validate-urls

# تخطي التحقق (استخدم بحذر)
python Python/EyeWitness.py -f urls.txt --skip-validation

⚙️ خيارات متقدمة

# قم بتفعيل البيئة الافتراضية أولاً
source eyewitness-venv/bin/activate  # لينكس/ماك
eyewitness-venv\Scripts\activate.bat # ويندوز

# ضبط عدد الخيوط بناءً على نظامك (الافتراضي: اكتشاف تلقائي)
python Python/EyeWitness.py -f urls.txt --threads 5

# زيادة الوقت القصوى للاتصالات البطيئة
python Python/EyeWitness.py -f urls.txt --timeout 30

# إضافة تأخيرات وتشتت
python Python/EyeWitness.py -f urls.txt --delay 2 --jitter 5

# استخدام وكيل
python Python/EyeWitness.py -f urls.txt --proxy-ip 127.0.0.1 --proxy-port 8080

# دليل إخراج مخصص
python Python/EyeWitness.py -f urls.txt -d /path/to/output

# استئناف فحص سابق
python Python/EyeWitness.py --resume /path/to/output/ew.db

ضبط الأداء

يكتشف EyeWitness تلقائيًا موارد نظامك ويعدل وفقًا لذلك:

• عدد الخيوط بناءً على نوى وحدة المعالجة المركزية (2 × عدد النوى، بحد أقصى 20)
• مراقبة الذاكرة لمنع تحميل النظام الزائد
• فحص مساحة القرص قبل البدء

تنسيق ملف الإعدادات

أنشئ ملف إعدادات لحفظ الإعدادات المفضلة لديك:

{
    "threads": 10,
    "timeout": 30,
    "delay": 0,
    "jitter": 0,
    "user_agent": "وكيل مستخدم مخصص",
    "proxy_ip": "127.0.0.1",
    "proxy_port": 8080,
    "output_dir": "./sessions",
    "prepend_https": false,
    "show_selenium": false,
    "resolve": false,
    "skip_validation": false,
    "results_per_page": 25,
    "max_retries": 2
}

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

المشكلات الشائعة

لم يتم العثور على Chromium/ChromeDriver:

• جميع المنصات: أعد تشغيل نص الإعداد - فهو يقوم بتثبيت المتصفحات تلقائيًا
• لينكس: sudo ./setup.sh في مجلد setup/
• ويندوز: .\setup.ps1 كمسؤول في مجلد setup\
• ماك: sudo ./setup.sh في مجلد setup/ (بعد brew install --cask google-chrome)

مشاكل البيئة الافتراضية:

• احذف مجلد eyewitness-venv/ وأعد تشغيل نص الإعداد
• تأكد من تثبيت Python 3.7+ مع دعم وحدة venv
• تحقق من تشغيل نص الإعداد بصلاحيات المسؤول/الجذر المناسبة