BugTraceAI/BugTraceAI

Open-source, self-hosted web pentesting suite with agentic scanning, analyst tools, API testing, model checkpoints and MCP integrations.

BugTraceAI – AI 增强、自托管的 Web 渗透测试套件

它是什么 – 一个开源的四组件集合，可让您在自有硬件上运行自主 Web 和 API 安全评估。该套件将大语言模型（LLM）推理（通过可配置的提供商，如 OpenRouter、Anthropic、Z.ai、Bedrock、Ollama）与确定性安全工具相结合。AI 代理规划、优先排序并解释发现；工具执行检查并生成证据，UI（CLI TUI 或 Web 仪表板）将其显示为结构化报告。

核心组件

组件	角色	典型部署
BugTraceAI‑CLI	基于终端的代理扫描器；暴露 REST/MCP API；将扫描元数据存储在 SQLite 中。	本地 Python 3.10+ 或 Docker 容器。
BugTraceAI‑WEB	浏览器 UI，包含 20 多种 AI 驱动的安全工具、实时扫描监控、聊天以及用于 LLM 基准测试的 ModelLab。	Docker（PostgreSQL 后端）或本地安装。
BugTraceAI‑API	独立服务，执行契约感知的 API 发现和证据优先测试。	Docker 或本地 Python 服务，暴露 REST/MCP。
BugTraceAI‑Launcher	引导式安装程序，可配置上述任意组合，设置端口，创建全局 `btai` 命令，并运行可选的 AI 助手向导。	一行脚本（`curl …
reconftw‑mcp	可扩展的“模型上下文协议”插件框架；附带 Kali Linux 和 ReconFTW 代理，扫描器可调用。
BugStore	故意易受攻击的演示应用（32 个 OWASP 漏洞），用于教程和示例报告。
BugTraceAI Models	发布的检查点系列（CORE‑Fast、CORE‑Pro、CORE‑Ultra、Apex），针对漏洞赏金和渗透测试工作流调优；托管在 HuggingFace 上。

工作原理（高层架构）

CLI TUI  →  扫描引擎  ←→  专业工具和浏览器验证
               │
               └─►  SQLite（元数据）和磁盘报告
WEB UI  →  REST API（由 CLI 暴露）  →  扫描引擎
API 服务  →  REST/MCP  →  扫描引擎
Launcher  →  编排服务、端口和可选的全局命令

引擎运行六阶段流水线（侦察 → 发现 → 策略 → 利用 → 验证 → 报告）。
AI 代理决定在每个阶段调用哪些专业工具，并将证据综合为人类可读的发现。
所有数据保留在本地；您提供 LLM 提供商密钥，保持工作流隐私优先。

快速开始（一键安装）

curl -fsSL https://raw.githubusercontent.com/BugTraceAI/BugTraceAI-Launcher/main/install.sh | bash

安装程序显示一个 TUI 菜单，您可以在其中选择配置文件（terminal、web、full 等）。
选择配置文件后，它会引导您完成提供商 API 密钥输入、端口选择以及可选的 AI 向导设置。
完成后，您会得到一个 btai 命令（如果您选择了全局选项），该命令可以启动 CLI TUI、启动 WEB 仪表板或运行 API 服务。

典型用例

漏洞赏金猎人 – 对目标运行自主扫描，让 AI 优先处理高价值发现，并接收可提交的报告。
DevSecOps – 从 CI/CD 管道调用 CLI REST 或 MCP 端点，自动测试新部署的 Web 服务；摄取 JSON 证据以创建工单。
安全团队 – 使用 WEB 仪表板监控长时间运行的评估、重放证据，并在 ModelLab 中比较 LLM 性能。
培训与教育 – 在内置的 BugStore 易受攻击应用上练习，并探索演示报告以学习工作流程。

发布版本（截至 README）

组件	最新版本	显著特性
CLI	4.0.35‑beta	TUI、Web 扫描 API/MCP、提供商向导、全局 `btai` 命令
WEB	2.0.37‑beta	仪表板、聊天、ModelLab、实时扫描视图
API	1.4.11‑beta	独立 API 目标引擎、REST + MCP
Launcher	3.3.35	通用安装程序、配置文件向导、AI 助手设置

许可证与社区

许可证： Apache-2.0（所有核心仓库）。模型检查点有自己的 HuggingFace 许可证，列在每个模型卡上。
社区： Discord 服务器、YouTube 演示（DEF CON 34）、RootedCON 2026、HKOSCon 2026 和 DEF CON 34 的演讲。问题跟踪器位于每个组件仓库中；Launcher 是新用户的推荐入口。

总结

BugTraceAI 是一个真正的、模块化的、自托管的渗透测试平台，利用 LLM 代理来编排经典安全工具。它提供终端优先的工作流、Web UI 和可编程 API，全部采用 Apache-2.0 许可证，使其成为研究人员和需要完全控制数据的团队的 AI 增强安全工具的坚实示例。