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
When TCP stress testing, show results for each port.

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

3.8 KiB Raw Blame History