Sublist3r README

The project's README from github.com/aboul3la/Sublist3r. As one markdown file: README.md.

About Sublist3r

Sublist3r is a python tool designed to enumerate subdomains of websites using OSINT. It helps penetration testers and bug hunters collect and gather subdomains for the domain they are targeting. Sublist3r enumerates subdomains using many search engines such as Google, Yahoo, Bing, Baidu and Ask. Sublist3r also enumerates subdomains using Netcraft, Virustotal, ThreatCrowd, DNSdumpster and ReverseDNS.

subbrute was integrated with Sublist3r to increase the possibility of finding more subdomains using bruteforce with an improved wordlist. The credit goes to TheRook who is the author of subbrute.

Screenshots

Sublist3r

Installation

git clone https://github.com/aboul3la/Sublist3r.git

Sublist3r currently supports Python 2 and Python 3.

Dependencies:

Sublist3r depends on the requests, dnspython and argparse python modules.

These dependencies can be installed using the requirements file:

c:\python27\python.exe -m pip install -r requirements.txt

sudo pip install -r requirements.txt

Alternatively, each module can be installed independently as shown below.

Requests Module (http://docs.python-requests.org/en/latest/)

c:\python27\python.exe -m pip install requests

sudo apt-get install python-requests

sudo yum install python-requests

sudo pip install requests

dnspython Module (http://www.dnspython.org/)

c:\python27\python.exe -m pip install dnspython

sudo apt-get install python-dnspython

sudo pip install dnspython

argparse Module

sudo apt-get install python-argparse

sudo yum install python-argparse

sudo pip install argparse

for coloring in windows install the following libraries

c:\python27\python.exe -m pip install win_unicode_console colorama

Usage

Short Form Long Form Description
-d --domain Domain name to enumerate subdomains of
-b --bruteforce Enable the subbrute bruteforce module
-p --ports Scan the found subdomains against specific tcp ports
-v --verbose Enable the verbose mode and display results in realtime
-t --threads Number of threads to use for subbrute bruteforce
-e --engines Specify a comma-separated list of search engines
-o --output Save the results to text file
-h --help show the help message and exit

Examples

python sublist3r.py -h

python sublist3r.py -d example.com

python sublist3r.py -d example.com -p 80,443

python sublist3r.py -v -d example.com

python sublist3r.py -b -d example.com

python sublist3r.py -e google,yahoo,virustotal -d example.com

Using Sublist3r as a module in your python scripts

Example

import sublist3r 
subdomains = sublist3r.main(domain, no_threads, savefile, ports, silent, verbose, enable_bruteforce, engines)

The main function will return a set of unique subdomains found by Sublist3r

Function Usage:

Example to enumerate subdomains of Yahoo.com:

import sublist3r 
subdomains = sublist3r.main('yahoo.com', 40, 'yahoo_subdomains.txt', ports= None, silent=False, verbose= False, enable_bruteforce= False, engines=None)

License

Sublist3r is licensed under the GNU GPL license. take a look at the LICENSE for more information.

Credits

Thanks

Version

Current version is 1.0

Sublist3r (aboul3la/Sublist3r)

Searching Database…

11.1K ·GitHub
Sublist3r
Что это такое?Sublist3r — это инструмент на Python, который с помощью OSINT собирает поддомены целевого сайта. Он помогает специалистам по тестированию на проникновение и охотникам за багами найти поддомены домена, который они исследуют.
Это просто CLI-скрипт или его можно использовать и в моём коде?В основном это скрипт на Python для командной строки, но его главную функцию можно импортировать напрямую в свои Python-скрипты.
Как его запустить?Установите зависимости из файла requirements (через pip в Windows или Linux), а затем выполните что-то вроде 'python sublist3r.py -d example.com', чтобы собрать поддомены домена.
Что нужно установить перед запуском?Ему нужны модули Python requests, dnspython и argparse, поддерживаются версии Python 2.7.x и Python 3.4.x.
Есть ли подвох в том, как он находит поддомены?Результаты зависят от сторонних источников (Google, Yahoo, Bing, Baidu, Ask, Netcraft, Virustotal, ThreatCrowd, DNSdumpster), поэтому полнота зависит от того, остаются ли эти сервисы доступными и не блокируют ли они автоматические запросы. Проект пока на версии 1.0.
Работает ли он на Windows так же, как на Linux?Да, в README отдельно описана установка зависимостей для Windows и для Linux (Ubuntu/Debian/Centos). Так как это чистый Python, он также работает на macOS.
Из каких источников он получает поддомены?Он запрашивает поисковые системы, такие как Google, Yahoo, Bing, Baidu и Ask, а также Netcraft, Virustotal, ThreatCrowd, DNSdumpster и ReverseDNS.
Умеет ли он перебирать поддомены по словарю?Да, флаг -b включает встроенный модуль subbrute с улучшенным списком слов для поиска поддоменов перебором.
Можно ли проверить, какие порты открыты на найденных поддоменах?Да, флаг -p проверяет найденные поддомены на указанных TCP-портах, например 80 и 443.
Можно ли вызвать Sublist3r из моих Python-скриптов?Да, можно импортировать его главную функцию с параметрами вроде domain, savefile, ports, silent, verbose, enablebruteforce и engines. Она возвращает набор уникальных поддоменов.
What are similar projects?bbot, OneForAll, theHarvester, GhostTrack, Photon, spiderfoot, thc-hydra, maigret
Which topics is it in?wordlist, subdomain-enumeration, subdomain, bruteforce, security-testing, recon, information-gathering, reconnaissance, search-engine, osint, hacking-tool, gplv2
Creator
aboul3la
Size
1.1 MB
Stars
11.1K
Updated
CommitJul 29Release1.1Apr 06
Age
10y
Commits · 90 Days