🛡️ 泉视视频监控系统 (ruoyi-qs-nvr)
泉视互联 · 视界无界 | 基于 RuoYi-Cloud Alibaba 的全协议视频融合中台
作者：蜡笔小新 | 协议：MIT
基于 RuoYi-Cloud 开发的企业级 NVR 系统，支持 RTSP、RTMP、ONVIF、海康 SDK/ISUP、大华 SDK 等主流协议接入。旨在提供一个高可用、易扩展的视频物联网接入平台。
▶️ 项目启动
哔哩哔哩地址：ruoyi-qs-nvr
🎨 代码地址
- ruoyi-qs-nvr 后端代码
- ruoyi-qs-nvr-ui 前端代码
⚙️ 技术栈与环境
| 类别 | 技术选型 | 描述 |
|---|---|---|
| 后端架构 | JDK 17 + Maven | 稳定高效的开发环境 |
| 微服务治理 | Spring Boot 3 + Spring Cloud Alibaba | Nacos 3.x 注册与配置中心 |
| 流媒体核心 | ZLMediaKit | 高性能流媒体服务器 |
| 前端框架 | Vue3 + TypeScript + Vite | 现代化前端工程化 |
| 数据存储 | MySQL 5.7 + Redis 7.0 | 结构化数据与缓存双引擎 |
🚀 快速启动指南
1. 环境准备
请确保本地已安装以下环境：
- JDK 17+
- Maven 3.6+
- MySQL 5.7+
- Redis 7.0+
- Nacos 3.x (服务注册与配置中心)
- Node.js (用于前端运行)
- ZLMediaKit (用于视频播放)
2. 数据库初始化
本项目需要初始化 3 个 核心数据库：
- ry-cloud: 导入
sql目录下的ry-cloud.sql(系统基础数据)。 - ry-config: 导入
sql目录下的ry_config.sql(Nacos 持久化配置)。 - ry-seata: (可选) 如需启用分布式事务，导入
ry_seata_2021xxxx.sql。
3. Nacos 配置 (关键步骤)
进入 Nacos 安装目录的 conf 文件夹，修改 application.properties，开启 MySQL 持久化支持：
properties
# db mysql
spring.datasource.platform=mysql
db.num=1
db.url.0=jdbc:mysql://localhost:3306/ry-config?characterEncoding=utf8&connectTimeout=1000&socketTimeout=3000&autoReconnect=true&useUnicode=true&useSSL=false&serverTimezone=UTC
db.user=root
db.password=password4. 服务启动顺序
以下服务mysql和redis都要去nacos配置链接信息
- RuoYiGatewayApplication （网关模块 必须）
- RuoYiAuthApplication （认证模块 必须）
- RuoYiSystemApplication （系统模块 必须）
- RuoYiMonitorApplication （监控中心 可选）
- RuoYiGenApplication （代码生成 可选）
- RuoYiJobApplication （定时任务 可选）
- RuoYiFileApplication （文件服务 可选）
- RuoYiDaHuaApplication （大华sdk服务 可选）（自行去nacos >> application-dahua-dev.yml 配置）
- RuoYiHaiKangIsupApplication （海康isup服务 可选） （自行去nacos >> application-haikang-isup-dev.yml 配置）
- RuoYiHaiKangApplication （海康sdk服务 可选）（自行去nacos >> application-haikang-dev.yml 配置）
- RuoYiOnvifApplication （onvif服务 可选）
- RuoYiQSApplication （泉视服务 必须）
- RuoYiZlmApplication （zlm服务 必须）这个模块需要配置， zlm模块配置
5.启动前端
properties
# 克隆项目
git clone https://gitee.com/tangwenzhaoaini/ruoyi-qs-nvr-ui
# 进入项目目录
cd ruoyi-qs-nvr-ui
# 安装依赖
yarn --registry=https://registry.npmmirror.com
# 启动服务
yarn dev
# 构建测试环境 yarn build:stage
# 构建生产环境 yarn build:prod
# 前端访问地址 http://localhost:80重要提示
运行前需要先启动nacos，运行成功可以通过(http://ip:8848 (opens new window)) 访问，但是不会出现静态页面，可以继续参考下面步骤部署ruoyi-qs-nvr-ui前端，然后通过前端地址来访问。
配置文件application.properties是在下载的nacos-server包conf目录下。 默认配置单机模式，nacos集群/多集群部署模式参考 ( Nacos支持三种部署模式 (opens new window))
📦 核心模块架构
本项目采用标准的微服务分层架构，实现业务彻底解耦。
text
ruoyi-qs-nvr
├── 🌐 ruoyi-gateway # 统一网关 (8080)
├── 🔐 ruoyi-auth # 认证中心 (9200)
├── 🏭 ruoyi-modules # 业务模块
│ ├── 🛠️ ruoyi-system # 系统管理 (9201)
│ ├── 📹 ruoyi-qs # 泉视核心 (9205)
│ ├── 📡 ruoyi-zlm # ZLM 服务 (8090)
│ ├── 🚓 ruoyi-haikang # 海康 SDK (9204)
│ ├── 🏢 ruoyi-dahua # 大华 SDK (9207)
│ └── 🌍 ruoyi-onvif # ONVIF 服务 (9208)
├── 🧩 ruoyi-common # 通用组件 (Redis/Seata/Log)
├── 🖼️ ruoyi-visual # 监控中心 (9100)
└── 📝 pom.xml # 依赖管理