dirsearch - Scoperta di Percorsi Web

Un avanzato brute-forcer di percorsi web

dirsearch è attivamente sviluppato da @maurosoria e @shelld3v.

Unisciti al server Discord per comunicare con il team.

Avvio Rapido

dirsearch richiede Python 3.11 o superiore.

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

Puoi anche installare l'ultimo stack Python direttamente da GitHub con pip:

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

Il backend nativo Rust è opzionale per le installazioni da sorgente; consulta Installazione per i passaggi di compilazione nativa.

I binari PyInstaller precompilati e gli archivi di cartelle portatili sono disponibili sulla pagina delle Release.

Documentazione

La documentazione completa ora si trova in docs/:

• Installazione: piattaforme supportate, installazione Python, artefatti di rilascio e Docker.
• Guida all'uso: scansioni comuni, ricorsione, filtri, proxy, richieste raw, report e suggerimenti.
• Wordlists: %EXT%, categorie, template, prefissi, suffissi e trasformazioni.
• Opzioni CLI: riferimento completo della riga di comando.
• Configurazione: riferimento a config.ini.
• Sessioni: salvare, elencare e riprendere sessioni di scansione.
• API Python: esempi di API importabili.
• Compilazione: PyInstaller, build portatili, immagini Docker e GitHub Actions.
• Riferimenti: tutorial e articoli esterni.

Esempi Minimi

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

Usa python3 dirsearch.py -h per l'aiuto completo della CLI.

API Python

dirsearch può anche essere utilizzato da codice Python per automazione locale, server MCP, wrapper REST e scansioni controllate da agenti. L'API importabile mantiene la sua configurazione in FuzzerConfig, quindi i chiamanti non devono analizzare i flag CLI o mutare le variabili globali della CLI.

Vedi API Python per esempi che coprono template, wordlists personalizzate, callback, sessioni autenticate e ricette di scansione orientate agli agenti.

Contribuire

Pull request e richieste di funzionalità sono benvenute. Consulta CONTRIBUTORS.md per le persone che hanno contribuito a migliorare dirsearch.

Licenza

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

Licenza: GNU General Public License, versione 2.