{"id":13845986,"url":"https://github.com/resyncgg/armada","last_synced_at":"2025-07-12T03:33:24.213Z","repository":{"id":38108495,"uuid":"370019864","full_name":"resyncgg/armada","owner":"resyncgg","description":"A high performance TCP SYN port scanner.","archived":false,"fork":false,"pushed_at":"2024-03-02T10:24:02.000Z","size":59,"stargazers_count":310,"open_issues_count":6,"forks_count":25,"subscribers_count":6,"default_branch":"main","last_synced_at":"2024-11-09T06:55:10.121Z","etag":null,"topics":["port-scanner","rust"],"latest_commit_sha":null,"homepage":"https://resync.gg","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/resyncgg.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2021-05-23T10:16:19.000Z","updated_at":"2024-10-24T19:41:34.000Z","dependencies_parsed_at":"2024-02-21T10:58:28.295Z","dependency_job_id":null,"html_url":"https://github.com/resyncgg/armada","commit_stats":{"total_commits":32,"total_committers":3,"mean_commits":"10.666666666666666","dds":0.3125,"last_synced_commit":"2fd4621e6eacb995afd18abb4a3591e1bcd07577"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/resyncgg%2Farmada","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/resyncgg%2Farmada/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/resyncgg%2Farmada/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/resyncgg%2Farmada/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/resyncgg","download_url":"https://codeload.github.com/resyncgg/armada/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225791499,"owners_count":17524799,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["port-scanner","rust"],"created_at":"2024-08-04T17:04:15.149Z","updated_at":"2024-11-21T19:31:00.916Z","avatar_url":"https://github.com/resyncgg.png","language":"Rust","funding_links":[],"categories":["Rust"],"sub_categories":[],"readme":"# Armada\n*A High-Performance TCP SYN scanner*\n\n## What is Armada?\nArmada 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. \n\n## How do I install Armada?\nIf you don't have `rustup` installed, visit the [rustup](https://rustup.rs) website and follow the instructions there to get started.\n\n**IMPORTANT**: *YOU MUST INSTALL `cargo` VIA RUSTUP*\n\nAfter you have `cargo` installed, run `cargo install armada`.\n\nAs 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.\n\nA full installation, after `cargo` has been installed via `rustup`, looks like this:\n\n```\ncargo install armada\n\nsudo setcap 'cap_net_raw+ep' $(which armada)\n```\n\n## How do I run Armada?\nArmada 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:\n\n```\narmada -t \u003cIP or CIDR\u003e -p \u003cPORT or PORT RANGE\u003e\n```\n\ne.g.\n\n```\narmada -t 8.8.8.0/24 -p 1-1000\n```\n\n### Targets\nArmada 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.\n\nAdditionally, Armada supports three ways of supplying targets:\n\nVia command-line argument\n```\narmada -t 1.2.3.4,8.8.8.0/24 -p 1-1000\n```\n\nA newline delimited targets file\n```\narmada --target_file some_ips_and_cidrs.txt -p 1-1000\n```\n\nor via stdin\n```\ncat ips.txt | armada -p 80,443\n```\n\nIt is required to supply targets via one of these methods.\n\nHappy Scanning\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fresyncgg%2Farmada","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fresyncgg%2Farmada","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fresyncgg%2Farmada/lists"}