VulnScanner is a professional-grade network vulnerability assessment tool designed for security professionals, system administrators, and small businesses. This Python-based scanner combines the power of Nmap with CVE database integration to deliver comprehensive security reports.
- Three Scan Modes: Quick (common ports), Regular (custom ports), Deep (full 65k ports)
- CVE Integration: Automatic vulnerability detection using NIST National Vulnerability Database
- Smart Risk Assessment: AI-enhanced risk level calculation (Critical/High/Medium/Low)
- Professional Reporting: Generate detailed PDF reports with identified vulnerabilities
- Cross-Platform: Works on Windows, Linux, and macOS
- Enterprise-Ready: SQLite database for scan history and results tracking
| Component | Technology Used |
|---|---|
| Core Scanning | Python-Nmap |
| Vulnerability DB | NIST NVD API |
| Report Generation | ReportLab |
| CLI Interface | cmd + Colorama |
| Data Storage | SQLite3 |
- Python 3.8+
- Nmap installed on system
- NIST NVD API key (free tier available)
-
Prerequisites:
- Python 3.8+
- Nmap installed on system
- NIST API key (free registration)
-
Installation:
git clone https://github.com/Jaydon54/VulnScanner.git cd VulnScanner pip install -r requirements.txt Troubleshooting: - run nmap --version first - common PATH issue on windows - regular and deep scans need admin/root privlages -
Run:
python vulnscanner.py
- Startup requires Nmap to be installed correctly in PATH
- UI Improvements planned
- Error handling upgrades to come
__ __ _ _____
\ \ / / | | / ____|
\ \ / / _| |_ __ | (___ ___ __ _ _ __ _ __ ___ _ __
\ \/ / | | | | '_ \ \___ \ / __/ _` | '_ \| '_ \ / _ \ '__|
\ /| |_| | | | | |____) | (_| (_| | | | | | | | __/ |
\/ \__,_|_|_| |_|_____/ \___\__,_|_| |_|_| |_|\___|_|
============================================================
| Vulnerability Scanner v2.0 |
| Type help for commands |
| Type exit to quit |
============================================================
[+] Main Menu [+]
------------------------------------------------------------
• Scan Commands:
scan quick - Quick scan on current target
scan regular - Custom port scan on current target
scan deep - Full port scan on current target
scan quick <target> - Quick scan on specific target
scan regular <target> - Custom port scan on specific target
scan deep <target> - Full port scan on specific target
------------------------------------------------------------
• Target Management:
set target <IP> - Set current target
show target - Show current target
------------------------------------------------------------
• Results & Reports:
results - Show last scan results
results date <start> <end> - Filter by date
generate report - Generate PDF report
------------------------------------------------------------
• System Commands:
clear - Clear screen
help - Show detailed help
exit - Exit VulnScanner
-----------------------------------------------------------##📊 Features Deep Dive
- Intelligent Scanning
- CVE Risk Assessment
- Professional Reporting
graph TD
A[CLI Interface] --> B[Scanner Module]
A --> C[Database]
A --> D[CVE Checker]
A --> E[PDF Report]
D -->|NVD API| F[NIST Database]
| Command | Description | Example |
|---|---|---|
scan quick |
Fast scan of common ports | scan quick 192.168.1.1 |
scan regular |
Custom port scan | scan regular (prompts for ports) |
scan deep |
Full port scan | scan deep example.com |
results |
Show last scan results | results |
generate report |
Create PDF report of vulnerabilities | generate report |
- Networks you own
- Systems with explicit permission
- Authorized test environments like scanme.nmap.org
By using this software, you agree to:
- Not use for illegal activities
- Obtain proper authorization
- Respect privacy laws
| Role | Contributor | Focus Area |
|---|---|---|
| 👨💻 Lead Developer | Jaydon Christen | Scanner Core |
| 🗃️ Database Expert | Jefferson Morales | CVE Integration |
| 💻 CLI Architect | Adham Gohar | User Interface |