cloudeye-video-sur-git

云眼视频监控平台

企业级开源视频监控与流媒体管理平台
多协议接入 · 国标级联 · 云端录像 · 地图可视化 · 一键 Docker 部署

开源社区

---

这个项目是做什么的？

云眼视频监控平台（原泉视 NVR 视频监控系统）是一套面向企业、园区、门店、车队、政府项目的视频监控一体化解决方案。你可以把它理解为一个「自建版萤石/海康平台」：

• 把摄像头、NVR、车载终端、国标平台等统一接入到一个 Web 后台；
• 在浏览器里完成实时预览、录像回放、告警处理、地图定位；
• 通过 ZLMediaKit 做流媒体转发，通过 GB28181 / JT808·1078 对接行业平台与车载设备；
• 基于 RuoYi-Cloud 微服务 架构，支持扩展用户权限、日志审计、定时任务等企业管理能力。

适合谁用？

场景	能做什么
中小企业园区	多路监控、分屏查看、录像计划、云端存储
集成商 / 二次开发	开源可改、多协议适配、国标上下级级联
运维团队	设备在线状态、媒体节点、告警列表、服务监控
学习研究	Spring Cloud + 流媒体 + 国标协议完整示例

---

核心能力一览

• 实时监看：1 / 4 / 6 / 9 / 16 / 25 分屏，布局保存，云台控制，语音对讲（视协议而定）
• 设备接入：RTSP、RTMP、FLV、HLS、ONVIF、GB28181、JT808/JT1078、海康 SDK、海康 ISUP、大华 SDK、推流等
• 录像能力：设备录像 / 云端录像检索、回放、下载；录像计划按周时段配置
• 国标级联：向上级平台注册、目录推送、远程点播 / 回放 / 云台
• 地图应用：电子地图落点、设备树联动（天地图）
• 告警中心：移动侦测等告警记录、批量处理、导出
• 系统管理：用户 / 角色 / 菜单 / 部门、操作日志、Redis / 服务监控（RuoYi 体系）

---

技术架构（简要）

层级	技术
前端	Vue 3 + Element Plus + Vite
后端	Spring Boot 3、Spring Cloud & Alibaba
注册 / 配置	Nacos
缓存 / 会话	Redis
数据库	MySQL 5.7
流媒体	ZLMediaKit
播放器	EasyPlayer
部署	Docker Compose 一键拉起（推荐）

---

快速开始（推荐：Docker 一键部署）

环境要求

• Windows 10/11 或 Linux
• Docker Desktop（已启动）
• 首次完整构建需：JDK 17、Maven 3.6+（用于编译后端 JAR）
• 前端在 Docker 构建阶段自动 npm build，本机无需安装 Node

启动步骤

# 1. 进入 Docker 目录
cd ruoyi-qs-nvr-master\docker

# 2. 一键：Maven 编译 → 复制 JAR/SQL → 启动全部容器（含前端 Nginx）
.\start.ps1

# 日常仅重启（跳过编译）
.\start.ps1 -SkipBuild -NoImageBuild

也可双击同目录下的 start.bat。

访问地址

服务	地址
Web 管理端（主入口）	http://localhost
API 网关	http://localhost:8080
Nacos 控制台	http://localhost:8848/nacos

默认账号

• 用户名：admin
• 密码：admin123

首次启动 MySQL 初始化约 2～5 分钟，请等待 Nacos、网关变为健康后再登录。若验证码失败，可执行 docker compose restart ruoyi-redis ruoyi-gateway。

常用参数

参数	说明
-SkipBuild	跳过 Maven，使用已有 JAR
-NoImageBuild	不重建镜像，仅重启容器
-ResetDb	清空 mysql/data 后重新初始化库
-WithVendorSdk	额外启动海康 / 大华 SDK 容器（需自备厂商原生库，见下文）

海康 / 大华 SDK 说明

默认 不启动 海康、大华 SDK 微服务（镜像内无厂商 .so / .dll）。Windows 本机若已放置 SDK 到 ruoyi-modules/*/lib，可使用：

.\start.ps1 -WithVendorSdk

---

本地开发（前后端分离）

后端

cd ruoyi-qs-nvr-master
mvn clean package -DskipTests
# 按 RuoYi 文档分别启动 Nacos、Redis、MySQL 及各 ruoyi-* 模块

前端

cd ruoyi-qs-nvr-ui-master
npm install
npm run dev

浏览器访问开发地址（一般为 http://localhost:80 或终端提示端口），接口代理指向网关 /dev-api。

环境变量（前端）

在 ruoyi-qs-nvr-ui-master/.env.development 中可配置：

• VITE_APP_TITLE：系统名称（默认「云眼视频监控平台」）
• VITE_APP_LOGO：Logo 图片 URL

---

目录结构

视频监控系统/
├── README.md                 # 本说明
├── images/                   # 界面截图（文档用）
├── ruoyi-qs-nvr-ui-master/    # 前端 Vue 工程
└── ruoyi-qs-nvr-master/      # 后端微服务 + docker 一键部署
    ├── ruoyi-gateway/        # 网关 [8080]
    ├── ruoyi-auth/           # 认证中心
    ├── ruoyi-modules/        # 业务模块（设备、国标、ZLM、车载等）
    └── docker/               # Docker Compose、start.ps1

后端模块主要包括：ruoyi-qs（核心业务）、ruoyi-zlm（流媒体）、ruoyi-gb28181、ruoyi-jt1078、ruoyi-onvif、ruoyi-haikang、ruoyi-dahua 等，详见 ruoyi-qs-nvr-master 内 pom.xml。

---

协议支持

流媒体协议

协议	说明
RTSP / RTMP / HTTP-FLV / HLS / WebSocket-FLV	通用拉流 / 播放

设备与行业标准

类型	说明
ONVIF	发现、云台、事件
GB28181	国标设备接入、上下级级联
JT808 / JT1078	部标车载终端与视频
海康 SDK / ISUP、大华 SDK	厂商私有协议（需 SDK 文件）

---

界面预览

以下为 云眼视频监控平台 实际运行界面（深色侧栏 + 青绿主题）。

分屏监控

多路实时预览，支持 1～25 分屏、设备树、布局保存。

设备管理

卡片式展示设备在线状态，支持国标、RTMP 等多协议，一键播放与配置。

录像回放

按设备、日期检索录像，支持设备录像与云端录像，时间轴播放控制。

云端录像

检索 ZLM 云端 MP4 片段，在线播放、下载、批量删除。

电子地图

天地图底图，设备落点与资源树联动，支持卫星视图。

录像计划

按周时段配置 7×24 录像计划，关联设备批量生效。

国标 GB28181 级联

上级平台注册、目录推送、通道关联与级联状态管理。

媒体节点

管理 ZLMediaKit 流媒体节点，负载与推拉流能力集中配置。

设备报警

告警列表、级别、处理状态，支持海康等 SDK 告警接入。

设备抓图

手动 / 定时抓图记录，预览与导出。

组织结构（行政区划）

按行政区域、业务分组管理设备，树形资源组 + 列表。

---

典型使用流程

flowchart LR
  A[部署 start.ps1] --> B[登录 admin]
  B --> C[媒体节点配置 ZLM]
  C --> D[设备管理添加摄像头]
  D --> E[分屏监控预览]
  D --> F[录像计划 / 云端录像]
  D --> G[国标级联可选]
  E --> H[告警 / 地图 / 回放]

1. 部署：Docker 一键启动全部服务。
   
2. 配置流媒体：在「媒体节点」添加 ZLMediaKit 地址（安装包需自行部署 ZLM，或使用已有节点）。
   
3. 接入设备：在「设备管理」按协议添加 RTSP / 国标 / 车载等。
   
4. 日常监看：「分屏监控」选设备播放；「电子地图」查看位置。
   
5. 录像与合规：配置「录像计划」、在「云端录像 / 录像回放」检索历史。
   
6. 级联上级：在「国标级联」配置上级平台参数（项目需要时）。

---

常见问题

问题	处理建议
验证码无法显示	docker compose restart ruoyi-redis ruoyi-gateway
Nacos 启动失败	检查 docker/.env 中 NACOS_AUTH_TOKEN 是否配置
网关日志连 127.0.0.1:8848	使用最新 docker-compose 与 start.ps1 重建网关
海康 / 大华容器反复重启	默认未启用；需 -WithVendorSdk 且自备 SDK 库文件
界面仍显示旧名称 / 蓝色主题	浏览器执行 localStorage.removeItem('layout-setting'); location.reload()
重新初始化数据库	.\start.ps1 -ResetDb（会清空业务数据）

---

开源与社区

• 顶部导航 「开源社区」 跳转：https://www.gitcc.com
• 后端基于 RuoYi-Cloud 微服务框架扩展
• 本项目开源免费用于学习与企业内部部署；生产环境请自行评估安全、备份与网络隔离

---

许可证

请遵循各子项目及依赖组件的开源协议（RuoYi、ZLMediaKit、厂商 SDK 等）。厂商 SDK 版权归海康、大华等公司所有，部署时需遵守其授权条款。

---

云眼视频监控平台 · 让多源视频接入更简单