dirsearch - Web-Pfad-Erkennung

Ein fortschrittlicher Web-Pfad-Brute-Forcer

dirsearch wird aktiv entwickelt von @maurosoria und @shelld3v.

Treten Sie dem Discord-Server bei, um mit dem Team zu kommunizieren.

Schnellstart

dirsearch benötigt Python 3.11 oder höher.

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

Sie können den neuesten Python-Stack auch direkt von GitHub mit pip installieren:

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

Das native Rust-Backend ist für Quellinstallationen optional; siehe Installation für die nativen Build-Schritte.

Vorgefertigte PyInstaller-Binärdateien und portable Ordnerarchive sind auf der Releases-Seite verfügbar.

Dokumentation

Die vollständige Dokumentation befindet sich jetzt in docs/:

• Installation: unterstützte Plattformen, Python-Installation, Release-Artefakte und Docker.
• Nutzungsleitfaden: gängige Scans, Rekursion, Filter, Proxys, Rohanfragen, Berichte und Tipps.
• Wortlisten: %EXT%, Kategorien, Vorlagen, Präfixe, Suffixe und Transformationen.
• CLI-Optionen: vollständige Befehlszeilenreferenz.
• Konfiguration: config.ini-Referenz.
• Sitzungen: Scan-Sitzungen speichern, auflisten und fortsetzen.
• Python-API: importierbare API-Beispiele.
• Erstellung: PyInstaller, portable Builds, Docker-Images und GitHub Actions.
• Referenzen: externe Tutorials und Artikel.

Minimale Beispiele

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

Verwenden Sie python3 dirsearch.py -h für die vollständige CLI-Hilfe.

Python-API

dirsearch kann auch aus Python-Code für lokale Automatisierung, MCP-Server, REST-Wrapper und agentengesteuerte Scans verwendet werden. Die importierbare API behält ihre Konfiguration in FuzzerConfig, sodass Aufrufer keine CLI-Flags parsen oder CLI-Globals mutieren müssen.

Siehe Python-API für Beispiele, die Vorlagen, benutzerdefinierte Wortlisten, Callbacks, authentifizierte Sitzungen und agentenorientierte Scan-Rezepte abdecken.

Mitwirken

Pull Requests und Feature-Anfragen sind willkommen. Siehe CONTRIBUTORS.md für die Personen, die zur Verbesserung von dirsearch beigetragen haben.

Lizenz

Copyright (C) Mauro Soria ([email protected])

Lizenz: GNU General Public License, Version 2.