# 亥时无人机管理系统开源版
**Repository Path**: optimus-prime-x/haishiWRJ
## Basic Information
- **Project Name**: 亥时无人机管理系统开源版
- **Description**: 亥时无人机管理系统是一套面向大疆机场与无人机的可商用、开源的企业级管理平台，提供设备管理、航线任务、飞行控制、媒体管理、智能巡检等完整能力。系统基于若依框架构建，采用模块化架构设计，支持 AI 识别、实时监控、多机协同等高级特性，适用于光伏巡检、电力巡检、油气管道、智慧园区、公共安全等场景。
别名：无人机低空巡检系统、光伏电厂巡检系统、无人机调度系统、无人机智慧巡检、一网统飞系统。
- **Primary Language**: Unknown
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: https://wrj.haishi.net.cn/
- **GVP Project**: No
## Statistics
- **Stars**: 115
- **Forks**: 26
- **Created**: 2025-08-20
- **Last Updated**: 2026-05-18
## Categories & Tags
**Categories**: auto-driving
**Tags**: None
## README
# 亥时无人机管理系统 (HS-WRJ-SERVER)
# 📅 最后更新：2026-04-15
集成 AI 监测与智能巡检的开源无人机管理系统
【真开源·系统部署可用，如果对你有用，请点亮右上角的Star！】
介绍文档 •
产品版本 •
商用版展示 •
系统展示 •
项目仓库 •
快速开始 •
交流社区
---
## 📖 项目介绍
**亥时无人机管理系统**（HS-WRJ-SERVER）是一套面向大疆机场与无人机的企业级管理平台后端服务，深度集成大疆云 API，提供设备管理、航线任务、飞行控制、媒体管理、智能巡检等完整能力。系统基于若依框架构建，采用模块化架构设计，支持 AI 识别、实时监控、多机协同等高级特性，适用于电力巡检、油气管道、智慧园区、公共安全等场景。
别名：无人机低空巡检系统、光伏电厂巡检系统、无人机调度系统、无人机智慧巡检、一网统飞系统。
### 项目仓库
亥时无人机管理系统采用前后端分离架构，包含以下项目：
| 项目 | 说明 | 仓库地址 |
|------|------|----------|
| **HS-WRJ-SERVER** | 后端服务（本仓库） | 当前仓库 |
| **HAISHI-UAV-1.0-FRONT** | 前端管理端 | [HAISHI-UAV-1.0-FRONT](https://gitee.com/optimus-prime-x/haishiWRJ-WEB) |
**前端项目（HAISHI-UAV-1.0-FRONT）说明**：
- **技术栈**：Vue、Element UI
- **开发工具**：VSCode（推荐）
- **运行环境**：Node.js 20.10.0（推荐使用 nvm 管理版本）
- **依赖管理**：npm / pnpm
- **主要模块**：`auditRecord`（审核）、`command`（基础管理）、`cruise`（航线/机场/设备/任务）、`index`（首页与统计）、`No-flying`（禁飞区）、`system`（系统管理）
完整系统需同时部署后端与前端，前端通过配置的后端 API 地址进行数据交互。
### 系统介绍文档
亥时无人机系统介绍 IMA 文档，支持**查看**与**智能问答**，帮助快速了解系统架构与功能。
### 产品版本
亥时无人机管理系统提供多种版本，满足不同场景需求：
| 版本 | 说明 |
|------|------|
| **开源版** | 本仓库版本，采用 AGPL-3.0 协议，提供核心功能，可自由使用与二次开发 |
| **商用版** | 企业级完整功能，含专属技术支持、定制开发、商业授权等 |
| **光伏版** | 面向光伏电站巡检场景，集成光伏组件识别、热斑检测、缺陷分析等专项能力 |
### 功能对比表
如需了解商用版、光伏版的功能差异、报价及定制服务，**欢迎添加客服咨询** 👇
> 📩 **加我微信了解更多**：功能对比、试用申请、技术方案、商务合作等，请联系亥时科服获取详细资料。
### 商用版功能与界面展示
商用版在开源版基础上提供更丰富的业务能力与交互体验，主要包含以下模块：
| 模块 | 功能说明 |
|------|----------|
| **首页** | 数据总览大屏，实时展示设备在线状态、任务执行情况、告警统计、飞行时长等核心指标，支持多维度数据可视化 |
| **低空服务页** | 低空飞行服务管理，涵盖空域申请、飞行报备、服务调度、作业记录等全流程管理 |
| **航线设计** | 可视化航线规划，支持地图选点、航点编辑、高度设置、拍照动作配置，一键生成 KMZ 并下发任务 |
| **机场控制** | 机场与无人机远程控制，包含开舱关舱、推杆、DRC 遥控、直播推流、媒体下载等操作面板 |
| **AI 预警** | 智能识别与告警中心，实时展示 AI 检测结果、异常事件推送、告警工单处理，支持多类缺陷模型 |
> 💡 以上为商用版界面示意，完整功能与演示请添加客服获取试用或预约演示。
### 核心特性
- 🚁 **大疆云 API 深度集成**：完整对接大疆云平台，支持机场、无人机、负载的 unified 管理
- 📍 **航线任务管理**：支持立即/定时/条件/循环任务，KMZ 航线上传与任务下发
- 🎮 **飞行控制**：机场开舱关舱、推杆、DRC 远程控制等
- 📹 **媒体与直播**：媒体文件管理、SRT 字幕生成、直播推流
- 🤖 **AI 监测**：AI 识别记录、事件处理、智能分析
- 📊 **实时数据**：MQTT + WebSocket 实时 OSD、设备状态推送
- 🔄 **多机协同**：协调业务模块支持多机协同任务与冲突检测
### 技术架构
| 类别 | 技术选型 |
|------|----------|
| 开发工具 | IDEA（需安装 Lombok 插件） |
| 语言 | Java 11 |
| 依赖管理 | Maven ≥ 3.0 |
| 核心框架 | Spring Boot 2.5.14、Spring Security |
| 持久层 | MyBatis Plus、MySQL 8.0+、Redis |
| 地理信息 | PostgreSQL + PostGIS（Docker 镜像 postgis:12-3.5） |
| 对象存储 | MinIO |
| 通信协议 | MQTT、WebSocket、RESTful API |
| 流媒体 | ZLMediaKit（RTMP 推流） |
| 任务调度 | Quartz |
| API 文档 | Swagger 3.0 |
### 模块结构
```
HS-WRJ-SERVER/
├── ruoyi-admin/ # 主应用入口，无人机管理及服务相关功能
│ ├── airport/ # 机场设备控制（机舱控制、飞行控制、负载控制）
│ ├── auditRecord/ # 审核模块（设备、航线、飞手备案审核）
│ ├── device/ # 设备服务（机场、无人机、电池、航线等）
│ ├── handler/ # 设备控制（OBS 服务、设备控制）
│ ├── plan/ # 飞行计划管理
│ ├── task/ # 飞行任务管理
│ └── web/ # 系统设置
├── ruoyi-common/ # Ruoyi 基础服务模块
├── ruoyi-framework/ # Ruoyi 扩展服务模块（安全、Redis、MQTT 等）
├── ruoyi-generator/ # 代码生成器
├── ruoyi-gis/ # GIS 服务模块（禁飞区管理）
├── ruoyi-quartz/ # 定时任务调度
└── ruoyi-system/ # 系统管理（用户、角色、菜单、部门、权限）
```
---
## 🚀 快速开始
### 环境要求
- **IDE**：IDEA（需安装 Lombok 插件）
- **JDK**：Java 11
- **Maven**：≥ 3.0
- **MySQL**：8.0+
- **PostgreSQL**：用于 GIS 禁飞区，需安装 PostGIS 3.5 扩展（Docker 镜像：`postgis:12-3.5`）
- **Redis**：5.0+
- **MinIO**：对象存储
- **MQTT Broker**：推荐 EMQX
- **流媒体**：ZLMediaKit（RTMP 推流）
### 安装步骤
1. **克隆项目**
```bash
git clone https://gitee.com/optimus-prime-x/haishiWRJ
cd haishiWRJ
```
2. **导入项目**
- 使用 IDEA 导入项目
- 若未自动加载 Maven，可右击根目录 `pom.xml`，选择 Maven → Add Project
- 设置项目 JDK 版本为 11（F4 打开项目结构）
3. **初始化数据库**
```bash
# MySQL：创建库并导入主业务数据
mysql -u root -p -e "CREATE DATABASE wrj DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;"
mysql -u root -p wrj < docs/sql/wrj.sql
# PostgreSQL（禁飞区功能）：需安装 PostGIS 3.5
# 导入 docs/sql/gis.sql
```
4. **修改配置**
项目中需修改的配置已使用 `TODO SETTING` 标识，可全局搜索 `TODO SETTING` 按说明修改。主要配置：
- **文件目录**：`ruoyi.profile` 等路径需预先创建，避免启动异常
- 数据库、Redis、MinIO、大疆云、MQTT、媒体服务器等
5. **启动系统**
系统为单体多服务，需分别启动两个主服务：
```bash
# 1. 主服务
mvn clean install
cd ruoyi-admin
mvn spring-boot:run
# 或运行：com.px.RuoYiApplication
# 2. GIS 服务（禁飞区）
cd ruoyi-gis
mvn spring-boot:run
# 或运行：com.px.gis.GisApplication
```
6. **访问系统**
- 后端 API：`http://localhost:6001`（端口以 `application.yml` 为准）
- Swagger 文档：`http://localhost:6001/swagger-ui/index.html`
- **默认账号**：`admin` / **默认密码**：`111111`
若访问返回 401 或 JSON 字符串，表示服务正常。
### 使用说明
- 默认端口为 `6001`，可在 `application.yml` 中修改
- 大疆云相关功能需在 [大疆开放平台](https://developer.dji.com/cn/) 申请应用并配置 `dj.appid`、`dj.appkey`、`dj.applicense`
- 媒体与直播功能需配合 ZLMediaKit 等媒体服务器，详见配置中的 `mediaServer`、`live` 等
### 常见问题
1. **文件权限不足**：项目涉及的文件权限需与启动 jar 的用户一致
2. **服务启动失败**：查看启动日志排查
3. **目录不存在**：`ruoyi.profile` 等配置的目录需预先创建
---
## 🚢 系统部署
推荐使用 [宝塔面板](https://www.bt.cn/) 进行部署管理。
### 依赖服务 Docker 部署
**MinIO（对象存储）**
```bash
docker run -d \
--name minio \
--network uav-network \
-p 9000:9000 -p 9001:9001 \
-v /mnt/minio/data:/data \
-e "MINIO_ROOT_USER=admin" \
-e "MINIO_ROOT_PASSWORD=password123" \
minio/minio server /data --console-address ":9001"
```
**EMQX（MQTT 服务器）**
```bash
docker run -d \
--name emqx \
--network uav-network \
-p 1883:1883 -p 8083:8083 -p 8084:8084 -p 8883:8883 -p 18083:18083 \
emqx/emqx:latest
```
**ZLMediaKit（RTMP 流媒体）**
```bash
docker run -d \
--name zlmediakit \
--network uav-network \
-p 1935:1935 -p 8080:80 -p 554:554 -p 10000:10000/udp \
zlmediakit/zlmediakit:latest
```
### 服务端打包与运行
```bash
# 打包（在 IDEA 中执行 Maven package 或命令行）
mvn clean package -DskipTests
# jar 包位置：ruoyi-admin/target/*.jar
java -jar ruoyi-admin/target/ruoyi-admin.jar
```
### 前端部署
前端项目独立仓库 [HAISHI-UAV-1.0-FRONT](https://gitee.com/optimus-prime-x/haishiWRJ-WEB)，需单独克隆、安装并打包：
```bash
# 克隆前端项目
git clone https://gitee.com/optimus-prime-x/haishiWRJ-WEB.git
cd HAISHI-UAV-1.0-FRONT
# 安装依赖（推荐使用 nvm 管理 Node 版本，Node 20.10.0）
npm install --registry=https://registry.npmmirror.com
# 或使用 pnpm：pnpm install
# 打包
npm run build
```
将 `dist` 目录中的文件上传至 Web 服务器，Nginx 配置反向代理时需将 API 请求转发至后端服务地址。开发环境运行 `npm run dev` 启动前端，需在配置中指定后端 API 地址。
---
## 📄 开源协议
本项目采用 AGPL v3.0开源协议。
- 使用、修改、分发本软件需遵守 AGPL-3.0 条款
- 基于本项目的衍生作品若通过网络提供服务，需开源其完整源代码
---
## 🤝 参与贡献
1. Fork 本仓库
2. 新建功能分支：`git checkout -b feature/xxx`
3. 提交代码：`git commit -m 'feat: 添加 xxx 功能'`
4. 推送分支：`git push origin feature/xxx`
5. 提交 Pull Request
---
## 💬 交流社区
欢迎加入亥时无人机系统交流群，获取技术支持、功能讨论与社区动态。
| 平台 | 说明 |
|------|------|
| **问题反馈** | 使用 [Issues](https://gitee.com/optimus-prime-x/haishiWRJ/issues) 提交 Bug 或建议 |
> 📌 **加入交流群可获得**：部署与配置指导、大疆云 API 对接答疑、功能需求讨论、版本更新通知
> 📌 **商用版/光伏版**：添加客服获取功能对比、试用申请、技术方案与商务合作详情
> 📌 **入群方式**：添加下方联系人获取入群二维码
---
## 📚 相关链接
- [前端项目 HAISHI-UAV-1.0-FRONT](https://gitee.com/optimus-prime-x/haishiWRJ-WEB)（Vue + Element UI 管理端）
- [若依框架文档](https://doc.ruoyi.vip/ruoyi/)（项目基于若依脚手架）
- [大疆开放平台](https://developer.dji.com/cn/)
- [大疆云 API 文档](https://developer.dji.com/doc/cloud-api-tutorial/cn/)
- [宝塔面板](https://www.bt.cn/)（推荐用于部署管理）
---
亥时科技 · 开源无人机管理系统