Reconator هي إطار عمل استطلاع آلي. أضف هدفًا — منفردًا أو بالجملة — ويقوم العامل (worker) بتشغيل حوالي 17 وحدة استطلاع ضده (تعداد النطاقات الفرعية (subdomain enum)، مسح الأدلة (dirbrute)، تعدين JS/الروابط، بصمة WAF، فحص الاستيلاء (takeover check)، فرز GF (GF triage)، والمزيد). توضح لوحة التحكم ناتج كل وحدة فور وصوله.

المكدس التقني

بداية سريعة — Docker Compose

git clone https://github.com/gokulapap/Reconator
cd Reconator
cp .env.example .env       # اختياري: أضف مفاتيح Telegram / webhook / مفتاح API
docker compose up --build

بداية سريعة — Heroku

أو عبر CLI (يستخدم مكدس حاوية heroku.yml — صورة واحدة تخدم واجهة المستخدم و API، ويعمل dyno العامل على تشغيل الطابور):

heroku create my-reconator --stack=container
heroku addons:create heroku-postgresql:essential-0
heroku config:set ADMIN_API_KEY=$(openssl rand -hex 32)   # موصى به
heroku config:set TELEGRAM_API_KEY=... TELEGRAM_CHAT_ID=...   # اختياري
git push heroku master
heroku ps:scale web=1 worker=1

التطوير المحلي

# api
cd backend && pip install -r requirements.txt
uvicorn app.main:app --reload

# العامل (نافذة منفصلة)
python -m app.worker

# الويب (نافذة منفصلة)
cd frontend && npm install && npm run dev   # يعيد توجيه /api ← :8000

# الاختبارات + الفحص
cd backend && pytest && ruff check .

الميزات

• إضافة بالجملة — لصق حتى 500 نطاق؛ تقرير خطأ/تعارض لكل صف
• الوسوم + التصفية — وسم الأهداف، تصفية القائمة حسب الوسم
• اختيار الوحدة — جدولة الوحدات التي تريدها فقط لكل هدف
• إلغاء + إعادة مسح — إيقاف هدف قيد التشغيل بين الوحدات؛ إعادة مسح بنقرة واحدة
• نتائج لكل وحدة — ناتج كل فحص هو صف خاص به، مع الحالة، التوقيت، الأخطاء
• بحث + تمييز داخل الناتج — تصفية تفريغات النطاقات الفرعية الضخمة في مكانها
• تصدير CSV / JSON — سحب الطابور بأكمله من API
• لوحة تحكم حية — أعداد، مدة المسح المتوسطة، النشاط الأخير
• مصادقة اختيارية بمفتاح API — تعيين ADMIN_API_KEY، جميع التعديلات تتطلب X-API-Key
• تحديد المعدل — slowapi يحدد الكتابة (الافتراضي: 20/دقيقة فردي، 5/دقيقة بالجملة)
• مقاييس Prometheus — معدل الطلب، زمن الاستجابة، عدد المسوحات، عمق الطابور
• Telegram + نشر webhook — تجريد المُخطر، يمكن تشغيلهما معًا
• واجهة مستخدم فاتحة + داكنة — تُخزن التفضيلات في المتصفح

واجهة API

OpenAPI متاح على /docs.

الإعدادات

ما الجديد مقارنة بـ v1

• Flask → FastAPI; اختفت نواقل حقن SQL (SQLAlchemy مع المعاملات)
• HTML المدمج → لوحة تحكم React + shadcn/ui
• كتلة base64 واحدة في قاعدة البيانات → صفوف لكل وحدة مع الحالة / الطوابع الزمنية / الأخطاء
• حلقة استقصاء cron.py → عامل مع قفل الصفوف، إيقاف تشغيل لطيف، إلغاء
• حزم بناء Heroku اليدوية → مكدس حاويات عبر heroku.yml
• أضيف: مصادقة مفتاح API، تحديد المعدل، معرفات الطلب، Prometheus، خطاف Sentry، استيراد بالجملة، وسوم، إعادة مسح، إلغاء، مُخطر webhook، تصدير CSV/JSON

إخلاء مسؤولية

للاستخدام في الاختبارات المأذون بها فقط. استخدم على أنظمة تمتلكها أو لديك إذن لتقييمها. صدر بموجب GPL-3.0.