dirsearch — Обнаружение веб-путей

Stars

Продвинутый переборщик веб-путей

dirsearch активно разрабатывается @maurosoria и @shelld3v.

Присоединяйтесь к серверу Discord для общения с командой.

Быстрый старт

Для работы dirsearch требуется Python 3.11 или выше.

git clone https://github.com/maurosoria/dirsearch.git --depth 1
cd dirsearch
python3 dirsearch.py -u https://example.com -e php,html,js

Также можно установить последнюю версию Python-стека напрямую из GitHub с помощью pip:

pip3 install git+https://github.com/maurosoria/dirsearch.git
dirsearch -u https://example.com -e php,html,js

Собственный бэкенд на Rust — опциональная возможность для установок из исходников; инструкции по сборке см. в Установке.

Предварительно собранные бинарники PyInstaller и переносимые архивы папок доступны на странице релизов.

Документация

Полная документация теперь находится в docs/:

Установка: поддерживаемые платформы, установка через Python, артефакты релизов и Docker.
Руководство по использованию: типовые сканирования, рекурсия, фильтры, прокси, сырые запросы, отчёты и советы.
Словники: %EXT%, категории, шаблоны, префиксы, суффиксы и преобразования.
Параметры CLI: полная справка по командной строке.
Конфигурация: справочник по config.ini.
Сессии: сохранение, просмотр и возобновление сеансов сканирования.
Python API: примеры импортируемого API.
Сборка: PyInstaller, портативные сборки, Docker-образы и GitHub Actions.
Ссылки: внешние руководства и статьи.

Минимальные примеры

python3 dirsearch.py -u https://target
python3 dirsearch.py -u https://target -e php,html,js
python3 dirsearch.py -u https://target -e php,html,js -w /path/to/wordlist
python3 dirsearch.py -u https://target -r --max-recursion-depth 3

Используйте python3 dirsearch.py -h для полной справки по CLI.

Python API

dirsearch также можно использовать из кода Python для локальной автоматизации, MCP-серверов, REST-обёрток и сканирований под управлением агентов. Импортируемый API хранит свою конфигурацию в FuzzerConfig, поэтому вызывающим сторонам не нужно разбирать флаги CLI или изменять глобальные переменные CLI.

См. Python API — примеры, охватывающие шаблоны, пользовательские словники, обратные вызовы, аутентифицированные сессии и рецепты сканирования для агентов.

Вклад в проект

Приветствуются пул-реквесты и запросы функций. Список людей, которые помогли улучшить dirsearch, см. в CONTRIBUTORS.md.

Лицензия

Лицензия: GNU General Public License, версия 2.

dirsearch

Популярное