Recon-Scan

ReconScan هو ماسح استطلاع سلبي مفتوح المصدر مع خلفية FastAPI، وخط أنابيب عامل غير متزامن، وواجهة أمامية من صفحة واحدة. يمكنك التحقق من الموقع المنشور على https://recon-scan.vercel.app/

الهدف هو الإشارة السريعة: قم بتشغيل فحص، واحصل على النتائج وحدة بوحدة، واحصل على ملخص بالذكاء الاصطناعي يمكن الآن تصديره كتقرير PDF مصقول.

ملاحظة: العرض التجريبي غير مباشر لأنني نفدت من رموز الذكاء الاصطناعي. لا يزال بإمكانك الاستضافة الذاتية.

ما هو هذا المشروع (وما ليس كذلك)

• إنه استطلاع سلبي. لا يقوم بالقوة الغاشمة على نقاط النهاية، أو التشويش، أو تشغيل منطق الاستغلال النشط.
• إنه جيد للقطات الوضع، والفرز، وإعداد التقارير.
• إنه ليس بديلاً عن اختبار الاختراق الكامل.

الميزات

• 13 وحدة سلبية:
  • رؤوس الأمان
  • SSL/TLS
  • DNS + مصادقة البريد الإلكتروني (SPF/DMARC/MX)
  • WHOIS
  • Robots/sitemap
  • تعداد النطاقات الفرعية
  • بصمة التقنيات
  • كشف WAF
  • فحوصات CORS
  • فحوصات أمان ملفات تعريف الارتباط
  • فحوصات تعرض JS
  • فحوصات تعرض الدلائل
  • فحوصات السمعة
• تنفيذ غير متزامن مع Redis + عامل ARQ.
• الرجوع إلى التنفيذ في الخلفية داخل العملية إذا فشل إدراج قائمة الانتظار.
• ملخص اختياري بالذكاء الاصطناعي عبر OpenRouter / Anthropic / OpenAI.
• إنشاء تقرير PDF من الفحص + ملخص الذكاء الاصطناعي.
• الواجهة الأمامية تُخدم مباشرة بواسطة FastAPI (رابط واحد، تطبيق واحد).

بدء بأمر واحد (التطوير المحلي)

إذا كنت تريد فقط تشغيله بسرعة:

./start.sh

ما الذي يفعله هذا:

• ينشئ .env من .env.example إذا كان مفقودًا.
• ينشئ .venv إذا لزم الأمر.
• يثبت التبعيات من requirements.txt.
• يبدأ FastAPI مع إعادة التحميل السريع على http://localhost:8000.
• يفرض USE_ARQ_QUEUE=false لبدء محلي أسهل بدون Redis.

أوقف باستخدام Ctrl+C.

بدء بأمر واحد (Docker)

./start-docker.sh

ما الذي يفعله هذا:

• ينشئ .env من .env.example إذا كان مفقودًا.
• يبدأ API + عامل + Redis باستخدام Docker Compose.

بدء Docker (يدوي)

cp .env.example .env
docker compose up --build

التطوير المحلي (بدون Docker)

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

pip install -r requirements.txt

2. أنشئ ملف env:

cp .env.example .env

3. ابدأ API:

uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload

4. ابدأ العامل في طرفية أخرى (موصى به):

arq app.worker.WorkerSettings

5. افتح:

http://localhost:8000

تشغيل الاختبارات

ثبت تبعيات الاختبار:

pip install -r requirements-dev.txt

شغل المجموعة الكاملة:

pytest -q

تقارير PDF

بعد اكتمال الفحص، انقر على Download PDF في الواجهة.

نقطة نهاية الخلفية:

• GET /scans/{scan_id}/report.pdf

يتضمن التقرير:

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

API

• GET /health
• POST /scans
  • مثال على النص:
    • { "target": "example.com" }
    • { "target": "example.com", "byoapi_key": "...", "byoapi_provider": "your_provider" }
  • ملاحظات:
    • يتم رفض byoapi_key إلا إذا كان ALLOW_BYO_API_KEY=true
    • يتم حظر الأهداف الخاصة / الاسترجاعية / المحجوزة
    • user_id اختياري ويُحتفظ به للتوافق
• GET /scans/{scan_id}
• GET /scans/{scan_id}/report.pdf

التكوين

من .env.example:

• DATABASE_URL (افتراضي: sqlite:///./reconscan.db)
• REDIS_URL (افتراضي: redis://localhost:6379)
• USE_ARQ_QUEUE (افتراضي: true)
• RATE_LIMIT_PER_MINUTE (افتراضي: 10)
• RATE_LIMIT_PER_DAY (افتراضي: 200)
• ALLOWED_HOSTS (افتراضي: localhost,127.0.0.1)
• CORS_ALLOWED_ORIGINS (افتراضي: أصول التطوير المحلي)
• ALLOW_BYO_API_KEY (افتراضي: false)
• OPENROUTER_API_KEY, ANTHROPIC_API_KEY, OPENAI_API_KEY (اختياري)
• VIRUSTOTAL_API_KEY, GOOGLE_SAFE_BROWSING_API_KEY (اختياري)

المساهمة

المساهمات مرحب بها، خاصة حول وحدات الاستطلاع السلبي، وإعداد التقارير، وتجربة المستخدم للواجهة الأمامية، وتغطية الاختبارات.

يرجى قراءة إرشادات المساهمة الكاملة قبل فتح طلب سحب:

دليل المساهمة

ملاحظات

• إذا لم يتم تكوين مفتاح ذكاء اصطناعي خارجي، يخزن ReconScan ملخصًا احتياطيًا محليًا.
• SQLite هو محرك التخزين الافتراضي للاستخدام المحلي السهل.
• هذا المستودع خفيف الوزن عن قصد وصديق للاستضافة الذاتية.

الترخيص

MIT. انظر LICENSE.