🔍 Knockpy Subdomain Scan v9.0

✅ Быстро и асинхронно • 🔐 Разведка + Брутфорс • 🔧 Легко расширять

KnockPy — это модульный инструмент на Python 3 для перечисления поддоменов с помощью пассивной разведки и брутфорса, теперь с поддержкой async/await, улучшенной производительностью и современной обработкой HTTP/TLS.

🚀 Возможности (v9)

✅ Асинхронное сканирование с помощью httpx и DNS-разрешения
✅ Модульная архитектура: легко подключать новые пассивные источники
🔍 Поддерживает пассивную разведку, брутфорс или оба режима
🎨 Форматированный вывод в терминал с помощью Rich (таблицы, прогресс, панели)
📜 Проверяет статус HTTP/HTTPS, TLS-сертификат и IP
⚠️ Обнаруживает поддержку устаревших версий TLS (TLS 1.0/1.1) как предупреждение в CLI/подробном режиме/HTML-отчёте
🧾 Проверяет AXFR (передачу зоны) на корневом домене при сканировании в режиме домена
🔎 --verbose — диагностика одного домена (DNS/TCP/TLS/цепочки перенаправлений/ошибки запроса + проверки безопасности)
💡 Поддерживает обнаружение wildcard DNS
🧪 Отчёты в SQLite с интерактивным каталогом (show/delete/export/search)
🔐 Поддерживает API VirusTotal и Shodan
🚀 Оптимизированное время выполнения брутфорса с кэшированием конечных точек TLS-проверки (без изменения таймаутов)

📦 Установка

Из исходного кода GitHub (рекомендуется)

git clone https://github.com/guelfoweb/knockpy.git
cd knockpy
# рекомендуется: установка в виртуальное окружение
python3 -m venv .venv
. .venv/bin/activate
python3 -m pip install -U pip
pip install .

# альтернатива: установка для текущего пользователя (без venv)
# python3 -m pip install --user .

⚠️ Рекомендуемая версия Python: 3.9+

🧱 Структура проекта

Кодовая база организована по ответственности, со стабильными фасадами для обратной совместимости:

knockpy/
  cli.py                   # Точка входа CLI (фасад/оркестровка)
  cli_parts/
    status.py              # Отрисовка панели состояния/выполнения
    setup.py               # Интерактивная настройка и сохраняемые настройки по умолчанию
    report.py              # Интерактивный режим отчёта
    scan_flow.py           # Правила исключения, проверка разведки, wildcard-вспомогатели
  core.py                  # Публичный фасад ядра (совместимость)
  engine/
    runtime.py             # Реализация движка сканирования
  storage.py               # Публичный фасад хранилища (совместимость)
  storage_parts/
    db.py                  # Постоянное хранение/настройки в SQLite
    export.py              # Оркестровка экспорта отчётов
    html_report.py         # Отрисовка HTML-отчёта
  output.py                # Отрисовка вывода в терминал
  server_versions.py       # Каталог версий веб-серверов
  knockpy.py               # Экспорты модулей для совместимости

Примечание о совместимости:

Предпочтительный внешний импорт: import knockpy или from knockpy import KNOCKPY.
Внутренние модули разделены на engine/, cli_parts/ и storage_parts/.

Установка через pip

Только после выпуска стабильной версии на GitHub

pip install knock-subdomains

🧪 Использование

knockpy -d domain.com [опции]

Опции

Флаг	Описание
`-d`, `--domain`	Целевой домен (или stdin, если используется без значения)
`-f`, `--file`	Файл со списком доменов
`--recon`	Включить пассивную разведку
`--bruteforce`, `--brute`	Включить брутфорс с использованием словаря
`--exclude TYPE VALUE`	Исключить совпадения (`status`, `length/lenght`, `body`)
`--verbose`	Глубокая диагностика только для сканирования одного домена
`--wildcard`	Проверить wildcard DNS и выйти
`--test`	С `--recon` проверить каждый источник разведки (неудачные/пустые/данные)
`--setup`	Интерактивная настройка (настройки по умолчанию + ключи API в БД)
`--update-versions`	Обновить локальный каталог последних версий веб-серверов
`--report [ID\|latest\|list]`	Режим отчёта (интерактивный показ/удаление/экспорт/поиск/сброс БД, экспорт HTML)
`--check-update`	Проверить онлайн, доступна ли новая версия Knockpy на PyPI
`--wordlist`	Переопределение словаря во время выполнения
`--dns`	Переопределение DNS-резолвера во время выполнения
`--useragent`	Переопределение HTTP user-agent во время выполнения
`--timeout`	Переопределение таймаута (секунды) во время выполнения
`--threads`	Переопределение количества параллельных рабочих процессов
`--silent`	Скрыть индикатор прогресса
`--json`	Вывод только в JSON (вынуждает `--silent`)
`--status`	Вывести текущий статус и продолжить
`-h`, `--help`	Показать справочное сообщение

Тонкая настройка производительности: `--threads` и `--timeout`

Эти две опции оказывают наибольшее влияние на время выполнения для больших сканирований.

--threads управляет конкурентностью (сколько целей обрабатывается параллельно)
--timeout управляет тем, сколько времени каждый сетевой шаг ждёт перед сдачей

Компромисс:

выше threads = более быстрое сканирование, но большая нагрузка на ЦП/сеть/DNS и выше риск удаленных ограничений скорости
меньше timeout = более быстрое сканирование, но выше риск пропустить медленные, но действительные цели (ложноотрицательные результаты)

Рекомендуемые профили:

небольшое/точное сканирование (несколько доменов): --threads 50 --timeout 5
сбалансированное сканирование: --threads 150 --timeout 4
большое сканирование (10k+ доменов): начните с --threads 250 --timeout 3

Если вам нужны и скорость, и полнота для очень больших списков, используйте стратегию в 2 прохода:

быстрый проход: --threads 250 --timeout 3
повторный проход только для пропущенных/неопределённых целей: --threads 80 --timeout 5 (или больше)

Замечания:

значения CLI всегда переопределяют сохранённые настройки
сохранённые настройки (--setup) переопределяют встроенные значения по умолчанию
текущие встроенные значения по умолчанию: threads=250, timeout=3

📌 Примеры

🔎 Разведка + Брутфорс

knockpy -d example.com --recon --bruteforce

🧪 Тестирование сервисов разведки

knockpy -d example.com --recon --test

🔄 Обновить каталог последних версий веб-серверов

knockpy --update-versions

🆕 Проверить наличие обновлений Knockpy

knockpy --check-update

⚙️ Конфигурация источников разведки (редактируемая)

При первом запуске KnockPy создаёт:

~/.knockpy/recon_services.json

Вы можете добавлять/отключать источники, редактируя массив services. Вы также можете указать путь к пользовательскому файлу без изменения кода:

export KNOCK_RECON_SERVICES=/path/to/recon_services.json

Каждый сервис поддерживает:

name
enabled (true/false)
parser
url_template (поддерживает {domain}, {virustotal_key}, {shodan_key})
requires_api (virustotal или shodan, опционально)

Поддерживаемые парсеры:

csv_first_column
rapiddns_html_td
json_list
virustotal_subdomains
shodan_subdomains

📥 Домен из stdin

echo "example.com" | knockpy -d

🧠 API-ключи (опционально)

export API_KEY_VIRUSTOTAL=ваш-ключ-virustotal
export API_KEY_SHODAN=ваш-ключ-shodan

Вы можете использовать файл .env:

API_KEY_VIRUSTOTAL=ваш-ключ-virustotal
API_KEY_SHODAN=ваш-ключ-shodan

💾 Отчёты (SQLite + интерактивный экспорт в HTML)

knockpy -d example.com --recon --bruteforce
knockpy --report list
knockpy --report latest
knockpy --report

Интерактивное меню отчёта:

Популярное

knockpy