EMQX + 自研后台 最简落地架构清单

EMQX + 自研后台 最简落地架构清单
适配无人机、机器人、工业 IoT 设备,轻量易运维、二次开发灵活

一、整体架构拓扑
设备终端 ↔ IoT 隧道 / 公网 ↔ EMQX 消息服务 ↔ 自研业务后台 ↔ 数据库
EMQX:专职设备接入、MQTT 消息转发、连接鉴权
自研后台:设备管理、指令下发、数据解析、可视化、权限告警
解耦设计,消息层与业务层互不干扰

二、组件选型极简配置
表格
组件 选型推荐 硬件最低配置 核心作用
MQTT 服务 EMQX开源稳定版 2 核 2G 40G 盘 百万级连接、消息路由、主题管控
数据库 MySQL 8.0 同服务器独立库 设备档案、账号、日志、业务数据
缓存 Redis 单机版 共用资源 在线状态、临时会话、高频数据
自研后台 SpringBoot/Vue 分离部署更佳 业务逻辑、面板界面、接口服务
通信协议 MQTT 5.0 标准端口1883/8883 设备上下行数据、控制指令

三、核心分层职责
1. EMQX 层(只做通信,不写业务)
设备连接鉴权,拦截非法接入
主题权限 ACL 管控,隔离设备数据
消息收发、离线消息缓存、消息桥接
通过 WebHook/HTTP API 把数据推送自研后台
接收后台指令,下发至对应终端
2. 自研后台层(全权处理业务)
设备注册、命名管理、在线状态统计
解析传感器数据、位置信息、故障报文
手动 / 自动下发导航、启停、调速控制指令
图表看板、轨迹回放、异常告警提醒
用户账号、操作日志、数据存储统计
3. 传输链路搭配
无公网 IP 设备:IoT 隧道 → 接入 EMQX
固定静态 IP 设备:直连 EMQX 服务端口
加密通信:正式环境启用 8883 TLS 加密端口

四、关键交互流程
设备上电,携带设备 ID + 秘钥登录 EMQX
登录成功,EMQX 推送设备上线事件至自研后台
设备定时上报定位、工况数据,EMQX 转发后台入库展示
后台编辑控制指令,调用 EMQX 接口推送指定设备
设备执行指令后返回结果,闭环交互
设备离线,后台同步更新状态并可触发告警

五、基础主题规范(直接复用)
设备上报:device/${deviceId}/upload
后台下发指令:device/${deviceId}/cmd
设备心跳保活:device/${deviceId}/heart

六、部署最简步骤
安装 EMQX,开启 WebHook、配置鉴权规则
创建 MySQL 库表,录入设备基础信息
部署 Redis,缓存连接状态
开发后台对接 EMQX HTTP API,实现数据收发
调试设备端 MQTT 连接、消息收发逻辑
搭建管理页面,完成状态查看、指令操控

七、优势与适配场景
优势:性能强、运维简单、自主可控、定制无限制
规避 ThingsBoard 臃肿、小众技术栈问题
适配:批量无人设备、远程运维、隧道组网项目

八、必备接口清单
设备上下线状态回调接口
消息接收解析接口
后台下发指令推送接口
设备列表、状态查询接口
账号权限校验接口