AI 驱动的自动化漏洞发现 Agent 平台

VulnHunter 是一个开源的 AI 漏洞挖掘工作台，集成了自动化目标分析、AI 辅助漏洞发现、对话式调查、POC/EXP 生成验证、审核工作流和报告交付，支持自部署运行。

📸 界面预览

🎛️ Dashboard 总览

🔍 漏洞发现

🤖 AI Chat 助手

💥 POC/EXP 验证

📊 审计报告

⚡ 为什么选择 VulnHunter？

🎯 功能矩阵

版本对比

🏗️ 系统架构

┌─────────────────────────────────────────────────────┐
│                    浏览器 (React/Vite)                │
└──────────────────────┬──────────────────────────────┘
                       │
┌──────────────────────▼──────────────────────────────┐
│         VulnHunter Service (Hono + WebSocket + MCP)   │
│                                                      │
│  ┌──────────┐  ┌──────────┐  ┌──────────────────┐  │
│  │ Tasks    │  │ Chat     │  │ Reports/POC      │  │
│  │ Findings │  │ AI Agent │  │ Review Workflow   │  │
│  └──────────┘  └──────────┘  └──────────────────┘  │
└───┬────────────────┬────────────────┬───────────────┘
    │                │                │
    ▼                ▼                ▼
┌────────┐   ┌────────────┐   ┌───────────────────┐
│PostgreSQL│  │   MinIO    │   │ Docker Workers    │
│ 任务/漏洞 │  │  文件/报告  │   │ ┌───────────────┐ │
│ 用户/配置 │  │  源码/产物  │   │ │ YoungFlow Scan│ │
└────────┘   └────────────┘   │ │ Chat Worker   │ │
                               │ │ Report Worker │ │
                               │ │ POC/Eval      │ │
                               │ └───────────────┘ │
                               └───────────────────┘

核心组件：

packages/
├── shared/           共享 API 类型
├── service/          核心后端服务
├── web/              React 前端
├── worker-bridge/    Worker 侧桥接通信
└── enterprise/       商业增值功能（BSL 1.1）

🚀 快速开始

环境要求

• x86_64 Linux 主机（推荐 Ubuntu 22.04+）
• Docker Engine + Docker Compose v2
• 从源码构建需 Git、Node.js 20+ 和 pnpm 9+
• 平台运行至少 16GB 内存（构建镜像可能需要更多）

从源码构建并安装（社区版）

VulnHunter 的应用镜像未发布到公共仓库。应先从源码构建包含镜像的离线发布包；仅克隆仓库后直接运行 docker compose up 无法完成安装。

git clone --recurse-submodules https://github.com/Clouditera/VulnHunter.git
cd VulnHunter
pnpm install --frozen-lockfile
./scripts/build-release.sh --edition community
VERSION=$(node -p "require('./package.json').version")
cd "release/vulnhunter-release-${VERSION}-community"
./install.sh
./doctor.sh

访问 http://localhost:23000，首次启动在引导页设置管理员账号即可使用。如果已有包含 images/*.tar 的离线发布包，解压后在发布包目录运行 ./install.sh 和 ./doctor.sh 即可，无需从源码构建。

源码开发

# 安装依赖
pnpm install

# 构建
pnpm build

# 运行测试
pnpm test

# 启动基础设施（数据库 + 对象存储）
docker compose -f deploy/docker-compose.yml --env-file deploy/.env.example up -d db minio

⚙️ 配置说明

参考 deploy/.env.example，常用配置项：

📜 开源协议

本项目采用 Open Core 模式：

• 社区/开源核心 — Apache License 2.0 附加条件（禁止未授权对外托管 SaaS/托管服务；界面须保留 VulnHunter 品牌标识）。
• Enterprise / SaaS — 非 BSL，无自动转开源日期。

🤝 参与贡献

欢迎贡献！当前贡献指南正在完善中，基本流程：

1. 提交 Issue 描述 Bug、功能建议或文档改进
2. Fork 后开发，保持改动聚焦
3. 提交前确保 pnpm build && pnpm test 通过
4. 提交 Pull Request

请勿提交：密钥、私有扫描数据、客户数据、运行时产物。

⚠️ 安全与合法使用声明

VulnHunter 是面向安全研究与授权测试的工具。

仅可对您拥有、或已获得明确授权进行测试的系统、代码库与服务使用本软件。

禁止将本软件用于：

• 未经授权的漏洞扫描、渗透或攻击；
• 挖掘、利用漏洞从事任何违法犯罪活动；
• 对第三方系统造成破坏、窃取数据、勒索或拒绝服务等侵害。

使用本软件即表示您理解并同意：因非法或未授权使用所产生的一切后果由使用者自行承担，与项目维护方无关。