Reconator एक स्वचालित टोही ढाँचा (reconnaissance framework) है। एक लक्ष्य जोड़ें — अकेला या एक साथ कई — और वर्कर उसके विरुद्ध ~17 recon मॉड्यूल चलाता है (सबडोमेन एनुम, डिरब्रूट, JS/लिंक माइनिंग, WAF फ़िंगरप्रिंट, टेकओवर जाँच, GF ट्राइएज, और भी बहुत कुछ)। डैशबोर्ड प्रति-मॉड्यूल आउटपुट दिखाता है जैसे ही वह आता है।

स्टैक

त्वरित आरंभ — Docker Compose

git clone https://github.com/gokulapap/Reconator
cd Reconator
cp .env.example .env       # optional: add Telegram / webhook keys / API key
docker compose up --build

त्वरित आरंभ — Heroku

या CLI के माध्यम से (heroku.yml कंटेनर स्टैक का उपयोग करता है — एकल इमेज UI + API प्रस्तुत करती है, वर्कर डायनो कतार चलाता है):

heroku create my-reconator --stack=container
heroku addons:create heroku-postgresql:essential-0
heroku config:set ADMIN_API_KEY=$(openssl rand -hex 32)   # recommended
heroku config:set TELEGRAM_API_KEY=... TELEGRAM_CHAT_ID=...   # optional
git push heroku master
heroku ps:scale web=1 worker=1

स्थानीय विकास

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

# worker (separate shell)
python -m app.worker

# web (separate shell)
cd frontend && npm install && npm run dev   # proxies /api → :8000

# tests + lint
cd backend && pytest && ruff check .

विशेषताएँ

• बल्क जोड़ें — 500 तक डोमेन चिपकाएँ; प्रति-पंक्ति त्रुटि / विरोध रिपोर्ट
• टैग + फ़िल्टरिंग — लक्ष्यों को टैग करें, टैग के अनुसार सूची को फ़िल्टर करें
• मॉड्यूल चयन — प्रति लक्ष्य केवल वांछित मॉड्यूल शेड्यूल करें
• रद्द करें + पुनः स्कैन — मॉड्यूल के बीच चल रहे लक्ष्य को रोकें; एक क्लिक में पुनः स्कैन
• प्रति-मॉड्यूल परिणाम — प्रत्येक जाँच का आउटपुट अपनी पंक्ति में, स्थिति, समय, त्रुटियों के साथ
• आउटपुट में खोज + हाइलाइट — विशाल सबडोमेन डंप को स्थान पर फ़िल्टर करें
• CSV / JSON निर्यात — पूरी कतार को API से बाहर निकालें
• लाइव डैशबोर्ड — गणना, औसत स्कैन अवधि, हाल की गतिविधि
• वैकल्पिक API-कुंजी प्रमाणीकरण — ADMIN_API_KEY सेट करें, सभी उत्परिवर्तनों के लिए X-API-Key आवश्यक
• दर सीमा — slowapi लेखन को सीमित करता है (डिफ़ॉल्ट: 20/मिनट एकल, 5/मिनट बल्क)
• Prometheus मीट्रिक्स — अनुरोध दर, विलंबता, स्कैन गणना, कतार गहराई
• Telegram + webhook फैन-आउट — सूचनाकर्ता अमूर्तता, दोनों एक साथ चल सकते हैं
• हल्का + गहरा UI — प्राथमिकता प्रति ब्राउज़र संग्रहीत

API सतह

OpenAPI /docs पर।

कॉन्फ़िगरेशन

v1 से क्या बदला

• Flask → FastAPI; SQL injection वेक्टर हट गए (पैरामीटराइज़्ड SQLAlchemy)
• एम्बेडेड HTML → React + shadcn/ui डैशबोर्ड
• DB में एकल base64 ब्लॉब → प्रति-मॉड्यूल पंक्तियाँ स्थिति/टाइमस्टैम्प/त्रुटियों के साथ
• cron.py पोलिंग लूप → पंक्ति-लॉकिंग, शांत शटडाउन, रद्दीकरण वाला वर्कर
• मैन्युअल Heroku buildpacks → heroku.yml के माध्यम से कंटेनर स्टैक
• जोड़ा गया: API-कुंजी प्रमाणीकरण, दर सीमा, अनुरोध ID, Prometheus, Sentry हुक, बल्क आयात, टैग, पुनः स्कैन, रद्द करें, वेबहुक सूचनाकर्ता, CSV/JSON निर्यात

अस्वीकरण

केवल अधिकृत परीक्षण के लिए। उन सिस्टम पर उपयोग करें जिनके आप स्वामी हैं या जिनका आकलन करने की आपकी अनुमति है। GPL-3.0 के तहत जारी किया गया।