Recon-Scan

ReconScan — это открытый сканер пассивной разведки с бэкендом на FastAPI, асинхронным конвейером воркеров и одностраничным фронтендом. Развёрнутый сайт можно посмотреть по адресу https://recon-scan.vercel.app/

Суть — быстрый сигнал: запустите сканирование, получите результаты по каждому модулю и получите AI-сводку, которую теперь можно экспортировать в виде аккуратного PDF-отчёта.

Примечание: демо не работает, так как у меня закончились AI-токены. Вы всё ещё можете развернуть проект самостоятельно.

Что представляет собой этот проект (и чем он не является)

• Это пассивная разведка. Он не выполняет брутфорс эндпоинтов, фаззинг или активную эксплуатацию.
• Он подходит для снимков состояния защищённости, триажа и отчётности.
• Он не заменяет полноценное тестирование на проникновение.

Возможности

• 13 пассивных модулей:
  • Заголовки безопасности
  • SSL/TLS
  • DNS + аутентификация email (SPF/DMARC/MX)
  • WHOIS
  • Robots/sitemap
  • Перечисление поддоменов
  • Определение технологий
  • Обнаружение WAF
  • Проверки CORS
  • Проверки безопасности cookie
  • Проверки раскрытия JS
  • Проверки раскрытия директорий
  • Проверки репутации
• Асинхронное выполнение с Redis + ARQ worker.
• Резервный переход на внутрипроцессное фоновое выполнение, если постановка в очередь не удалась.
• Опциональная AI-сводка через OpenRouter / Anthropic / OpenAI.
• Генерация PDF-отчёта из сканирования + AI-сводки.
• Фронтенд обслуживается напрямую FastAPI (один URL, одно приложение).

Запуск одной командой (локальная разработка)

Если вы просто хотите быстро всё запустить:

./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 + worker + Redis с помощью Docker Compose.

Запуск в Docker (вручную)

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

Локальная разработка (без Docker)

1. Установите зависимости:

pip install -r requirements.txt

2. Создайте файл окружения:

cp .env.example .env

3. Запустите API:

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

4. Запустите worker в другом терминале (рекомендуется):

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

Отчёт включает:

• Метаданные цели и сканирования
• AI-резюме для руководства (краткое + полное описание, когда доступно)
• Таблицу снимка уровней серьёзности
• Подробные результаты по каждому модулю

API

• GET /health
• POST /scans
  • пример тела запроса:
    • { "target": "example.com" }
    • { "target": "example.com", "byoapi_key": "...", "byoapi_provider": "your_provider" }
  • примечания:
    • byoapi_key отклоняется, если ALLOW_BYO_API_KEY=true не установлено
    • приватные / loopback / зарезервированные цели блокируются
    • 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 (опционально)

Участие в разработке

Вклад приветствуется, особенно в части модулей пассивной разведки, отчётности, UX фронтенда и покрытия тестами.

Пожалуйста, прочитайте полные рекомендации по участию перед открытием pull request:

Руководство по участию

Примечания

• Если внешний AI-ключ не настроен, ReconScan сохраняет локальную резервную сводку.
• SQLite — движок хранения по умолчанию для удобного локального использования.
• Этот репозиторий намеренно лёгкий и удобный для самостоятельного развёртывания.

Лицензия

MIT. См. LICENSE.