rustscanr 0.1.0

🦀 rustscanr: A simple async TCP port scanner
rustscanr-0.1.0 is not a library.

rustscanr

Crates.io Docs.rs License: MIT CI Release


rustscanr is a simple async TCP port scanner written in Rust. It is designed to quickly scan port ranges on target hosts, providing fast and efficient network reconnaissance.

Features

  • Blazing fast asynchronous TCP scanning
  • Customizable port ranges and concurrency
  • Configurable connection timeout
  • Easy to use CLI interface

Installation

cargo install rustscanr

Or clone and build manually:

git clone https://github.com/yourusername/rustscanr.git
cd rustscanr
cargo build --release

Usage

rustscanr <HOST>

Arguments

  • <HOST> - Hostname or IP to scan (e.g. example.com or 192.168.1.10)

Options

  • -s, --start <START> - Start port (inclusive) [default: 1]
  • -e, --end <END> - End port (inclusive) [default: 1024]
  • -c, --concurrency <CONCURRENCY> - Concurrency: how many ports to check in parallel [default: 100]
  • -t, --timeout-ms <TIMEOUT_MS> - Timeout per connection attempt in milliseconds [default: 300]
  • -h, --help - Print help

Examples

Scan default port range (1-1024) on a host:

rustscanr example.com

Scan a specific port range with custom concurrency:

rustscanr 192.168.1.10 -s 80 -e 8080 -c 200

Scan with custom timeout:

rustscanr example.com -s 1 -e 65535 -t 500

Contributing

Contributions are welcome! Please open issues or pull requests.

License

This project is licensed under the MIT License.