NetProbe — Network Intelligence Scanner

NetProbe is a professional-grade network scanner designed for defensive security and learning. It rapidly scans targets, detects running services, identifies versions, and flags potential security risks based on configuration and outdated software.

Disclaimer: This tool is for educational and defensive purposes only. Do not use against targets you do not have permission to audit. The author is not responsible for any misuse.

Features

• Fast & Modular: Threaded TCP scanning for speed.
• Service Detection: Identifies services (SSH, FTP, HTTP, Databases, etc.) and versions via banner grabbing and heuristics.
• Risk Analysis: Automatically matches detected services against a database of known risky configurations and vulnerable versions (e.g., Telnet, old vsftpd).
• Target Handling: Supports single IPs, domains, and CIDR ranges.
• Reporting: JSON report generation for easy integration.

Installation

NetProbe requires Python 3.8+.

1. Clone the repository:

   git clone https://github.com/vision-dev1/NetProbe.git
   cd NetProbe

2. Set up a Virtual Environment (Recommended):

   python3 -m venv venv
   source venv/bin/activate

3. Install dependencies:

   pip install -r netprobe/requirements.txt

   Note: NetProbe uses standard libraries mostly but having requests is recommended for future modules.

How to Run

Quick Start (Linux/Mac)

Run the helper script from the root directory:

chmod +x run.sh
./run.sh <target>

Example: ./run.sh 127.0.0.1

Standard Usage

You can run NetProbe directly using Python:

Option 1: Direct Script

python3 main.py 192.168.1.1

Option 2: As a Module

python3 -m main 192.168.1.1

Command Examples

# Scan a single IP
python3 main.py 192.168.1.1

# Scan a domain
python3 main.py example.com

# Scan a CIDR range
python3 main.py 192.168.1.0/24

# Scan specific ports
python3 main.py 127.0.0.1 --ports 80,443,8080
python3 main.py 127.0.0.1 --ports 1-1000

Project Structure

• scanner/: Core modules for port scanning and detection.
• utils/: Networking, logging, and configuration helpers.
• data/: risky_services.json database.
• reports/: JSON output of scan results.

---

License

This project is licensed under the MIT License - see the LICENSE file for details.

---

AUTHOR
Vision KC
GitHub
Portfolio

---