Skip to main content

A comprehensive network port scanner with vulnerability detection

Project description

Simple Network Scanner

A comprehensive network port scanner with vulnerability detection capabilities. This tool provides both standard TCP connect scanning and stealthy SYN scanning options, along with service detection and common security vulnerability checks.

Features

  • Multiple Scanning Methods:
    • Standard TCP port scanning
    • Stealth SYN scanning (requires root/admin privileges)
  • Service Identification:
    • Banner grabbing
    • Service detection based on port numbers
  • Security Assessment:
    • Checks for common vulnerabilities (FTP anonymous access, weak TLS configurations, etc.)
    • Security header analysis for web services
    • SSL/TLS configuration analysis
  • Reporting:
    • Multiple output formats (TXT, JSON, HTML)
    • Detailed HTML reports with interactive elements
    • CSV export for integration with other tools
  • Performance:
    • Multi-threaded scanning for speed
    • Configurable thread count and timeouts

Requirements

  • Python 3.6+
  • Required packages:
    • rich (for enhanced console output)
    • scapy (optional, for stealth SYN scanning)

Installation

Using pip (recommended)

pip install simple-network-scanner

From Source

git clone https://github.com/Zeusfail/Simple-Network-Scanner.git
cd Simple-Network-Scanner
pip install -e .

Windows Note

For stealth scanning on Windows, you need:

  • Administrator privileges
  • Npcap or WinPcap installed (available from npcap.com)

Usage

Basic Usage

# Scan specific ports
netscanner -t 192.168.1.1 -p 80,443,8080

# Scan a range of ports
netscanner -t 192.168.1.1 -p 1-1000

# Scan common ports
netscanner -t 192.168.1.1 --top-ports 100

Advanced Options

# Stealth SYN scan (requires root/admin)
sudo netscanner -t 192.168.1.1 -p 1-1000 --stealth

# Disable banner grabbing for faster scanning
netscanner -t 192.168.1.1 -p 1-1000 --no-banner

# Save results to HTML report
netscanner -t 192.168.1.1 -p 1-1000 --html

Full Command Reference

usage: netscanner [-h] -t IP (-p PORT_RANGE | --top-ports {10,20,50,100,1000})
                 [-T THREADS] [--timeout TIMEOUT] [--no-banner]
                 [--no-vuln-check] [-s] [--txt] [--json] [--html]
                 [-o OUTPUT] [-q] [-v]

Run netscanner -h to see the complete list of options.

Output Examples

The scanner can generate reports in multiple formats:

  • Text: Simple text-based summary
  • JSON: Structured data for programmatic analysis
  • HTML: Interactive report with expandable sections
  • CSV: For import into spreadsheets or databases

License

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

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

simple_network_scanner-1.0.4.tar.gz (40.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

simple_network_scanner-1.0.4-py3-none-any.whl (36.0 kB view details)

Uploaded Python 3

File details

Details for the file simple_network_scanner-1.0.4.tar.gz.

File metadata

  • Download URL: simple_network_scanner-1.0.4.tar.gz
  • Upload date:
  • Size: 40.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.10.0

File hashes

Hashes for simple_network_scanner-1.0.4.tar.gz
Algorithm Hash digest
SHA256 61b03cc6ca6c232b2cdc3b0118c84967966282748d3464de6a8d7991ccea537d
MD5 cc5a78f7f338d877d08a6cc4cbcf746c
BLAKE2b-256 5a507fff149993258d69ce48c567bc3d944b6e3fc839fe1f7a2f8d5f0914fd5a

See more details on using hashes here.

File details

Details for the file simple_network_scanner-1.0.4-py3-none-any.whl.

File metadata

File hashes

Hashes for simple_network_scanner-1.0.4-py3-none-any.whl
Algorithm Hash digest
SHA256 7b86f32d2bead37bf2baf98bba6039e6c16de30882df77c2993567f62b609008
MD5 4126b78026f558103fc18242e080f2a9
BLAKE2b-256 5665ad3fb5fd85759c5c979e0c51957b11f007d6d24cb3889cb6c9d48934d039

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page