Satyavrat08/sentinel-ai
GitHub: Satyavrat08/sentinel-ai
一款 AI 驱动的 SOC 自动化平台，集成日志采集、威胁检测、AI 调查和自动化响应，帮助安全团队实现实时威胁监控与事件闭环处置。
Stars: 0 | Forks: 0
# SENTINEL AI — 用于 SOC 自动化的自主安全 Agent
企业级 AI 驱动的 SOC 自动化平台，用于日志收集、威胁检测、AI 调查和自动化响应。
## 架构
完整的系统设计请参阅 [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)。
## 项目结构
```
sentinel-ai/
├── backend/ # FastAPI + MongoDB + Redis + OpenAI
├── frontend/ # Next.js 14 + React + Tailwind + ShadCN
├── desktop/ # Electron wrapper
├── docker/ # Container configs
├── scripts/ # Seed data & utilities
└── docs/ # Documentation
```
## 快速开始
### 前置条件
- Docker & Docker Compose
- Node.js 20+
- Python 3.11+
- OpenAI API key（用于 AI 调查）
### 1. 环境设置
```
cp .env.example .env
# 使用你的 secrets 编辑 .env
```
### 2. 使用 Docker 运行
```
docker-compose up -d
```
服务：
| 服务 | URL |
|---------|-----|
| 前端 | http://localhost:3000 |
| 后端 API | http://localhost:8000 |
| API 文档 | http://localhost:8000/docs |
| MongoDB | localhost:27017 |
| Redis | localhost:6379 |
### 3. 开发模式（不使用 Docker）
**后端：**
```
cd backend
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
pip install -r requirements.txt
uvicorn app.main:app --reload --port 8000
```
**前端：**
```
cd frontend
npm install
npm run dev
```
**桌面端：**
```
cd desktop
npm install
npm run icons # Generate app icons (first time)
npm run dev # Requires frontend + backend running
```
生产环境构建和键盘快捷键请参阅 [docs/DESKTOP.md](docs/DESKTOP.md)。
### 4. 填充示例数据
```
# Full reset + 所有 5 个 attack scenarios
python scripts/seed_data.py --reset
# Extended dataset
python scripts/seed_data.py --full
```
### 5. 运行测试
```
cd backend && pip install -r requirements-dev.txt && pytest -v
# 或者：powershell scripts/run_tests.ps1
```
完整的测试指南请参阅 [docs/TESTING.md](docs/TESTING.md)。
### 6. 验证平台（实时技术栈）
默认用户（填充数据后）：
| 邮箱 | 密码 | 角色 |
|-------|----------|------|
| admin@sentinel.ai | Admin@123 | admin |
| analyst@sentinel.ai | Analyst@123 | analyst |
| viewer@sentinel.ai | Viewer@123 | viewer |
## 实施阶段
| 1 | 架构 + 文件夹结构 | ✅ |
| 2 | 后端核心 | ✅ |
| 3 | 检测引擎 + 告警 | ✅ |
| 4 | AI 调查 | ✅ |
| 5 | 前端仪表板 | ✅ |
| 6 | Electron 桌面端 | ✅ |
| 7 | 报告 + 自动化响应 | ✅ |
| 8 | 示例数据 + E2E 测试 | ✅ |
## 许可证
专有 — SENTINEL AI 平台
标签：AMSI绕过, AV绕过, FastAPI, 人工智能, 威胁检测, 安全运营, 安全运营中心, 扫描框架, 搜索引擎查询, 用户模式Hook绕过, 网络映射, 自动化响应, 请求拦截, 逆向工具