# Thinglinks-community开源物联网平台 **Repository Path**: andy-ai/thinglinks-community ## Basic Information - **Project Name**: Thinglinks-community开源物联网平台 - **Description**: 一个功能完备、高可扩展的开源物联网平台,用最少的代码接入设备,集成TCP、MQTT、UDP、CoAP、HTTP、WebSocket、MODBUS等多种网络组件,提供完整的设备接入、管理和数据处理解决方案。具备强大的消息解析、数据转发、规则编排和实时告警能力,帮助企业快速构建物联网应用。 - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 18 - **Created**: 2026-01-05 - **Last Updated**: 2026-01-05 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README

物联网平台 - Thinglinks-iot

License Gitee Stars Java Spring Boot

## 🌟 项目简介 一个功能完备、高可扩展的物联网平台,用最少的代码接入设备,集成TCP、MQTT、UDP、CoAP、HTTP、WebSocket、MODBUS等多种网络组件,提供完整的设备接入、管理和数据处理解决方案。具备强大的消息解析、数据转发、规则编排和实时告警能力,帮助企业快速构建物联网应用。 #### 该仓库代码为社区版,将会不定时更新,文档末尾有社区和企业版本功能对比,企业版可通过文档末尾联系 ## 演示地址--企业版 ##### 演示使用,请不要暴力测试和修改密码,谢谢。 ###### http://47.109.145.72:28082/ ###### 账号:admin 密码:admin123 ### 使用中如果遇到问题或需要改进的地方,可以加入文档末尾QQ群在群里提问,同时也感谢您宝贵的建议。 ## 技术文档 ### [官方技术文档](http://47.109.145.72:18000/) ## 测试方式 ### 以MQTT_BROKER组件为例: #### 1、线上已经开启一个端口,连接即可 ![架构图](doc/img/mqtt.png) #### 2、发送以下消息到任意topic { "humidity": 45.7, "inTemperature": 22.5, "outTemperature": 31, "voice": 65.2, "windSpeed": 13.8, "deviceSn":"mqtt_001" } ![架构图](doc/img/mqtt_1.png) #### 3、查看对应SN设备数据,消息已经上来 ![架构图](doc/img/mqtt_2.png) ### Websocket方式也是如此: #### 1、线上已经开启一个ws连接地址: ws://47.109.145.72:10883/test1 #### 2、发送消息 { "humidity": 45.7, "inTemperature": 22.5, "outTemperature": 31, "voice": 65.2, "windSpeed": 12.8, "deviceSn":"WS_DEVICE_001" } #### 3、查看WS_DEVICE_001设备数据 ![架构图](doc/img/ws.png) #### 4、在历史数据按钮里面能够看到上下线和上报的历史数据 ![架构图](doc/img/history.png) ### 其他网络组件也是如此,由于线上环境这两种协议比较方便测试,只添加了这两种数据。 ## 🚀 核心特性 ### 1. 设备全生命周期管理 - **状态监控** - 实时设备在线状态跟踪,多种在离线模式 - **数据清理** - 设备可单独配置消息保存时间,到期自动删除 ### 2. 多协议接入支持 - **TCP** - 稳定可靠的长连接通信 - **MQTT** - 轻量级的发布订阅模式 - **UDP** - 高效的低延迟数据传输 - **CoAP** - 专为受限设备设计的协议 - **HTTP** - 标准的RESTful接口 - **WebSocket** - 实时双向通信 - **MODBUS** - 工业物联网设备协议 ### 3. 智能消息解析 - **协议适配** - 多种数据格式解析(JSON、二进制、自定义) - **数据转换** - 灵活的数据格式转换和归一化 - **规则引擎** - 可配置的数据处理规则 - **设备联动** - 可视化配置多设备之间告警执行动作 - **数据转发** - 可配置数据转发到各种消息队列,HTTP接口 ### 4. 实时告警系统 - **阈值告警** - 可配置的数据阈值监控 - **规则引擎** - 灵活的告警规则定义 - **设备联动** - 灵活的设备联动配置,如A设备触发告警、执行B设备指令 - **多通道通知(开发中)** - 邮件、短信、Webhook等多种通知方式 - **告警分级** - 多级别告警管理 ### 5. 远程功能下发 - **指令管理** - 统一的指令下发接口 - **自动下发** - 触发告警后自动下发相应指令 - **历史记录** - 手动\告警触发指令执行记录 ### 6、协议开发 #### 协议包在代码同级目录 protocol.zip ##### 开发协议只需要实现对应网络协议的decode和encode方法即可 decode对应设备上行消息协议 encode对应设备指令下发解析 ##### 以mqtt-client为例 1、实现MqttClientProtocol的decode方法,并把解析后的消息组装到DecodeMessage类并返回。 2、实现MqttClientProtocol的encode方法,并把解析后的消息组装到EncodeMessage类并返回。 3、打包成jar包上传到平台,并选择对应的协议分类即可。 #### 注意:更新或者新增协议无需重启项目,上传即生效,平台启动之后,后续任何操作都无需再重启平台。 下面是协议中重要的类截图 MqttClientProtocol接口: ![架构图](doc/img/img.png) MqttClientDeal实现类: ![架构图](doc/img/img_4.png) DecodeMessage解析后的消息实体: ![架构图](doc/img/img_2.png) EncodeMessage解析后的指令下发实体: ![架构图](doc/img/img_3.png) ## 🏗️ 系统架构 ![架构图](doc/img/jiagou.png) ## 🛠️ 快速开始 #### 1、首页 ![架构图](doc/img/index.png) #### 2、产品管理 ![架构图](doc/img/product.png) #### 3、告警配置 ![架构图](doc/img/warnConfig.png) #### 4、实时数据 ![架构图](doc/img/realtime.png) #### 5、指令下发 ![架构图](doc/img/down.png) #### 6、物模型 ![架构图](doc/img/model.png) #### 7、告警记录 ![架构图](doc/img/warnRecord.png) #### 8、其他配置 ![架构图](doc/img/otherConfig.png) #### 9、网络组件 ![架构图](doc/img/component.png) #### 10、组件调试 ![架构图](doc/img/tiaoshi.png) #### 11、协议管理 ![架构图](doc/img/protocol.png) #### 12、规则引擎-数据转发 ![架构图](doc/img/ruleEngine.png) #### 13、规则引擎-设备联动 ![架构图](doc/img/liandong.png) #### 14、规则引擎-定时下发指令 ![架构图](doc/img/dingshi.png) #### 15、设备管理-地图服务 ![架构图](doc/img/ditu.png) ### 环境要求 ###### JDK >= 1.8 ###### MySQL >= 5.7 ###### Maven >= 3.0 ###### Node >= 12 ###### Redis >= 3 ## 📊 社区版 vs 企业版 | 功能特性 | 社区版 | 企业版 | |-------------|----|-----------| | **设备接入** | | | | 最大设备数量 | 无限制 | 无限制 | | MQTT_CLIENT | ✅ | ✅ | | TCP | ✅ | ✅ | | MQTT_BROKER | ❌ | ✅ | | HTTP | ❌ | ✅ | | COAP | ❌ | ✅ | | UDP | ❌ | ✅ | | WEBSOCKET | ❌ | ✅ | | MODBUS | ❌ | ✅(开发中) | | **数据处理** | | | | 消息解析 | ✅ | ✅ | | 规则引擎 | ❌ | ✅可视化规则引擎 | | 设备联动 | ❌ | ✅可视化配置设备联动 | | **系统功能** | | | | 实时数据监控 | ✅ | ✅ | | 设备状态监控方式 | 心跳 | ✅网关、长连接、心跳 | | 指令下发 | ✅ | ✅ | | 告警配置 | ✅ | ✅ | | 告警自动执行指令 | ❌ | ✅ | | 定时执行指令 | ❌ | ✅可视化配置 | | 地图展示 | ❌ | ✅ | | **管理功能** | | | | 用户权限 | ✅ | ✅ | | 项目管理 | ✅ | ✅ | | 审计日志 | ✅ | ✅ | | **服务支持** | | | | 技术支持 | 社区支持 | 专属技术支持 | | 更新保障 | ✅ | ✅ | | 定制开发 | ❌ | ✅ (按需求收费) | ### 安装部署 请参考若依框架安装教程 传送门:https://www.ruoyi.vip/ ### 特别鸣谢 本项目基础框架采用 若依框架 https://www.ruoyi.vip/ ### 技术交流QQ群 #### 群号:734515931 ![架构图](doc/img/qqq.png) ### 商务合作请联系:邮箱 1738450125@qq.com 或者 加入QQ群联系群主 ### ⭐ 支持项目 如果这个项目对您有帮助,请给我们一个 Star!您的支持是我们持续更新的动力。