Skip to content

README.md

Latest commit

 

History

History
67 lines (46 loc) · 1.58 KB

README.md

File metadata and controls

67 lines (46 loc) · 1.58 KB
Raw

Rust Port Scanner

A simple, fast, and concurrent port scanner written in Rust using Tokio for asynchronous networking.

Features

  • Scan individual IP addresses or CIDR ranges
  • Concurrent scanning for maximum performance
  • Customizable port ranges
  • Clear terminal output with color formatting

Installation

# Clone the repository
git clone https://github.com/NabilKara/Simple_Rust_port_scanner.git
cd rust-port-scanner

# Build the project
cargo build --release

Dependencies

This project depends on:

  • clap - Command-line argument parsing
  • tokio - Asynchronous runtime
  • colored - Terminal text coloring
  • cidr - CIDR notation handling

Usage

# Scan a single IP address
./port-scanner 192.168.1.1 --port-start 1 --port-end 1000

# Scan a CIDR range
./port-scanner --cidr 192.168.1.0/24 --port-start 80 --port-end 443

Command-line Options

  • addr: Target IP address (required unless --cidr is specified)
  • --cidr: Target network in CIDR notation (conflicts with addr)
  • --port-start: Starting port number (default: 1)
  • --port-end: Ending port number (default: 1024)

Examples

Scan common ports on a single host:

./port-scanner 192.168.1.1 --port-start 20 --port-end 100

Scan a specific port across a network:

./port-scanner --cidr 10.0.0.0/24 --port-start 80 --port-end 81

How It Works

The scanner works by spawning a Tokio task for each port and target combination. Each task attempts to establish a TCP connection to the target port. If the connection succeeds, the port is marked as open.

License

MIT