Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mauricelambert/asyncportscanner
Asynchronous port scanner written in Nim.
https://github.com/mauricelambert/asyncportscanner
asynchronous nim port port-scanner scan scanner
Last synced: about 10 hours ago
JSON representation
Asynchronous port scanner written in Nim.
- Host: GitHub
- URL: https://github.com/mauricelambert/asyncportscanner
- Owner: mauricelambert
- License: gpl-3.0
- Created: 2023-04-06T17:26:25.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-11-04T13:26:29.000Z (10 days ago)
- Last Synced: 2024-11-04T14:28:19.465Z (10 days ago)
- Topics: asynchronous, nim, port, port-scanner, scan, scanner
- Language: Nim
- Homepage:
- Size: 45.9 KB
- Stars: 7
- Watchers: 2
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# AsyncPortScanner
## Description
Cross-platform asynchronous port scanner written in Nim.
## Requirements
- No requirements
## Download
- https://github.com/mauricelambert/AsyncPortScanner/releases
## Compilation
### Windows
#### Non static
```bash
nim.exe c --stackTrace:off --lineTrace:off --checks:off --assertions:off -d:release -d:windows AsyncPortScanner.nim
```
#### Static with size optimization
I recommend using this compilation if you don't know the system (and DLL installed on the system) where the scan will be lanched.
```bash
nim.exe c --passl:"-static -static-libgcc -static-libstdc++" --opt:size --stackTrace:off --lineTrace:off --checks:off --assertions:off -d:release -d:windows AsyncPortScanner.nim
```
### Linux
```bash
nim c --stackTrace:off --lineTrace:off --checks:off --assertions:off -d:release -d:linux AsyncPortScanner.nim
```
## Usages
### Default scan
Without any arguments the scan will detect all of your network interfaces and scan all IP on it.
```bash
./scan
```
By default the scan is a TCP scan on all of this ports range:
- 21-25
- 135-139
- 80
- 443-445
- 3000
- 3389
- 5000-5357
- 8000-8888
- 30102
### Custom scan policy
```bash
./scan -w=1000 192.168.56.1-50:tcp:21-25,135-139,80,443-445,3000,5000-5357,8000-8888,30102
```
#### Multiples policies
```bash
./scan -w=3000 192.168.0.1-192.168.56.255 192.168.0.1-192.168.56.255:udp:67-68
```
> Note: the default protocole is `icmp`, it's equivalent of `192.168.0.1-192.168.56.255:icmp`.
This scan performs a `ICMP` scan on the first IP range and `UDP` scan on the second IP range (on port 67 and 68).
> Note: It's better for optimization to use a range of port instead of a list of port ranges (`67-68` instead of `67,68`).
#### Multiples IP range
```bash
./scan -w=100 192.168.0.1/24,192.168.56.1/255.255.255.240:tcp:1-1024
```
### Options
#### Timeout
```bash
./scan -w=100 -t=3 192.168.0.1/24,192.168.56.1/255.255.255.240:tcp:1-1024
```
Set timeout to 3 seconds (instead of 1 second by default).
#### Workers
Workers should alway be set, it's necessary to adapt the value with your computer resources (by default 3000 on Windows, but on a VM Windows i needed set it to 100, by default on Linux is 1000).
```bash
./scan -w=1000 192.168.0.1/24,192.168.56.1/255.255.255.240:tcp:1-1024
```
#### Print
Print all (maximum verbosity):
```bash
./scan -w=100 -a 192.168.0.1/24,192.168.56.1/255.255.255.240:tcp:1-1024
```
Print filtered:
```bash
./scan -w=100 -f 192.168.0.1/24,192.168.56.1/255.255.255.240:tcp:1-1024
```
Print close:
```bash
./scan -w=100 -c 192.168.0.1/24,192.168.56.1/255.255.255.240:tcp:1-1024
```
## Licence
Licensed under the [GPL, version 3](https://www.gnu.org/licenses/).