Cybersecurity-Projects/PROJECTS/beginner/simple-port-scanner
CarterPerez-dev 0006ddad3d cracked 2026-05-23 05:01:01 -04:00
..
assets chore: add demos for projects, update haskell-reverse-proxy modules, refresh siem assets 2026-04-26 23:12:48 -04:00
learn add and create all learn/ folders for beginner projects 2026-01-31 15:13:31 -05:00
src cracked 2026-05-23 05:01:01 -04:00
.gitignore chore: add demos for projects, update haskell-reverse-proxy modules, refresh siem assets 2026-04-26 23:12:48 -04:00
CMakeLists.txt Phase 1.1: Organize PROJECTS by difficulty level 2026-01-29 02:41:15 -05:00
DEMO.md chore: add demos for projects, update haskell-reverse-proxy modules, refresh siem assets 2026-04-26 23:12:48 -04:00
LICENSE - Standardize READMEs and add justfiles across all 14 projects 2026-02-11 07:01:25 -05:00
README.md Update README with project developer credit 2026-02-20 06:00:09 -05:00
main.cpp cracked 2026-05-23 05:01:01 -04:00

README.md

██████╗  ██████╗ ██████╗ ████████╗    ███████╗ ██████╗ █████╗ ███╗   ██╗███╗   ██╗███████╗██████╗
██╔══██╗██╔═══██╗██╔══██╗╚══██╔══╝    ██╔════╝██╔════╝██╔══██╗████╗  ██║████╗  ██║██╔════╝██╔══██╗
██████╔╝██║   ██║██████╔╝   ██║       ███████╗██║     ███████║██╔██╗ ██║██╔██╗ ██║█████╗  ██████╔╝
██╔═══╝ ██║   ██║██╔══██╗   ██║       ╚════██║██║     ██╔══██║██║╚██╗██║██║╚██╗██║██╔══╝  ██╔══██╗
██║     ╚██████╔╝██║  ██║   ██║       ███████║╚██████╗██║  ██║██║ ╚████║██║ ╚████║███████╗██║  ██║
╚═╝      ╚═════╝ ╚═╝  ╚═╝   ╚═╝       ╚══════╝ ╚═════╝╚═╝  ╚═╝╚═╝  ╚═══╝╚═╝  ╚═══╝╚══════╝╚═╝  ╚═╝

Cybersecurity Projects C++20 License: AGPLv3 CMake

Asynchronous TCP port scanner built with C++ and Boost.Asio for high-concurrency network reconnaissance.

This is a quick overview — security theory, architecture, and full walkthroughs are in the learn modules.

Developed by @deniskhud

What It Does

  • Asynchronous TCP port scanning using Boost.Asio for high concurrency
  • Configurable port ranges from single ports to full 65535 scans
  • Adjustable concurrency level to control scan speed and network load
  • Connection timeout configuration to handle filtered ports gracefully
  • Clean terminal output showing open, closed, and filtered port states

Quick Start

mkdir build && cd build
cmake ..
make
./simplePortScanner --target 192.168.1.1 --ports 1-1024

[!TIP] This project uses just as a command runner. Type just to see all available commands.

Install: curl -sSf https://just.systems/install.sh | bash -s -- --to ~/.local/bin

Building

Requirements: C++20 compiler, Boost library, CMake >= 3.31

./simplePortScanner --target 10.0.0.1 --ports 22,80,443 --concurrency 200
./simplePortScanner --target 172.16.0.5 --ports 1-65535 --timeout 500

Learn

This project includes step-by-step learning materials covering security theory, architecture, and implementation.

Module Topic
00 - Overview Prerequisites and quick start
01 - Concepts Security theory and real-world breaches
02 - Architecture System design and data flow
03 - Implementation Code walkthrough
04 - Challenges Extension ideas and exercises

License

AGPL 3.0