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

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

Usages as an anonymous scanner from docker container (using tor inside docker)

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

Usages for an agressive scanning mode

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)

This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.

0.3.0 (2016-09-03)

• Optimize scanning by using a new tiny list of frequently used subdomains

• Introduce more efficient and faster default scanning mode, agressive scanning mode, and user keywords list based on scanning mode

0.2.0 (2016-09-03)

• New docker tag for allow anonymous scanning. Integrate a second dockerfile for build a container where network connections are relayed per a tor client embdded inside this container.

0.1.16 (2016-09-02)

• Apply Alpha development status for pypi classifiers

• Adding badges on README

0.1.15 (2016-09-01)

• Fixing mistake on Dockerfile (docker run command)

0.1.14 (2016-09-01)

• Fixing bad packaging. Error when loading dictionaries files.

0.1.13 (2016-09-01)

• Link official webpage with repo (pypi, github, docker)

0.1.12 (2016-08-31)

• Fix somes documentation mistakes and syntax error

• Update pypi project classifiers

0.1.11 (2016-08-31)

• Fix somes documentation mistakes and syntax error

0.1.10 (2016-08-31)

• Dockerize app

• Stable pypi deployment via travis-ci

0.1.6 (2016-08-31)

• First release on Pypi.

• Using click instead of argparse

0.1.0 (2016-08-29)

• First release on Github.