## ⚡ 项目概述 **DeepAudit** 是一个基于 **Multi-Agent 协作架构**的下一代代码安全审计平台。它不仅仅是一个静态扫描工具，而是模拟安全专家的思维模式，通过多个智能体（**Orchestrator**, **Recon**, **Analysis**, **Verification**）的自主协作，实现对代码的深度理解、漏洞挖掘和 **自动化沙箱 PoC 验证**。 我们致力于解决传统 SAST 工具的三大痛点： - **误报率高** — 缺乏语义理解，大量误报消耗人力 - **业务逻辑盲点** — 无法理解跨文件调用和复杂逻辑 - **缺乏验证手段** — 不知道漏洞是否真实可利用 用户只需导入项目，DeepAudit 便全自动开始工作：识别技术栈 → 分析潜在风险 → 生成脚本 → 沙箱验证 → 生成报告，最终输出一份专业审计报告。 ## 💡 为什么选择 DeepAudit？
| 😫 传统审计的痛点 | 💡 DeepAudit 解决方案 | | :--- | :--- | | **人工审计效率低**
跨不上 CI/CD 代码迭代速度，拖慢发布流程 | **🤖 Multi-Agent 自主审计**
AI 自动编排审计策略，全天候自动化执行 | | **传统工具误报多**
缺乏语义理解，每天花费大量时间清洗噪音 | **🧠 RAG 知识库增强**
结合代码语义与上下文，大幅降低误报率 | | **数据隐私担忧**
担心核心源码泄露给云端 AI，无法满足合规要求 | **🔒 支持 Ollama 本地部署**
数据不出内网，支持 Llama3/DeepSeek 等本地模型 | | **无法确认真实性**
外包项目漏洞多，不知道哪些漏洞真实可被利用 | **💥 沙箱 PoC 验证**
自动生成并执行攻击脚本，确认漏洞真实危害 |
--- ## 🏗️ 系统架构 ### 整体架构图 DeepAudit 采用微服务架构，核心由 Multi-Agent 引擎驱动。
DeepAudit 架构图
### 🔄 审计工作流 | 步骤 | 阶段 | 负责 Agent | 主要动作 | |:---:|:---:|:---:|:---| | 1 | **策略规划** | **Orchestrator** | 接收审计任务，分析项目类型，制定审计计划，下发任务给子 Agent | | 2 | **信息收集** | **Recon Agent** | 扫描项目结构，识别框架/库/API，提取攻击面（Entry Points） | | 3 | **漏洞挖掘** | **Analysis Agent** | 结合 RAG 知识库与 AST 分析，深度审查代码，发现潜在漏洞 | | 4 | **PoC 验证** | **Verification Agent** | **(关键)** 编写 PoC 脚本，在 Docker 沙箱中执行。如失败则自我修正重试 | | 5 | **报告生成** | **Orchestrator** | 汇总所有发现，剔除被验证为误报的漏洞，生成最终报告 | ### 📂 项目代码结构 ```text DeepAudit/ ├── backend/ # Python FastAPI 后端 │ ├── app/ │ │ ├── agents/ # Multi-Agent 核心逻辑 │ │ │ ├── orchestrator.py # 总指挥：任务编排 │ │ │ ├── recon.py # 侦察兵：资产识别 │ │ │ ├── analysis.py # 分析师：漏洞挖掘 │ │ │ └── verification.py # 验证者：沙箱 PoC │ │ ├── core/ # 核心配置与沙箱接口 │ │ ├── models/ # 数据库模型 │ │ └── services/ # RAG, LLM 服务封装 │ └── tests/ # 单元测试 ├── frontend/ # React + TypeScript 前端 │ ├── src/ │ │ ├── components/ # UI 组件库 │ │ ├── pages/ # 页面路由 │ │ └── stores/ # Zustand 状态管理 ├── docker/ # Docker 部署配置 │ ├── sandbox/ # 安全沙箱镜像构建 │ └── postgres/ # 数据库初始化 └── docs/ # 详细文档 ``` --- ## 🚀 快速开始 ### 方式一：克隆代码部署 适合需要自定义配置或二次开发的用户： ```bash # 1. 克隆项目 git clone https://github.com/lintsinghua/DeepAudit.git && cd DeepAudit # 2. 配置环境变量 cp backend/env.example backend/.env # 编辑 backend/.env 填入你的 LLM API Key # 3. 一键启动 docker compose up -d ``` > 首次启动会自动构建沙箱镜像，可能需要几分钟。 --- ## 🔧 源码开发指南 适合开发者进行二次开发调试。 ### 环境要求 - Python 3.11+ - Node.js 20+ - PostgreSQL 15+ - Docker (用于沙箱) ### 1. 手动启动数据库 ```bash docker compose up -d redis db ``` ### 2. 后端启动 ```bash cd backend # 配置环境 cp env.example .env # 使用 uv 管理环境（推荐） uv sync source .venv/bin/activate # 启动 API 服务 uvicorn app.main:app --reload ``` ### 3. 前端启动 ```bash cd frontend # 配置环境 cp .env.example .env pnpm install pnpm dev ``` ### 3. 沙箱环境 开发模式下需要本地 Docker 拉取沙箱镜像： ```bash # 标准拉取 docker pull ghcr.io/lintsinghua/deepaudit-sandbox:latest # 国内加速（南京大学镜像站） docker pull ghcr.nju.edu.cn/lintsinghua/deepaudit-sandbox:latest ``` --- ## 🤖 Multi-Agent 智能审计 ### 支持的漏洞类型
| 漏洞类型 | 描述 | |---------|------| | `sql_injection` | SQL 注入 | | `xss` | 跨站脚本攻击 | | `command_injection` | 命令注入 | | `path_traversal` | 路径遍历 | | `ssrf` | 服务端请求伪造 | | `xxe` | XML 外部实体注入 | | 漏洞类型 | 描述 | |---------|------| | `insecure_deserialization` | 不安全反序列化 | | `hardcoded_secret` | 硬编码密钥 | | `weak_crypto` | 弱加密算法 | | `authentication_bypass` | 认证绕过 | | `authorization_bypass` | 授权绕过 | | `idor` | 不安全直接对象引用 |
> 📖 详细文档请查看 **[Agent 审计指南](docs/AGENT_AUDIT.md)** --- ## 🔌 支持的 LLM 平台

🌍 国际平台

OpenAI GPT-4o / GPT-4
Claude 3.5 Sonnet / Opus
Google Gemini Pro
DeepSeek V3

🇨🇳 国内平台

通义千问 Qwen
智谱 GLM-4
Moonshot Kimi
文心一言 · MiniMax · 豆包

🏠 本地部署

Ollama
Llama3 · Qwen2.5 · CodeLlama
DeepSeek-Coder · Codestral
代码不出内网

--- ## 🎯 功能矩阵 | 功能 | 说明 | 模式 | |------|------|------| | 🤖 **Agent 深度审计** | Multi-Agent 协作，自主编排审计策略 | Agent | | 🧠 **RAG 知识增强** | 代码语义理解，CWE/CVE 知识库检索 | Agent | | 🔒 **沙箱 PoC 验证** | Docker 隔离执行，验证漏洞有效性 | Agent | | 🗂️ **项目管理** | GitHub/GitLab/Gitea 导入，ZIP 上传，10+ 语言支持 | 通用 | | ⚡ **即时分析** | 代码片段秒级分析，粘贴即用 | 通用 | | 🔍 **五维检测** | Bug · 安全 · 性能 · 风格 · 可维护性 | 通用 | | 💡 **What-Why-How** | 精准定位 + 原因解释 + 修复建议 | 通用 | | 📋 **审计规则** | 内置 OWASP Top 10，支持自定义规则集 | 通用 | | 📝 **提示词模板** | 可视化管理，支持中英文双语 | 通用 | | 📊 **报告导出** | PDF / Markdown / JSON 一键导出 | 通用 | ---