dirsearch — descoberta de caminhos web

Descoberta de caminhos web

Em uma avaliação de segurança de aplicações, conhecer os caminhos publicados por um site ajuda a mapear sua superfície web. O dirsearch automatiza essa busca: ele testa caminhos candidatos e atua como um scanner de descoberta de diretórios e arquivos. O projeto é direcionado a atividades de segurança, como pentest e bug bounty.

A busca pode considerar extensões específicas. Por exemplo, o comando `python3 dirsearch.py -u https://example.com -e php,html,js` procura caminhos associados a arquivos PHP, HTML e JavaScript. Para direcionar a enumeração a uma lista própria, a opção `-w` recebe o caminho do arquivo de wordlist.

Ajuste da busca

O dirsearch também permite busca recursiva. Com `-r --max-recursion-depth 3`, a ferramenta continua a enumeração em caminhos encontrados, respeitando o limite de profundidade indicado. Essa configuração ajuda a explorar níveis adicionais da estrutura sem deixar a recursão sem um teto explícito.

As wordlists são parte importante dessa rotina. A documentação do projeto cobre categorias, modelos, prefixos, sufixos, transformações e o marcador `%EXT%`. O guia de uso também reúne orientações sobre filtros, proxies, requisições brutas e relatórios, recursos que ajudam a ajustar a execução ao cenário de teste.

Instalação e primeiros comandos

O requisito informado pelo projeto é Python 3.11 ou superior. Uma opção é clonar o repositório com `git clone https://github.com/maurosoria/dirsearch.git --depth 1`, entrar na pasta e executar `python3 dirsearch.py -u https://target`. Para uma instalação direta do projeto publicado no GitHub, o README também documenta `pip3 install git+https://github.com/maurosoria/dirsearch.git`, seguido do comando `dirsearch`.

O código-fonte pode usar um backend nativo em Rust como opção adicional; a instalação desse componente tem etapas próprias. Também há binários pré-compilados com PyInstaller e arquivos portáteis nas versões publicadas pelo projeto, além de documentação para instalação e uso com Docker.

Automação e sessões

Para execuções repetidas, o dirsearch oferece suporte a sessões que podem ser salvas, listadas e retomadas. A configuração pode ser consultada em `config.ini`, enquanto a referência de linha de comando detalha as opções disponíveis. Esses recursos ajudam a manter o processo organizado entre diferentes etapas de uma avaliação.

O projeto ainda disponibiliza uma API Python importável, configurada por meio de `FuzzerConfig`. Os exemplos documentados incluem modelos de busca, wordlists personalizadas, callbacks, sessões autenticadas e receitas de varredura controladas por agentes. Isso permite integrar a ferramenta a rotinas locais de automação e a wrappers.

Projeto e licença

O dirsearch é mantido publicamente no GitHub, onde aceita contribuições e solicitações de recursos. Sua licença é a GNU General Public License, versão 2. Para quem trabalha com testes autorizados de aplicações web, a combinação de wordlists ajustáveis, recursão controlada e opções de automação oferece um caminho prático para mapear rotas e arquivos expostos.