4383/discosub repository overview

⁠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.