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.5.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.5-py3-none-any.whl (36.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: simple_network_scanner-1.0.5.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.5.tar.gz
Algorithm Hash digest
SHA256 2124e8420f2c2e2336a2de58e4ae9e24f10c58a9fd3a91ca2e6041c6762bfd3b
MD5 21f7721a45d211f4ad6223bb9084bb5b
BLAKE2b-256 24acb9113b060c32f31ceb0c65064f1a4fef41636507220e073589a02ff40237

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for simple_network_scanner-1.0.5-py3-none-any.whl
Algorithm Hash digest
SHA256 ad0bc70bee872617c1fc128c6caed75b79834ffa0cf6e2421b85a319c48eb888
MD5 ceb2d6adc5d22e7a64d79fd1313bddb1
BLAKE2b-256 9956e4aaa77d88c32d60947266dd848cb348380cd34659bf4b1ee309eeffad20

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