Nuclei 到 PDF 报告生成器

一个专业级的自动化工具，旨在弥合技术漏洞扫描与高管报告之间的差距。由 Adi Mahluf (Tenroot Cyber Security) 开发。

---

🚀 概述

该项目提供了一个无缝的“一键命令”工作流，用于审计 Web 资产。它利用高性能的 Nuclei 引擎来识别漏洞和错误配置，然后自动将原始结果编译成格式化的、可直接交付客户的 PDF 报告。它专为安全架构师和事件响应团队量身定制，他们需要向利益相关者提供清晰、可操作的数据。

---

🛠️ 先决条件

为确保工具在不同环境中正确运行，必须在您的工作站上安装以下组件。

1. Nuclei 引擎 (v3.x+)

核心扫描引擎。确保使用 3.0 或更高版本以支持现代模板和标志。

go install -v [github.com/projectdiscovery/nuclei/v3/cmd/nuclei@latest](https://github.com/projectdiscovery/nuclei/v3/cmd/nuclei@latest)

2. Python 3 与虚拟环境

报告脚本需要 Python 3.10+ 和 fpdf2 库，以支持现代 PDF 功能和 Unicode。 设置说明：

# 如果缺失，安装 venv 工具 (Ubuntu/WSL)
sudo apt update && sudo apt install python3-venv python3-full -y
# 创建并配置环境
python3 -m venv venv
./venv/bin/pip install fpdf2

3. 实用工具

用于处理脚本权限和跨平台编码。

sudo apt install dos2unix -y

📥 安装

1. 克隆仓库：

git clone [https://github.com/YourUsername/Nuclei-PDF-Generator.git](https://github.com/YourUsername/Nuclei-PDF-Generator.git)
cd Nuclei-PDF-Generator

2. 修复编码与权限：确保脚本具有执行权限并使用 Unix 换行符。

chmod +x scan.sh
dos2unix scan.sh generate_report.py

3. 添加您的品牌标识：将您的公司徽标放在项目根文件夹中，并准确命名为 logo.png。

##📑 使用 通过提供目标域来运行审计脚本。脚本默认使用隐身模式（限速），以避免被 Web 应用防火墙（WAF）拦截。

./scan.sh <domain_name> [--aggressive]

• 示例（隐身）：./scan.sh tenroot.io
• 示例（激进）：./scan.sh internal-site.local --aggressive

该工具将生成一个名为 Report_domain.com_YYYYMMDD-HHMM.pdf 的文件。

📋 报告功能

• 执行风险摘要：从严重到信息级别的高级别发现计数。
• 详细发现：每个识别的漏洞或技术的技术描述，包括受影响的 URL。
• 修复建议：直接从 Nuclei 模板提取的可操作的、逐步缓解步骤。

📷 图片

⚠️ 故障排除

错误	根本原因	解决方案
FPDFException	光标到达右边界。	使用 Python 脚本的 1.4+ 版本。
UnicodeEncodeError	结果中的特殊字符。	使用脚本中的 clean_text() 函数
ModuleNotFoundError	缺少 Python 库	确保 venv 处于激活状态，或使用 ./venv/bin/python3。
Permission denied	脚本未标记为可执行	在终端中运行 chmod +x scan.sh。
WAF Blocking	IP 因请求速率被列入黑名单	使用默认扫描模式，不加 --aggressive 标志。

---

免责声明：本工具仅用于授权安全测试。开发者不对因使用本应用程序而产生的误用或损害承担任何责任。