Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/resyncgg/armada
A high performance TCP SYN port scanner.
https://github.com/resyncgg/armada
port-scanner rust
Last synced: about 1 month ago
JSON representation
A high performance TCP SYN port scanner.
- Host: GitHub
- URL: https://github.com/resyncgg/armada
- Owner: resyncgg
- License: other
- Created: 2021-05-23T10:16:19.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-03-02T10:24:02.000Z (7 months ago)
- Last Synced: 2024-07-05T22:53:17.643Z (2 months ago)
- Topics: port-scanner, rust
- Language: Rust
- Homepage: https://resync.gg
- Size: 57.6 KB
- Stars: 305
- Watchers: 6
- Forks: 25
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-hacking-lists - resyncgg/armada - A high performance TCP SYN port scanner. (Rust)
README
# Armada
*A High-Performance TCP SYN scanner*
## What is Armada?
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.
## How do I install Armada?
If you don't have `rustup` installed, visit the [rustup](https://rustup.rs) 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)
```
## How do I run 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 -p
```
e.g.
```
armada -t 8.8.8.0/24 -p 1-1000
```
### Targets
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