123 lines
3.7 KiB
Markdown
123 lines
3.7 KiB
Markdown
# Portnut
|
|
|
|
Portnut is a port stressing / scanning multithreaded utility. It can handle raw TCP and HTTP.
|
|
|
|
# TODO
|
|
* Make a distributed version that allows stressing from multiple computers at the same time
|
|
* Return more stats (low 1%, high 1%)
|
|
|
|
# Install
|
|
Go to the releases page and download the latest version.
|
|
Give it execution rights and simply launch it.
|
|
|
|
# Building
|
|
|
|
Prerequisite to building reqwest:
|
|
> apt install libssl-dev
|
|
|
|
# Usage
|
|
|
|
Portnut is a tcp port scanner / stresser.
|
|
|
|
The scanning function simply tries to connect to the tcp ports given.
|
|
The stressing function sends a payload every 10 milliseconds, to every ports given at the same time. The payload can be passed via a pipe (optionnal).
|
|
|
|
## Scan
|
|
```
|
|
2347 justine > portnut tcpscan -a 127.0.0.1 -p 8080,8090
|
|
____ ____ ____ _______ ____ ________
|
|
/ __ \/ __ \/ __ \/_ __/ | / / / / /_ __/
|
|
/ /_/ / / / / /_/ / / / / |/ / / / / / /
|
|
/ ____/ /_/ / _, _/ / / / /| / /_/ / / /
|
|
/_/ \____/_/ |_| /_/ /_/ |_/\____/ /_/
|
|
|
|
Scanning 127.0.0.1
|
|
TCP/8080 => ACCEPT
|
|
TCP/8090 => REJECT
|
|
2351 justine > portnut tcpscan -a 127.0.0.1 -p 8080,8090 --range
|
|
____ ____ ____ _______ ____ ________
|
|
/ __ \/ __ \/ __ \/_ __/ | / / / / /_ __/
|
|
/ /_/ / / / / /_/ / / / / |/ / / / / / /
|
|
/ ____/ /_/ / _, _/ / / / /| / /_/ / / /
|
|
/_/ \____/_/ |_| /_/ /_/ |_/\____/ /_/
|
|
|
|
Scanning 127.0.0.1
|
|
TCP/8080 => ACCEPT
|
|
TCP/8081 => REJECT
|
|
TCP/8082 => REJECT
|
|
TCP/8083 => REJECT
|
|
TCP/8084 => REJECT
|
|
TCP/8085 => REJECT
|
|
TCP/8086 => REJECT
|
|
TCP/8087 => REJECT
|
|
TCP/8088 => REJECT
|
|
TCP/8089 => REJECT
|
|
```
|
|
|
|
## TCP Stress
|
|
TCP Stress can be applied to a port, a list of port, or a range of port.
|
|
Stressing allows sending a payload (via -p/--payload or via a pipe), sending, and waiting for an answer.
|
|
```
|
|
2356 justine > portnut tcpstress -a 127.0.0.1 -p 8080 -d 2
|
|
____ ____ ____ _______ ____ ________
|
|
/ __ \/ __ \/ __ \/_ __/ | / / / / /_ __/
|
|
/ /_/ / / / / /_/ / / / / |/ / / / / / /
|
|
/ ____/ /_/ / _, _/ / / / /| / /_/ / / /
|
|
/_/ \____/_/ |_| /_/ /_/ |_/\____/ /_/
|
|
|
|
Scanning 127.0.0.1
|
|
TCP/8080 => ACCEPT
|
|
|
|
Stressing 127.0.0.1 using 5 concurrent threads per port for 2s
|
|
|
|
TOTAL 20
|
|
OK 20
|
|
NOK 0
|
|
Got 100% of OK
|
|
Mean answer time : 512ms
|
|
```
|
|
|
|
## HTTP Stress
|
|
HTTP stress performs a GET on the given address.
|
|
|
|
```
|
|
1257 justine > portnut httpstress -a http://localhost:8080 --duration 5
|
|
____ ____ ____ _______ ____ ________
|
|
/ __ \/ __ \/ __ \/_ __/ | / / / / /_ __/
|
|
/ /_/ / / / / /_/ / / / / |/ / / / / / /
|
|
/ ____/ /_/ / _, _/ / / / /| / /_/ / / /
|
|
/_/ \____/_/ |_| /_/ /_/ |_/\____/ /_/
|
|
|
|
Threads starting their 5s run...
|
|
over !
|
|
TOTAL 809
|
|
OK 809
|
|
NOK 0
|
|
Got 100% of OK
|
|
Mean answer time : 5ms
|
|
```
|
|
|
|
## More ?
|
|
|
|
See the help :
|
|
```
|
|
A simple TCP/HTTP port scanner / stresser. If stressing, you can pass a payload via a pipe
|
|
|
|
Usage: portnut [OPTIONS] --address <ADDRESS> --ports <PORTS>... <MODE>
|
|
|
|
Arguments:
|
|
<MODE> Mode of use : either tcpstress, tcpscan or httpstress
|
|
|
|
Options:
|
|
-a, --address <ADDRESS> IP address or hostname to scan - or url if using http
|
|
-t, --timeout <TIMEOUT> Timeout for each connection in seconds [default: 1]
|
|
-w, --wait <WAIT> Number of milliseconds to wait in between scans or requests [default: 30]
|
|
-d, --duration <DURATION> Duration of tcp stress test in seconds, default 30 [default: 30]
|
|
-p, --ports <PORTS>... Ports to stress / scan, separated by commas (22,80)
|
|
-r, --range Set this flag to treat the ports as a range rather than a list
|
|
-s, --stress Set this flag to stress the ports instead of scanning them
|
|
-c, --cthreads <CTHREADS> How many threads per port when stressing (Concurrent Threads) [default: 5]
|
|
-h, --help Print help
|
|
-V, --version Print version
|
|
```
|