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.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
61b03cc6ca6c232b2cdc3b0118c84967966282748d3464de6a8d7991ccea537d
|
|
| MD5 |
cc5a78f7f338d877d08a6cc4cbcf746c
|
|
| BLAKE2b-256 |
5a507fff149993258d69ce48c567bc3d944b6e3fc839fe1f7a2f8d5f0914fd5a
|
File details
Details for the file simple_network_scanner-1.0.4-py3-none-any.whl.
File metadata
- Download URL: simple_network_scanner-1.0.4-py3-none-any.whl
- Upload date:
- Size: 36.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.10.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7b86f32d2bead37bf2baf98bba6039e6c16de30882df77c2993567f62b609008
|
|
| MD5 |
4126b78026f558103fc18242e080f2a9
|
|
| BLAKE2b-256 |
5665ad3fb5fd85759c5c979e0c51957b11f007d6d24cb3889cb6c9d48934d039
|