WeMQ - 物联网调试管理平台

WeMQ 目前已加入 Dromara 社区 孵化项目

📂 1. 项目介绍

1.1 项目简介

WeMQ是一款基于SpringBoot开发的一款物联网设备调试管理平台。

其功能主要是对客户MQTT调试页面进行集中管理（连接信息、发送信息），系统管理员可在后台添加客户和调试页面，并设置调试页面的连接信息、发送消息和对应的发送按钮文字，并设置分享链接以及页面的开启状态，用户可通过分享链接打开配置好对应信息的页面，实现对自己设备的管理调试。

项目截图：

控制台

用户调试界面

调试页面参数

快捷调试页面

自定义调试页面

1.2 技术选型

1. 系统环境

• Java 21
• Apache Maven 3

2. 主框架

• Spring Boot 3.4.x
• Spring Framework 6.x
• Spring MVC 6.x

3. 持久层

• Mybatis Plus 3.5.x
• HikariCP 5.x
• Hibernate Validation 6.x
• Java MySQL Connector 8.3.x

4. 视图层

• Thymeleaf 3.x
• Bootstrap 5.x
• Layui 2.x

5. 工具类

• Apache Commons
• Hutool 5.x

1.3 主要功能

• 调试页面管理
• 调试页面自定义拓展
• MQTT主机管理
• 管理员管理
• 客户分组管理
• 物联网常用工具

1.4 项目结构

org.dromara.wemq
├── mm-common            // 工具类
│       └── annotation                    // 自定义注解
│       └── constant                      // 通用常量
│       └── core                          // 核心控制
│       └── enums                         // 通用枚举
│       └── exception                     // 通用异常
├── mm-framework         // 框架核心
│       └── aspectj                       // 注解实现
│       └── interceptor                   // 拦截器
│       └── manager                       // 异步处理
│       └── web                           // 前端控制
└── mm-web       	 // Web服务
│       └── controller                    // 控制器
│       └── mapper                        // 数据库操作
│       └── model                         // 数据模型
│       └── service                       // 服务接口

⚙️ 2. 部署文档

环境要求

• OpenJDK 17/21+
• MySQL 8.0+
• Maven 3.6+

2.1 如何部署

首先导入项目根目录的 WeMQ.sql 文件到数据库，数据库名为 WeMQ，然后对数据库连接信息进行配置，在mm-web模块的/src/main/resources/application.yml文件中进行数据库连接信息的配置

2.2 如何修改 Nmqs服务地址

本项目依赖于开源通信层项目 Nmqs 来实现对MQTT的转发和连接，如需部署Nmqs，请访问。

在application.yml中修改wemq下的属性即可，根据WeMQ项目地址自动适配http或https、ws或wss

wemq:
  nmqs:
    host: localhost #地址必须外网可以访问，生产环境不能使用127.0.0.1/localhost之类的地址
    port: 8081

2.3 启动项目

启动mm-web中的WeMQApplication，访问http://<你的项目地址>:8080即可

初始账号密码为admin/admin

💡 Issues & Pull Requests

欢迎提交Issues和Pull Requests，开源大门永远向所有人敞开。

✉️ 联系作者

• Email: [email protected]
• QQ: 878639947
• WeChat: NicholasLD505

🔰 License(开源许可证)

Apache License Version 2.0 see http://www.apache.org/licenses/LICENSE-2.0.html

©️ 版权使用说明

WeMQ遵循Apache2.0开源协议，可用于个人学习、毕设、公司项目、商业产品等，但必须保留版权信息。

🪐 知识星球

🎉 特别鸣谢

感谢 JetBrains 为本项目提供的免费开源许可证支持。