discosub 0.3.0

Free and opensource subdomain scanner. Discosub is simple and faster subdomain discover.

Discosub test if a list of subdomains exist via fuzzing on root domain.

Discosub use dictionaries for perform an analyze (BruteForce).

You can use discosub directly from a python interpreter, or use it inside docker container.

You can perform an anonymous scanning directly by using a specific docker version (alias tor).

Different type of docker container are available:

• simple docker container with discosub installed on
• torified (tor) docker container with discosub installed on (all discosub scanning connections use tor network)

For more details visit the official webpage project.

Install from pypi

pip install -U discosub

Install as a docker container

docker pull 4383/discosub:latest

Install as an anonymous scanner (tor + docker)

docker pull 4383/discosub:tor

Install from sources

$ git clone https://github.com/4383/discosub
$ cd discosub
$ python setup.py install

Usages from a local installation (from pypi or from sources)

discosub run google.com

Usages inside a docker container (agressive mode off for moment)

docker run -e "TARGET=google.com" 4383/discosub:latest

Usages as an anonymous scanner from docker container (using tor inside docker) (agressive mode off for moment)

docker run -e "TARGET=google.com" 4383/discosub:tor

Usages for an agressive mode scanning

discosub run google.com -a

Prerequistes

• python >= 2.6 (but prefer python3.x)

Features

• Analyze a root domain and discover its subdomains
• Analyze domain over tor via specific docker container (anonymous scanning)

Advertissments

• scan over docker container are more slowly than direct usage from python interpreter
• scan over torified docker container are more slowly than direct usage from python interpreter and classical discosub docker container
• scan over torified docker container are more verbose than an classical scanning (identifiable IP)

Upcoming features

• Perform whois request on discovered subdomains
• Pass discosub options to docker container on run
• Perform scanning from user keywords file
• Save output into a file

License

• Free software: GNU General Public License v3

Credits

Author: 4383 (Hervé Beraud)

For create this project I've used some tools and packages so I want to thank them !

• bumpversion. A magical python tools for automatic bumping version.
• click. An amazing python package for handle cli options, arguments and flags, and more features !
• Vincent Driessen and his successful Git branching model
• The Semantic Versioning specification. A beautiful crafted specification who help me each days at work and on my personal projects.
• Cookiecutter. A fucking good python command-line utility for initialize project.
• and all others what I've forgotten

This project was initialized with the audreyr/cookiecutter-pypackage project template.