# BXC_VideoAnalyzer_v3

**Repository Path**: cloudgoon/BXC_VideoAnalyzer_v3

## Basic Information

- **Project Name**: BXC_VideoAnalyzer_v3
- **Description**: （开源）C++视频行为分析系统v3系列版本
- **Primary Language**: C++
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 74
- **Created**: 2026-03-27
- **Last Updated**: 2026-03-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

### 视频行为分析系统 v3 （BXC_VideoAnalyzer_v3）
* 作者：北小菜 
* 邮箱：bilibili_bxc@126.com
* QQ：1402990689
* 微信：bilibili_bxc
* 哔哩哔哩主页：https://space.bilibili.com/487906612
* v1版本gitee开源地址 https://gitee.com/Vanishi/BXC_VideoAnalyzer_v1
* v2版本gitee开源地址 https://gitee.com/Vanishi/BXC_VideoAnalyzer_v2
* v3版本gitee开源地址：https://gitee.com/Vanishi/BXC_VideoAnalyzer_v3
* v3版本github开源地址：https://github.com/beixiaocai/BXC_VideoAnalyzer_v3
* v5版本安装包下载地址 https://gitee.com/Vanishi/rebekah

**开源地址：**


## ⚠️ 重要提示：首次使用必读！

由于开源平台限制，项目中的大文件已单独打包上传到网盘。**首次使用前，请务必先下载并解压网盘文件，否则系统无法正常运行！**

### 📦 网盘下载（必须先下载）

本项目的编译依赖、模型文件、测试数据等大文件已打包为 `files.zip`，请从以下网盘下载：

#### 百度网盘
- **下载链接**：https://pan.baidu.com/s/1NQcao0Mw3ZC5lXXLdm468w?pwd=xcxc
- **提取码**：`xcxc`

#### 夸克网盘
- **下载链接**：https://pan.quark.cn/s/18251f724618
- **提取码**：`Xw7c`

### 📋 files.zip 包含内容

下载 `files.zip` 后，解压会得到以下目录结构：

```
files/
├── Analyzer/              # Analyzer模块的编译输出和第三方库
│   ├── x64/              # 编译后的二进制文件（Debug + Release）
│   │   ├── Debug/       # Debug版本（含.pdb调试文件）
│   │   └── Release/     # Release版本（可直接运行）
│   └── 3rdparty/         # 第三方库源码和依赖
│       ├── opencv/        # OpenCV库文件
│       ├── openvino/       # OpenVINO推理引擎
│       └── ffmpeg/         # FFmpeg视频编解码库
│
├── Analyzer-lib/           # 第三方依赖库压缩包
│   ├── opencv-4.7.zip              # OpenCV 4.7库（267MB）
│   ├── w_openvino_toolkit_windows_2024.4.0.16579.c3152d32c9c_x86_64.zip  # Windows版OpenVINO（104MB）
│   ├── onnxruntime-win-x64-1.17.3.zip  # ONNX Runtime（59MB）
│   ├── l_openvino_toolkit_ubuntu20_2024.4.0.16579.c3152d32c9c_x86_64.tgz  # Linux x86版OpenVINO（49MB）
│   ├── l_openvino_toolkit_ubuntu20_2024.4.0.16579.c3152d32c9c_arm64.tgz  # Linux ARM版OpenVINO（34MB）
│   ├── llama.cpp-minicpm-omni.zip  # 大语言模型支持（20MB）
│   ├── FFmpeg-release-6.0.zip        # FFmpeg库（19MB）
│   └── curl-7.83.0.zip             # HTTP客户端库（6MB）
│
├── data/                 # 测试数据和工具
│   ├── 720p_diedao.mp4      # 道道入侵测试视频（388MB）
│   ├── 720p_fire.mp4        # 火灾检测测试视频（163MB）
│   ├── 720p_fight.mp4       # 打斗检测测试视频（34MB）
│   ├── 720p_smoke.mp4       # 烟雾检测测试视频（31MB）
│   ├── 1080p_safehat.mp4    # 安全帽检测测试视频（14MB）
│   ├── ffmpeg.exe            # FFmpeg推流工具（84MB）
│   └── ffplay.exe            # FFmpeg播放工具（83MB）
│
└── Admin/                 # Admin模块的Python虚拟环境
    └── venv/              # Python虚拟环境（含所有依赖包）
```

### 📝 下载和解压步骤（小白必看）

#### 第一步：下载files.zip
1. 选择任意一个网盘链接下载 `files.zip`
   - 百度网盘：点击链接 → 输入提取码 `xcxc` → 下载
   - 夸克网盘：点击链接 → 输入提取码 `Xw7c` → 下载

2. 下载完成后，你会得到一个名为 `files.zip` 的压缩包（约3.3GB）

#### 第二步：解压files.zip
1. 将 `files.zip` 解压到项目根目录（即 `BXC_VideoAnalyzer_v3/` 文件夹）
2. **重要**：解压时会提示是否覆盖文件，**请选择"全部是"或"全部覆盖"**
3. 解压完成后，项目目录结构应该是这样的：

```
BXC_VideoAnalyzer_v3/
├── Admin/              # 后台管理模块
│   ├── venv/          # ← 解压后会有这个目录
│   └── ...
├── Analyzer/           # 视频分析模块
│   ├── x64/           # ← 解压后会有这个目录
│   ├── 3rdparty/      # ← 解压后会有这个目录
│   └── ...
├── Analyzer-lib/       # ← 解压后会有这个目录
├── MediaServer/        # 流媒体服务模块
├── data/              # 测试数据
│   ├── *.mp4          # ← 解压后会有这些视频
│   └── *.exe          # ← 解压后会有这些工具
├── .bak/              # 备份文件夹
├── .gitignore         # Git忽略配置
├── config.json        # 系统配置文件
└── README.md          # 本文件
```

#### 第三步：验证文件完整性
解压完成后，请检查以下关键文件是否存在：

✅ **Analyzer模块必需文件**：
- `Analyzer/x64/Release/Analyzer.exe` - 分析器主程序
- `Analyzer/x64/Release/avcodec-60.dll` - FFmpeg编解码库
- `Analyzer/x64/Release/opencv_world470.dll` - OpenCV库
- `Analyzer/x64/Release/openvino_intel_cpu_plugin.dll` - OpenVINO推理插件

✅ **Admin模块必需文件**：
- `Admin/venv/` - Python虚拟环境目录

✅ **MediaServer模块必需文件**：
- `MediaServer/bin/MediaServer.exe` - 流媒体服务器程序

✅ **测试数据文件**：
- `data/720p_diedao.mp4` - 道道入侵测试视频
- `data/ffmpeg.exe` - FFmpeg推流工具

### ⚠️ 常见问题

**Q1：解压后提示文件已存在，是否覆盖？**
- **A**：选择"全部是"或"全部覆盖"
- **原因**：需要用网盘的文件覆盖项目中的空目录

**Q2：下载速度慢怎么办？**
- **A**：建议使用夸克网盘，下载速度更快
- **B**：如果使用百度网盘，建议安装百度网盘客户端下载

**Q3：files.zip损坏怎么办？**
- **A**：重新下载文件，验证MD5值
- **B**：尝试使用另一个网盘下载

**Q4：解压后目录结构不对？**
- **A**：确保解压到了正确的位置（项目根目录）
- **B**：检查解压软件是否正确处理了子目录

### 🎯 下载完成后的下一步

完成以上步骤后，你就可以正常使用系统了：

1. ✅ **配置系统**：编辑 `config.json` 文件，设置正确的路径
2. ✅ **启动服务**：按照README中的启动步骤启动各模块
3. ✅ **访问系统**：打开浏览器访问 http://127.0.0.1:9991

---

## 项目简介

BXC VideoAnalyzer v3 是一个基于深度学习的智能视频行为分析系统，支持实时视频流分析、目标检测、行为识别等功能。

## 系统架构

```
BXC_VideoAnalyzer_v3/
├── Admin/           # 后台管理模块（Django）
├── Analyzer/        # 视频分析模块（C++）
├── MediaServer/     # 流媒体服务模块（ZLMediaKit）
└── Analyzer-lib/    # 第三方依赖库
```

## 核心模块

### 1. Admin - 后台管理系统（Python + Django）

**主要功能：** 视频流管理、算法管理、布控管理、报警管理、系统配置

**技术栈：** Python 3.8+、Django 4.2、SQLite

**默认配置：** 端口9991、管理员admin/admin888

### 2. Analyzer - 视频分析模块（C++）

**主要功能：** 视频流拉取推流、实时目标检测、行为分析、报警检测上报

**技术栈：** C++、OpenCV 4.7、ONNX Runtime、OpenVINO、FFmpeg 6.0

**默认配置：** 端口9993、模型目录models/

### 3. MediaServer - 流媒体服务（ZLMediaKit）

**主要功能：** 流媒体推流/拉流、协议转换、流媒体录制、WebRTC通信

**支持协议：** RTSP、RTMP、HLS、HTTP-FLV、WebRTC、SRT

**默认配置：** HTTP端口9992、RTSP端口9994

### 4. Analyzer-lib - 第三方依赖库

**包含：** FFmpeg 6.0、OpenCV 4.7、OpenVINO、curl、jsoncpp、llama.cpp

**用途：** 为Analyzer模块提供编译依赖，支持Windows和Linux平台

## 系统工作流程

1. **视频源接入** → Admin添加视频流 → MediaServer接收转发
2. **分析任务创建** → Admin创建布控 → 选择视频流和算法
3. **实时分析** → Analyzer拉流 → 模型检测 → 触发报警
4. **报警处理** → Analyzer上报 → Admin保存记录 → 上传外部服务器
5. **实时预览** → Web查看视频流 → 显示分析结果 → 多协议播放

## 配置文件

### config.json（根目录）
```json
{
  "code": "node-353",              // 集群节点编号（每个节点应不同）
  "name": "系统名称",
  "describe": "系统描述",
  "host": "127.0.0.1",             // 局域网部署请修改为实际IP
  "adminPort": 9991,
  "analyzerPort": 9993,
  "mediaHttpPort": 9992,
  "mediaRtspPort": 9994,
  "mediaSecret": "流媒体密钥",
  "uploadDir": "Admin/static/upload",  // Windows用反斜杠，Linux用正斜杠
  "modelDir": "Analyzer/models",       // Windows用反斜杠，Linux用正斜杠
  "saveAlarmType": 1,              // 1:保存本地 2:上传服务器 3:两者都做
  "saveAlarmUrl": "http://127.0.0.1:9824/alarm/openAdd"  // 报警上传URL
}
```

### MediaServer配置（config.ini）
- API配置、FFmpeg配置、协议配置、Hook配置、集群配置

## 快速体验

### Windows版
1. **下载程序**：点击"克隆/下载" → 下载ZIP
2. **解压运行**：解压ZIP → 双击 `VideoAnalyzer.exe` 启动
3. **访问系统**：浏览器打开 http://127.0.0.1:9991
4. **默认账号**：用户名 `admin`，密码 `admin888`
5. **停止程序**：关闭启动窗口即可

### Linux版
需要获取源码后自行编译运行

### 端口说明
系统运行需要以下端口：9991、9992、9993、9994、9995

## 环境要求

### Windows
- Python 3.8+、Visual Studio 2019、Windows 10/11

### Linux
- Python 3.8+、GCC 9+、CMake 3.15+

## 安装部署

### 1. 安装Python依赖
```bash
cd Admin
python -m venv venv
venv\Scripts\activate  # Windows
source venv/bin/activate  # Linux
pip install -r requirements-windows.txt  # Windows
pip install -r requirements-linux.txt  # Linux
```

### 2. 配置系统
编辑根目录下的`config.json`文件，设置正确的路径和端口。

### 3. 启动服务（按顺序）
```bash
# 1. 启动MediaServer
cd MediaServer/bin
MediaServer.exe

# 2. 启动Analyzer
cd Analyzer/x64/Release
Analyzer.exe -f config.json

# 3. 启动Admin
cd Admin
python manage.py runserver 0.0.0.0:9991
```

### 4. 访问系统
打开浏览器访问：http://127.0.0.1:9991

## 版本历史

### v3系列
- **v3.53** (2026.01.15) - 当前版本，支持OpenVINO推理Yolo26模型
- **v3.52** (2025.09.24) - [视频教程](https://www.bilibili.com/video/BV1AQxGz4ELr)
- **v3.51** (2025.07.01) - 新增打架/火焰/烟雾/安全帽检测算法
- **v3.48** (2025.03.26) - [接入Qwen2.5 VL、MiniCPM-o 2.6等多模态大模型](https://www.bilibili.com/video/BV1SFZKYnEEq)
- **v3.47** (2025.03.04) - [支持arm/x86-Linux/Windows编译，支持rk3588/昇腾/树莓派等](https://www.bilibili.com/video/BV1Ed9RYaEha)
- **v3.46** (2025.02.05) - [新增llama.cpp推理MiniCPM视觉大模型](https://www.bilibili.com/video/BV1Y7NneSEim)
- **v3.45** (2024.12.25) - [C++版TensorRT/OpenVINO/OnnxRuntime推理yolo](https://www.bilibili.com/video/BV1wfCBYFEVD)
- **v3.44** (2024.11.25) - [C++版RKNPU推理yolo加速，支持rk3588/rk3576](https://www.bilibili.com/video/BV1n9zuYKEt5)
- **v3.43** (2024.10.02) - [新增人员管理/人脸检测/人脸识别/无感考勤](https://www.bilibili.com/video/BV14a2NYJE6i)
- **v3.42** (2024.07.30) - [CNN+LSTM视频分类算法](https://www.bilibili.com/video/BV1rf421v74R)
- **v3.41** (2024.05.20) - [C++版OnnxRuntime推理yolo，支持多硬件](https://www.bilibili.com/video/BV1hJ4m1w7tP)
- **v3.40** (2024.05.09) - [新增人脸检测/yolo9/yolo8/400种动作检测](https://www.bilibili.com/video/BV1tH4y1G775)
- **v3.3** (2024.04.02) - [优化播放器/摄像头对接/算法/存储](https://www.bilibili.com/video/BV1pK421h74U)
- **v3.2** (2023.12.31) - [兼容Linux系统，优化性能](https://www.bilibili.com/video/BV12g4y167u2)
- **v3.1** (2023.12.11) - [新增英伟达显卡推理，TensorRT支持](https://www.bilibili.com/video/BV1F64y1L7dq)
- **v3.0** (2023.10.23) - [算法升级至yolov8，C++版openvino](https://www.bilibili.com/video/BV1Xy4y1P7M2)

### v2系列
- **v2** - [兼容Linux，优化推流功能](https://www.bilibili.com/video/BV1CG411f7ak)

### v1系列
- **v1** - [实时分析视频流，产生报警视频，实时推流](https://www.bilibili.com/video/BV1dG4y1k77o)
- **v1源码讲解** - [第1讲](https://www.bilibili.com/video/BV1L84y177xc)、[第2讲](https://www.bilibili.com/video/BV1984y1L7zB)

## 技术支持

- **官网**：https://www.yuturuishi.com
- **邮箱**：bilibili_bxc@126.com
- **QQ**：1402990689
- **微信**：bilibili_bxc
- **B站主页**：https://space.bilibili.com/487906612
- **视频教程**：https://www.bilibili.com/video/BV1AQxGz4ELr

## 许可证

请参考各子模块的LICENSE文件。

## 注意事项

1. 首次使用前请务必修改`config.json`中的路径配置
2. 确保所有依赖库正确安装
3. 端口冲突时请修改配置文件中的端口号
4. 生产环境部署时请修改默认管理员密码
5. 建议使用SSD硬盘以提高视频处理性能