VulnHawk - A modular and beginner-friendly Python vulnerabili

项目说明

- Python-Based Scanner

Welcome to — a powerful and educational open-source scanner built in Python.

This repository includes two of the scanner:

1. Basic Scanner – Great for learning port scanning fundamentals.
2. Ad Scanner – A comprehensi assessment tool that integrates Nmap, C, PDF reporting, and risk scoring.

---

🔍 Table of Contents

* Project O
* Basic Scanner

* Description
* Usage
* Requirements
* Ad Scanner

* Description
* Features
* Setup & Requirements
* Usage
* Folder Structure
* Contributing
* Feedback
* License
* Author
* Happy Scanning

---

Project O

is built for learners, ethical hackers, and cybersecurity enthusiasts. It starts with the fundamentals and scales to a semi-professional tool that demonstrates:

* Port scanning
* Service fingerprinting
* detection (C)
* Report generation

---

Basic Scanner

Description

A simple port scanner using Python’s built-in socket module. It scans a gi of ports and prints all open ports on the target.

Ideal for beginners who want to:

* Understand TCP handshakes
* Learn how port scanners work from scratch

Usage

* Enter the target IP/domain.
* Provide the port range (start & end).
* See the list of open ports.

Requirements

* Python 3.x (tested with Python 3.6+)
* No external libraries needed

---

Ad Scanner

Ad Description

The ad elevates the scanner by using:

* nmap for detailed port & service scanning
* Public C for detection
* fpdf for professional report generation

This tool suits intermediate to ad users and demonstrates real-world scanning practices.

Features

* 🛠 Service & detection via Nmap
* 🧠 Automatic C ( API)
* 📝 Generates PDF reports with:

* Scan summary
* Detected services &
* OS info, uptime, and traceroute
* C risk scoring with color-coded se
* 📊 Output in both terminal and PDF format

Setup & Requirements

Install the dependencies:

Install Nmap:

* Linux (Ubuntu/Debian):

* Windows:
Download from

Ensure the fonts/ folder exists in ad/ directory:

* Contains required fonts for PDF: Deja.ttf, Deja.ttf, Deja.ttf

Ad Usage

* Enter target IP/domain
* Optional: Generate a PDF report

Scan results and CVEs are displayed in the terminal and saved to a PDF report.

---

Folder Structure

---

Contributing

All contributions are welcome! You can:

* Report bugs or open issues
* Suggest new features
* Submit pull requests

Make sure your code is tested and well-documented before submitting.

---

Feedback

---

License

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

---

Author

Built and maintained by Tanuj Kumar. — Creator and Maintainer
GitHub | LinkedIn

If you find this project useful, please ⭐ the repository and share it with others.

---

Happy Scanning

Just a de who lo and fixing stuff.
— *Tanuj Kumar* 💻🔐

项目信息

开发语言：Python

Star 数：9

技术要点

该项目属于安全软件方向的开源资源，代码结构清晰，适合安全研究人员学习参考。项目围绕A modular and beginner-friendly Python vulnerability scanner with port scanning, real-time CVE detection, CVSS-based risk scoring, and auto-generated PDF reports.展开，提供了可运行的实现，对理解相关安全机制、工具原理与攻防技术具有较高的研究价值。

从技术实现角度看，此类项目的核心在于对底层原理的深入理解与工程化落地。开发者在研究过程中可以结合官方文档与社区讨论，梳理项目的初始化流程、核心模块职责与数据流转，逐步掌握其中的技术细节与设计思路。

使用与学习建议

1. 下载源码压缩包，解压到本地环境。

2. 根据项目类型准备对应的运行环境与依赖。

3. 按照 README 中的步骤完成配置与部署。

4. 在隔离的测试环境中运行验证，避免影响生产系统。

免责声明

本资源来源于开源社区，仅供安全研究、技术学习与合法授权范围内的攻防演练使用，请勿用于任何非法或侵害他人权益的用途。使用本项目产生的一切后果由使用者自行承担。