# SentriX IDS

**Repository Path**: hupeinet/c4-sdnids

## Basic Information

- **Project Name**: SentriX IDS
- **Description**: 灵枢IDS，基于SDN网络构建的深度学习流量可视化分析入侵检测系统
- **Primary Language**: Python
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 4
- **Created**: 2025-07-28
- **Last Updated**: 2025-07-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

###  SentriX IDS(灵枢IDS)


## 项目简介

SentriX IDS是一个基于软件定义网络(SDN)的入侵检测系统，提供实时网络安全监控、攻击检测和AI辅助分析功能。

## 系统架构

- **前端**: Vue.js + Element UI + ECharts
- **后端**: Python Flask
- **数据库**: SQLite
- **AI分析**: DeepSeek API

## 环境要求

### 系统要求
- Linux操作系统 (推荐Ubuntu 18.04+)
- Python 3.7+
- Node.js 10.19.0
- npm 6.14.0+

### 依赖软件
- Python 3.7+
- Node.js 10.19.0
- npm 6.14.0+

## 安装步骤

### 1. 安装系统依赖

```bash
# 更新系统包
sudo apt update

# 安装Node.js和npm
sudo apt install -y nodejs npm

# 验证版本
node --version  # 应显示 v10.19.0
npm --version   # 应显示 6.14.0+
```

### 2. 安装Python依赖

```bash
# 进入项目目录
cd c4-sdnids-master

# 安装Python依赖
pip3 install -r requirements.txt
```

### 3. 安装前端依赖

```bash
# 进入前端目录
cd c4-ui

# 安装Node.js依赖
npm install

# 如果遇到sass相关错误，降级sass-loader版本
npm install sass-loader@7.3.1 sass@1.32.13 --save-dev
```

## 启动服务

### 1. 启动后端服务

```bash
# 进入项目根目录
cd c4-sdnids-master

# 启动后端服务
python3 c4-system/main.py
```

后端服务默认运行在 `http://localhost:5000`

### 2. 构建前端项目

```bash
# 进入前端目录
cd c4-ui

# 构建生产版本
npx vue-cli-service build --mode development
```

### 3. 启动前端服务

```bash
# 进入构建目录
cd dist

# 启动Python HTTP服务器
python3 -m http.server 3000 --bind 0.0.0.0
```

前端服务运行在 `http://localhost:3000`

## 访问系统

### 本地访问
- 前端界面: http://localhost:3000
- 后端API: http://localhost:5000

### 远程访问
- 前端界面: http://[服务器IP]:3000
- 后端API: http://[服务器IP]:5000

## 功能模块

### 1. 系统监控
- CPU使用率监控
- 内存使用率监控
- 网络流量监控

### 2. 攻击检测
- 实时攻击检测
- 攻击类型统计
- 攻击记录查看

### 3. 网络拓扑
- SDN网络拓扑图
- 设备状态监控
- 链路状态显示

### 4. AI分析师
- 攻击事件分析
- 防护建议生成
- 威胁情报分享

## 配置说明

### AI配置
1. 在DeepSeek官网注册账号
2. 获取API密钥
3. 在前端AI配置界面输入密钥
4. 测试连接并保存配置

### 系统配置
- 修改 `c4-system/config.py` 调整系统参数
- 修改 `c4-ui/src/config.js` 调整前端配置

## 故障排除

### 常见问题

1. **Node.js版本不兼容**
   - 确保使用Node.js 10.19.0版本
   - 使用nvm管理Node.js版本

2. **sass编译错误**
   - 降级sass-loader到7.3.1版本
   - 降级sass到1.32.13版本

3. **端口被占用**
   - 检查端口占用情况: `netstat -tulpn | grep :3000`
   - 杀死占用进程或更换端口

4. **前端无法访问**
   - 确保服务器绑定到0.0.0.0
   - 检查防火墙设置
   - 验证网络连接

### 日志查看

```bash
# 查看后端日志
tail -f c4-system/logs/app.log

# 查看前端构建日志
npm run build
```

## 开发说明

### 前端开发
```bash
# 启动开发服务器
npm run serve

# 构建生产版本
npm run build
```

### 后端开发
```bash
# 启动开发服务器
python3 c4-system/main.py --debug
```

## 技术栈

- **前端**: Vue.js 2.x, Element UI, ECharts, SCSS
- **后端**: Python Flask, SQLAlchemy, SQLite
- **AI**: DeepSeek API
- **网络**: SDN, OpenFlow

## 许可证

本项目采用MIT许可证，详见LICENSE文件。

## 联系方式
作者:JCUTSEC
联系方式:1948772900@qq.com
作品为初版，暂无任何发行版。