Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/xdavidhu/portspider

🕷 A lightning fast multithreaded network scanner framework with modules.
https://github.com/xdavidhu/portspider

multi-threading networking portscan python scanner spider

Last synced: 2 months ago
JSON representation

🕷 A lightning fast multithreaded network scanner framework with modules.

Host: GitHub
URL: https://github.com/xdavidhu/portspider
Owner: xdavidhu
License: mit
Archived: true
Created: 2017-02-19T14:23:47.000Z (over 7 years ago)
Default Branch: master
Last Pushed: 2019-11-03T11:32:47.000Z (almost 5 years ago)
Last Synced: 2024-07-31T13:15:43.805Z (2 months ago)
Topics: multi-threading, networking, portscan, python, scanner, spider
Language: Python
Homepage:
Size: 58.6 KB
Stars: 321
Watchers: 18
Forks: 89
Open Issues: 5
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

██████╗ ██████╗ ██████╗ ████████╗███████╗██████╗ ██╗██████╗ ███████╗██████╗
██╔══██╗██╔═══██╗██╔══██╗╚══██╔══╝██╔════╝██╔══██╗██║██╔══██╗██╔════╝██╔══██╗
██████╔╝██║ ██║██████╔╝ ██║ ███████╗██████╔╝██║██║ ██║█████╗ ██████╔╝
██╔═══╝ ██║ ██║██╔══██╗ ██║ ╚════██║██╔═══╝ ██║██║ ██║██╔══╝ ██╔══██╗
██║ ╚██████╔╝██║ ██║ ██║ ███████║██║ ██║██████╔╝███████╗██║ ██║
╚═╝ ╚═════╝ ╚═╝ ╚═╝ ╚═╝ ╚══════╝╚═╝ ╚═╝╚═════╝ ╚══════╝╚═╝ ╚═╝
v1.0 by David Schütz (@xdavidhu)
[![Build Status](https://travis-ci.org/xdavidhu/portSpider.svg?branch=master)](https://travis-ci.org/xdavidhu/portSpider)
[![Compatibility](https://img.shields.io/badge/python-3.3%2C%203.4%2C%203.5%2C%203.6-brightgreen.svg)](https://github.com/xdavidhu/portSpider)
[![License](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/xdavidhu/portSpider/blob/master/LICENSE)
[![Stars](https://img.shields.io/github/stars/xdavidhu/portSpider.svg)](https://github.com/xdavidhu/portSpider)

### ⚠️ Warning! This project is no longer maintained and may not work as excepted.

A lightning fast multithreaded network scanner framework with modules.

portSpider is a tool for scanning huge network ranges to find open ports and vulnerable services. This tool is not intended to scan one target, rather a whole IP range. (eg. 192.168.0.0/24) Most of the time companies/organizations have public information about their owned public IP ranges, so portSpider will help you to scan all of their machines at once for vulnerable devices/services.

# modules:
* **http** - Scan for open HTTP ports, and get the titles.

* **mysql** - Scan for open MySQL servers, and try to log in with the default credentials.

* **mongodb** - Scan for open MongoDB instances, and check if they are password protected.

* **ssh** - Scan for open SSH ports.

* **printer** - Scan for open printer ports and websites.

* **gameserver** - Scan for open game server ports.

* **manual** - Scan custom ports.

# commands:
* **modules** - List all modules.

* **use** - Use a module.

* **options** - Show a module's options.

* **set** - Set an option.

* **run** - Run the selected module.

* **back** - Go back to menu.

* **exit** - Shut down portSpider.

# installing:

Debian based systems:

```
$ sudo apt-get update && sudo apt-get install python3 python3-pip -y

$ git clone https://github.com/xdavidhu/portSpider

$ cd portSpider/

$ python3 -m pip install -r requirements.txt
```

macOS / OSX:

```
$ brew install python3

$ git clone https://github.com/xdavidhu/portSpider

$ cd portSpider/

$ python3 -m pip install -r requirements.txt
```
**NOTE**: You need to have [Homebrew](http://brew.sh/) installed before running the macOS/OSX installation.

**WARNING**: portSpider is only compatible with Python 3.3 & 3.4 & 3.5 & 3.6

# usage:

Start portSpider with Python3:

```
python3 portSpider.py
```

Select a module: (eg. 'mysql')

```
portSpider $> use mysql
```

View the module's options:

```
portSpider/mysql $> options
```

Set all '[NOT SET]' options: (eg. option 'network' to '192.168.0.0/24')

```
portSpider/mysql $> set network 192.168.0.0/24
```

(You can also modify already set options, but that is not required.)

If you have every option set, run the scan:

```
portSpider/mysql $> run
```

You will see the results on the screen as well as in a text file in the 'logs/' folder.

# developers:
* David Schütz ([@xdavidhu](https://twitter.com/xdavidhu))
* László Simonffy ([@Letsgo00HUN](https://twitter.com/Letsgo00HUN)) - Multithreading

# contribution:

If you have any ideas about new modules and improvements in portSpider, feel free to contribute.

* Check out the `template` module to get a better understanding of the framework.

* Make sure to include a description about your module in the pull request.

* If you create a module, you will be mentioned here in the readme with a link to your social media.

# disclaimer:
I'm not responsible for anything you do with this program, so please only use it for good and educational purposes.

portSpider is under the terms of the [MIT License](https://www.tldrlegal.com/l/mit), following all clarifications stated in the [license file](https://github.com/xdavidhu/portSpider/blob/master/LICENSE). You can also go ahead and email me at xdavid{at}protonmail{dot}com.