Skip to content

bbhunter/RustScan

 
 

Repository files navigation


Find all open ports fast with Rustscan, automatically pipe them into Nmap. Built with Rust.
Crates.io


🔧 Cargo (Universal)

Arch

HomeBrew

Kali / Debian

cargo install rust_scan yay rustscan brew install rustscan dpkg -i rustscan.deb

Note: You must have Nmap installed.


TODO

  • debian package
  • terminal gifs

🤔 What is this?

If you are a competitive CTF player and often find yourself running masscan / a basic nmap scan before running a more comprehensive scan, this tool is for you.

  1. Find ports quickly using Rustscan (27 seconds on average).
  2. Automatically runs nmap -A -sV -p $ports -vvv on those ports.
  3. Profit???

[ GIFS HERE ]

Rustscans only job is to reduce the friction between finding open ports and inputting them into nmap.

✨ Features

  • Scans all 64k ports in 27 seconds (on 1k threads).
  • Saves you time by automatically piping it into Nmap. No more manual copying and pasting!
  • Does one thing and does it well. Only purpose is to improve Nmap, not replace it!

🔭 Why RustScan?

🔬 Without RustScan

  • Gif here comparison

📊 RustScan vs Nmap vs MassScan

Name RustScan Nmap Masscan
Fast
Actually useful
Realises it's not useful, and pipes the only useful data into the only useful port scanner

🙋 FAQ

I think this would be a great port scanner on its own without Nmap!

No. If you want a fast port scanner, use Masscan.

I have this great idea for a script to get information on ports / hosts

Great. Contribute it to Nmap! :D

Not everyone has nmap installed....

If you're a pentester, then yes, you have Nmap installed.

I want to contribute!

Great! I'd love some help with this. Read the contributing.md file file for more information!

📖 Full Installation Guide

You need Nmap. If you have Kali Linux or Parrot OS installed, you already have Nmap. If not, follow the nmap install guide.

The easiest way to install RustScan is to use one of the packages provided for your system, such as HomeBrew or Yay for Arch Linux.

The most universal way is to use cargo, Rust's built in package manager (think Pip but for Rust). Follow this guide to installing Rust & Cargo.

If you face any issues at all, please leave a GitHub issue. I have only tested this on Linux, so there may be issues for Mac OS or Windows.

🎪 Contributing

Please read the contributing.md file

💻 Other Hacking Projects By This Author

🧮 Ciphey

Ciphey is an automated decryption tool using artifical intelligence & natural language processing. Check it out here!

About

Faster Nmap Scanning with Rust

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Rust 97.3%
  • Perl 0.6%
  • Makefile 0.6%
  • Shell 0.5%
  • Python 0.4%
  • Just 0.3%
  • Dockerfile 0.3%