Skip to content

Latest commit

Β 

History

History
97 lines (52 loc) Β· 1.93 KB

File metadata and controls

97 lines (52 loc) Β· 1.93 KB

πŸ‘οΈ GhostEyes - Advanced Python Port Scanner

GhostEyes is a powerful, beginner-friendly Python-based port scanner designed for ethical hacking, penetration testing, and network diagnostics. It supports fast threaded scans, banner grabbing, OS detection, and web tech fingerprinting.

πŸ”’ For educational and ethical use only.


πŸš€ Features

  • βœ… Multithreaded TCP Port Scanning
  • βœ… Banner Grabbing (on open ports)
  • βœ… OS Detection (based on TTL fingerprinting)
  • βœ… Web Technology Fingerprinting (Server, X-Powered-By)
  • βœ… Common Service Mapping
  • βœ… Fast with Thread Support
  • βœ… Output Saving to File
  • βœ… User-friendly CLI

πŸ“¦ Installation

git clone https://github.com/6lackRaven/GhostEyes.git
cd GhostEyes
pip install -r requirements.txt


---

## πŸ“Œ Usage

python3 scan.py <target> [options]

## πŸ”§ Example

python3 scan.py scanme.nmap.org --start 1 --end 100 --threads 100 --mode banner --detect --output result.txt


---

## πŸ› οΈ Options

Option	Description

<target>	Target IP or domain
--start	Start port (default: 1)
--end	End port (default: 1024)
--threads	Number of threads (default: 100)
--mode	basic (default) or banner mode
--detect	Enable OS & Web tech fingerprinting
--output	Save results to a file



---

## πŸ” What It Detects

Open TCP ports (1–65535)

Banner info from services (if any)

Server and backend framework (via HTTP headers)

OS fingerprinting from TTL analysis (basic)



---

## πŸ“ Output

If --output result.txt is specified, the open ports and services will be saved to a .txt file.


---

## 🧠 How It Works

Connects to each port via TCP (multi-threaded)

Grabs banners from open ports

Uses TTL to guess operating system (e.g. Linux vs Windows)

Sends HTTP requests to detect backend tech via headers



---

## ⚠️ Disclaimer

This tool is built for learning and ethical testing only. Do not scan networks without permission.