boymirza-rejavaliyev/nmap-reporter
GitHub: boymirza-rejavaliyev/nmap-reporter
一个纯 Python 3 实现的 Nmap XML 报告转换工具，将扫描结果生成为整洁的 Markdown/HTML 按主机摘要。
Stars: 0 | Forks: 0
# nmap-reporter
Nmap 是一款出色的扫描工具，但它的原始输出阅读起来非常繁杂，直接交给客户或放入测试报告也很不方便。`nmap-reporter` 可以解析 `nmap -oX` 输出，并生成整洁的按主机划分的摘要——包括开放端口、服务、版本，以及一个 **“值得关注的服务”** 提示，用于标记那些值得深入检查的内容（SMB、RDP、数据库、SNMP 等）。
完全使用标准库——**零依赖**，仅需 Python 3。
## 用法
```
# 1. 使用 XML 输出进行扫描
nmap -sC -sV -oX scan.xml
# 2. 构建报告
python3 nmap_report.py scan.xml # Markdown to stdout
python3 nmap_report.py scan.xml -o report.md # Markdown to file
python3 nmap_report.py scan.xml --html -o report.html
```
## 输出示例
```
# Nmap 扫描报告
**Hosts up:** 1 | **Open ports:** 3
## 10.10.10.3 (lame.htb)
| Port | Proto | Service | Version | |
|------|-------|-------------|-------------------|---|
| 22 | tcp | ssh | OpenSSH 4.7p1 | |
| 80 | tcp | http | Apache | |
| 445 | tcp | netbios-ssn | Samba smbd 3.0.20 | ⚠️ |
**Notable services to review:** `netbios-ssn/445`
```
## ⚠️ 法律声明
仅供**授权**的安全测试使用——请仅扫描您拥有或获得明确测试许可的资产。作者对任何滥用行为不承担任何责任。
## 许可证
MIT — 请参阅 [LICENSE](LICENSE)。
标签：Markdown, Nmap, Python, 多模态安全, 插件系统, 无后门, 虚拟驱动器, 防御加固