A High-Performance TCP SYN scanner
Armada is a high performance TCP SYN scanner. This is equivalent to the type of scanning that nmap might perform when you use the -sS scan type. Armada's main goal is to answer the basic question "Is this port open?". It is then up to you, or your tooling, to dig further to identify what an open port is for.
If you don't have rustup installed, visit the rustup website and follow the instructions there to get started.
IMPORTANT: YOU MUST INSTALL cargo VIA RUSTUP
After you have cargo installed, run cargo install armada.
As Armada uses raw sockets to perform port scanning, you'll either need to be running as root or give the Armada binary the CAP_NET_RAW capability. My suggestion is the latter.
A full installation, after cargo has been installed via rustup, looks like this:
cargo install armada
sudo setcap 'cap_net_raw+ep' $(which armada)
Armada comes with help docs by running armada -h; however, if you want to get started immediately, the typical way to perform a port scan is the following:
armada -t <IP or CIDR> -p <PORT or PORT RANGE>
e.g.
armada -t 8.8.8.0/24 -p 1-1000
Armada supports two different kinds of targets at this time: IP addresses (e.g. 1.2.3.4) and CIDR ranges (e.g. 8.8.8.0/24). These different kinds of targets can be mix and matched.
Additionally, Armada supports three ways of supplying targets:
Via command-line argument
armada -t 1.2.3.4,8.8.8.0/24 -p 1-1000
A newline delimited targets file
armada --target_file some_ips_and_cidrs.txt -p 1-1000
or via stdin
cat ips.txt | armada -p 80,443
It is required to supply targets via one of these methods.
Happy Scanning