Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/4383/discosub
Simple, Faster, & Efficient, Subdomain Discovery Scanner
https://github.com/4383/discosub
Last synced: 3 months ago
JSON representation
Simple, Faster, & Efficient, Subdomain Discovery Scanner
- Host: GitHub
- URL: https://github.com/4383/discosub
- Owner: 4383
- License: other
- Created: 2016-08-29T22:51:12.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2016-10-03T10:51:33.000Z (over 8 years ago)
- Last Synced: 2024-10-17T19:43:47.653Z (4 months ago)
- Language: Python
- Homepage:
- Size: 829 KB
- Stars: 2
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: HISTORY.rst
- Contributing: CONTRIBUTING.rst
- License: LICENSE
Awesome Lists containing this project
README
# 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](https://hub.docker.com/r/4383/discosub/tags/) (alias tor).
Different type of docker container are available:
* simple docker container with discosub installed on
* [torified (tor)](https://www.torproject.org/) docker container with discosub installed on (all discosub scanning connections use tor network)
For more details visit the [official webpage project](https://4383.github.io/discosub/).
## Install from pypi
```shell
pip install -U discosub
```
## Install as a docker container
```shell
docker pull 4383/discosub:latest
```
## Install as an anonymous scanner (tor + docker)
```shell
docker pull 4383/discosub:tor
```
## Install from sources
```shell
$ git clone https://github.com/4383/discosub
$ cd discosub
$ python setup.py install
```
## Usages from a local installation (from pypi or from sources)
```shell
discosub run google.com
```
## Usages inside a docker container (agressive mode off for moment)
```shell
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)
```shell
docker run -e "TARGET=google.com" 4383/discosub:tor
```
## Usages for an agressive mode scanning
```shell
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](https://pypi.python.org/pypi/bumpversion). A magical python tools for automatic bumping version.
* [click](http://click.pocoo.org/). An amazing python package for handle cli options, arguments and flags, and more features !
* [Vincent Driessen](http://nvie.com/about/) and his [successful Git branching model](http://nvie.com/posts/a-successful-git-branching-model/)
* [The Semantic Versioning specification](http://semver.org/). A beautiful crafted specification who help me each days at work and on my personal projects.
* [Cookiecutter](https://github.com/audreyr/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](https://github.com/audreyr/cookiecutter-pypackage)
project template.