https://github.com/elddy/NimScan

🚀 Fast Port Scanner 🚀
https://github.com/elddy/NimScan

c cpp fast filtered linux nim pentesting port port-scan port-scanner port-scanning redteam scanner security-tools windows

Last synced: 3 months ago
JSON representation

🚀 Fast Port Scanner 🚀

• Host: GitHub
• URL: https://github.com/elddy/NimScan
• Owner: elddy
• License: mit
• Created: 2020-08-12T14:20:46.000Z (about 4 years ago)
• Default Branch: master
• Last Pushed: 2022-02-10T13:23:02.000Z (over 2 years ago)
• Last Synced: 2024-05-02T18:50:35.623Z (6 months ago)
• Topics: c, cpp, fast, filtered, linux, nim, pentesting, port, port-scan, port-scanner, port-scanning, redteam, scanner, security-tools, windows
• Language: Nim
• Homepage:
• Size: 2.84 MB
• Stars: 357
• Watchers: 3
• Forks: 36
• Open Issues: 8
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-hacking-lists - elddy/NimScan - 🚀 Fast Port Scanner 🚀 (Nim)

README

        
# 👑 NimScan 👑

Really fast port scanner (With filtered option - Windows support only)

![Administrator_ Command Prompt 2021-03-09 18-01-21](https://user-images.githubusercontent.com/69467775/110504297-b1a2fb00-8105-11eb-866e-0c438cc1d1a0.gif)

## Benchmarks

| ⚙️ Category|  👁️ Nmap |  🤖 RustScan      |  ♨️ masscan  |  👑 NimScan          |

|    :---:     |     :---:    |     :---:            |      :---:      |      :---:                  |

| Filtered     | ~107 Seconds  | ❌                  |   ❌           | ~60 Seconds (Windows Only)  |

| non-filtered | ~25 Seconds  | ~3 Seconds (Linux)   | ~8 Seconds (Linux)| ~7 Seconds (2 threads)    |

| Dependencies |  Npcap driver |   Nmap              | libpcap driver  | No dependencies             | 

| Can be used as module/library  |    ❌    |   ❌  |      ❌         | ✔️                         |

All bechmarks were performed inside LAN and on 65K ports. 

## Usage

```shell

Usage:

    NimScan  -p:- [--timeout=] [--files=] [-a]

    NimScan  -p:

    NimScan  -p:,,

    NimScan (-h | --help)

Options:

    -h, --help            Show this screen.

    -p, --ports           Ports to scan. [default: 1-65,535]

    -a, --all             Use rawsockets to find filtered/closed/open ports (Takes longer and limited to 10,000 ports).

    -t, --threads         Number of threads per scan.

    -f, --files=   File descriptors per thread limit.

    -i, --ignore          Ignore ping latency check.

    --timeout=      Timeout to add to the latency [default: 1500].

```

## Examples

Scan range between 1 to 5000 ports

```shell

NimScan 10.0.0.0/24 -p:1-5000 

```

Scan specific ports

```shell

NimScan 10.0.0.1-10.0.0.10 -p:80,443,445

```

Show closed/filtered/open using rawsockets

```shell

NimScan.exe 10.0.0.69 -a

```

## C/C++ Library 🧑🏻‍💻

### Guide

#### Exported functions

```C

scan(char * host, int * ports, int size);

scanner(char * host, int * ports, int size, char * parameters);

```

#### Options

* host        - IP/HOST to scan

* ports       - Ports to scan

* size        - Size of ports array

* parameters  - Parameters to give for the scanner as mentiond above under Usage

#### Create

```C

#include 

int main(void)

{

    NimMain(); // A MUST! 

    int ports[] = {1, 445, 8080, 3389, 135, 139};

    int size = sizeof ports / sizeof ports[0];

    

    scan(, ports, size); // Scan given ports with default configuration (timeout = 1500ms, files = 5000)

    scanner(, NULL, 0, ""); // Scanning all 65K ports with given arguments

    return 0;

}

```

#### Compile

*Make sure NimScanToC.a is in your program's folder.*

```shell

gcc .c -L. -l:NimScanToC.a -w -o NimScan.exe

```