OneForAll é desenvolvido e testado com base no Python 3.6.0. OneForAll requer uma versão superior ao Python 3.6.0 para funcionar. Para instalar o ambiente Python, consulte o Guia de Instalação do Python 3. Execute os seguintes comandos para verificar as versões do Python e pip3:

python -V
pip3 -V

Se você vir uma saída semelhante à abaixo, significa que o ambiente Python está correto:

Python 3.6.0
pip 19.2.2 from C:\Users\shmilylty\AppData\Roaming\Python\Python36\site-packages\pip (python 3.6)

1. Download

Como este projeto está em desenvolvimento, haverá atualizações e iterações contínuas. Ao baixar, use git clone para clonar o repositório de código mais recente, o que também facilita atualizações futuras. Não é recomendado baixar dos Releases, pois as versões nos Releases são atualizadas lentamente e não são convenientes para atualização. Este projeto já foi espelhado no Gitee (Gitee). Para usuários na China, recomenda-se clonar do Gitee, que é mais rápido:

git clone https://gitee.com/shmilylty/OneForAll.git

Ou:

git clone https://github.com/shmilylty/OneForAll.git

2. Instalação

Você pode instalar as dependências do OneForAll via pip3. Abaixo está um exemplo de instalação de dependências usando pip3 no sistema Windows: Nota: Se o seu Python3 estiver instalado no diretório Program Files do sistema, como C:\Program Files\Python36, execute o prompt de comando cmd como administrador e execute os seguintes comandos!

cd OneForAll/
python3 -m pip install -U pip setuptools wheel -i https://mirrors.aliyun.com/pypi/simple/
pip3 install -r requirements.txt -i https://mirrors.aliyun.com/pypi/simple/
python3 oneforall.py --help

Para outras plataformas, consulte Instalação de Dependências. Se você encontrar problemas ao compilar alguma biblioteca de dependência durante a instalação, consulte as soluções no documento Perguntas Frequentes e Respostas.md. Se o problema persistir, sinta-se à vontade para entrar no grupo e relatar o problema.

3. Atualização

Execute os seguintes comandos para atualizar o projeto (as modificações em /config/setting.py e /config/api.py podem ser preservadas):

git stash        # Armazena temporariamente as modificações locais
git fetch --all  # Obtém as atualizações do projeto
git pull         # Baixa e mescla
git stash pop    # Libera as modificações locais

Primeiro, baixe e edite o arquivo de configuração, adicione suas próprias api e configurações personalizadas, e mantenha a estrutura de arquivos original

config
├── api.py
├── default.py
├── __init__.py
├── log.py
└── setting.py

Puxe a imagem e execute, substituindo ~/.config pelo caminho da pasta onde estão seus arquivos de configuração

docker pull shmilylty/oneforall
docker run -it --rm -v ~/results:/OneForAll/results -v ~/.config:/OneForAll/config shmilylty/oneforall --target example.com run

Os parâmetros são adicionados diretamente no final do comando. Os resultados serão gerados no diretório local ~/results. Se desejar salvar em outro local, você pode modificar conforme necessário.

Se você instalou as dependências via pip3, use os seguintes comandos para executar o exemplo:

python3 oneforall.py --target example.com run
python3 oneforall.py --targets ./example.txt run

Tomando o comando python3 oneforall.py --target example.com run como exemplo, quando o OneForAll é executado normalmente com parâmetros padrão, ele gera os resultados correspondentes no diretório results:

example.com.csv é o resultado da coleta de subdomínios para cada domínio principal.

all_subdomain_result_1583034493.csv é o resumo dos subdomínios coletados em cada execução do OneForAll, incluindo example.com.csv, facilitando a obtenção de todos os resultados em cenários de coleta em lote.

result.sqlite3 é o banco de dados SQLite3 que armazena os subdomínios coletados em cada execução do OneForAll. Sua estrutura de banco de dados é mostrada na figura abaixo:

A tabela com nome como example_com_origin_result armazena os resultados iniciais da coleta de subdomínios de cada módulo.

A tabela com nome como example_com_resolve_result armazena os resultados após a resolução dos subdomínios.

A tabela com nome como example_com_last_result armazena os resultados da última coleta de subdomínios (gerada somente após duas ou mais coletas).

A tabela com nome como example_com_now_result armazena os resultados atuais da coleta de subdomínios. Em geral, basta focar nesta tabela.

Para mais informações, consulte Explicação dos Campos.