# thinglinks **Repository Path**: mqttsnet/thinglinks ## Basic Information - **Project Name**: thinglinks - **Description**: ThingLinks — 企业级高性能物联网平台。多协议接入(MQTT · HTTP · CoAP · TCP · Modbus), 开箱即用的规则引擎、可视化大屏与多租户能力。 - **Primary Language**: Java - **License**: Apache-2.0 - **Default Branch**: main - **Homepage**: https://mqttsnet.com - **GVP Project**: Yes ## Statistics - **Stars**: 5142 - **Forks**: 1525 - **Created**: 2021-12-08 - **Last Updated**: 2026-03-29 ## Categories & Tags **Categories**: iot **Tags**: bifromq, mqtt, mqttsnet, IOT, thinglinks ## README
ThingLinks # ThingLinks 物联网平台 **多租户 SaaS 云物联网平台 — 高性能 · 高吞吐 · 高扩展** [English](README.md) | 简体中文 | [日本語](README.ja.md) | [한국어](README.ko.md) [![JDK](https://img.shields.io/badge/JDK-17+-orange?style=flat-square&logo=openjdk)](https://openjdk.org/) [![Spring Boot](https://img.shields.io/badge/Spring%20Boot-3.x-green?style=flat-square&logo=springboot)](https://spring.io/projects/spring-boot) [![Spring Cloud](https://img.shields.io/badge/Spring%20Cloud-2025-green?style=flat-square&logo=spring)](https://spring.io/projects/spring-cloud) [![Vue](https://img.shields.io/badge/Vue-3.x-brightgreen?style=flat-square&logo=vuedotjs)](https://vuejs.org/) [![TDengine](https://img.shields.io/badge/TDengine-3.0+-blue?style=flat-square)](https://tdengine.com/) [![License](https://img.shields.io/badge/License-Apache%202.0-blue?style=flat-square)](LICENSE) [![GitHub Stars](https://img.shields.io/github/stars/mqttsnet/thinglinks?style=flat-square)](https://github.com/mqttsnet/thinglinks/stargazers) [![GitHub Forks](https://img.shields.io/github/forks/mqttsnet/thinglinks?style=flat-square)](https://github.com/mqttsnet/thinglinks/network/members)
[![Website](https://img.shields.io/badge/Website-mqttsnet.com-blue?style=for-the-badge)](https://mqttsnet.com) [![GitHub](https://img.shields.io/badge/GitHub-mqttsnet/thinglinks-181717?style=for-the-badge&logo=github)](https://github.com/mqttsnet/thinglinks) [![Docs](https://img.shields.io/badge/Docs-Documentation-green?style=for-the-badge)](https://mqttsnet.com)
--- ## 平台简介 ThingLinks 是一款企业级**多租户 SaaS 云物联网平台**,基于 Spring Cloud 微服务架构构建,具备**高性能、高吞吐、高扩展**的设备接入能力。单机支持**百万级并发连接**,支持插件化扩展开发和多协议适配。 ## 系统架构
架构图(点击展开)
ThingLinks Architecture
## 核心特性 | 特性 | 说明 | |------|------| | **多租户 SaaS** | 企业级多租户架构,完整租户隔离 | | **百万级连接** | 单节点支持百万级设备并发连接 | | **多协议支持** | MQTT、WebSocket、TCP、UDP、CoAP、HTTP、Modbus 等 | | **设备管理** | 统一产品模型、设备全生命周期管理、设备影子、固件 OTA | | **规则引擎** | 链式规则、事件编排、场景联动(属性/动作/定时触发) | | **告警中心** | 多通道告警通知、告警记录与追踪 | | **SCADA 与可视化** | 资产地图、设备地理位置可视化、SCADA 组态、大屏展示 | | **时序数据库** | TDengine — 每个设备一张表,每类设备一个超级表 | | **插件系统** | 插件化开发,支持自定义协议和功能扩展 | | **消息总线** | 消息治理:格式化、路由、过滤、队列、安全 | | **协议 SDK** | Java-SDK、C-SDK、Python-SDK 用于协议扩展 | | **物联卡管理** | SIM 卡通道管理、卡片生命周期管理 | | **流媒体** | 流媒体服务集成、视频流代理 | | **AI 数据平台** | 大数据平台、AI 分析、BI 分析、视频中心(规划中) | | **生态集成** | 华为 IoT、阿里 IoT、Apache BifroMQ 集成 | ## 技术栈 ![Java 17+](https://img.shields.io/badge/Java-17+-ED8B00?style=flat-square&logo=openjdk&logoColor=white) ![Spring Boot](https://img.shields.io/badge/Spring%20Boot-3.x-6DB33F?style=flat-square&logo=springboot&logoColor=white) ![Spring Cloud](https://img.shields.io/badge/Spring%20Cloud-2025-6DB33F?style=flat-square&logo=spring&logoColor=white) ![Netty](https://img.shields.io/badge/Netty-4.x-0E83CD?style=flat-square) ![Vue 3](https://img.shields.io/badge/Vue.js-3.x-4FC08D?style=flat-square&logo=vuedotjs&logoColor=white) ![TDengine](https://img.shields.io/badge/TDengine-3.0+-0080FF?style=flat-square) ![Nacos](https://img.shields.io/badge/Nacos-3.x-1890FF?style=flat-square) ![Sentinel](https://img.shields.io/badge/Sentinel-1.x-00BFFF?style=flat-square) ![Seata](https://img.shields.io/badge/Seata-2.x-00CED1?style=flat-square) ![Redis](https://img.shields.io/badge/Redis-7.x-DC382D?style=flat-square&logo=redis&logoColor=white) ![MySQL](https://img.shields.io/badge/MySQL-8.0-4479A1?style=flat-square&logo=mysql&logoColor=white) ![Kafka](https://img.shields.io/badge/Kafka-Supported-231F20?style=flat-square&logo=apachekafka&logoColor=white) ![Docker](https://img.shields.io/badge/Docker-Supported-2496ED?style=flat-square&logo=docker&logoColor=white) ## 快速开始 ### 环境要求 | 组件 | 版本 | |------|------| | JDK | 17+ | | Node.js | 18+ | | MySQL | 8.0+ | | Redis | 7.x | | TDengine | 3.x | | Nacos | 3.x | ### 后端 ```bash # 1. 克隆仓库 git clone https://github.com/mqttsnet/thinglinks.git # 2. 导入 SQL 脚本(参见 docs/sql/) # 3. 配置 Nacos、MySQL、Redis、TDengine 连接信息 # 4. 构建 cd thinglinks/thinglinks-cloud mvn clean install -DskipTests # 5. 启动服务(gateway、oauth、link 等) ``` ### 前端 ```bash # 管理控制台 cd thinglinks-web pnpm install pnpm run dev # 可视化大屏 cd thinglinks-web-visualize pnpm install pnpm run dev ``` ### Docker ```bash # 一键部署 docker-compose up -d ``` > 详细部署指南请访问 [mqttsnet.com](https://mqttsnet.com)。 ## 项目结构 ``` thinglinks/ ├── thinglinks-cloud/ # Backend Microservices │ ├── thinglinks-gateway/ # API Gateway │ ├── thinglinks-oauth/ # Authentication & Authorization │ ├── thinglinks-link/ # IoT Device Connectivity Core │ ├── thinglinks-broker/ # MQTT Broker Integration (BifroMQ) │ ├── thinglinks-rule/ # Rule Engine │ ├── thinglinks-mqs/ # Message Queue Service │ ├── thinglinks-card/ # IoT Card Management │ ├── thinglinks-mobile/ # Mobile API │ ├── thinglinks-support/ # Monitor & Admin Services │ ├── thinglinks-sop-admin/ # DevOps Management │ ├── thinglinks-generator/ # Code Generator │ ├── thinglinks-openapi/ # Open API Service │ ├── thinglinks-public/ # Public Service │ ├── thinglinks-base/ # Base Platform Service │ └── thinglinks-sdk/ # SDK ├── thinglinks-web/ # Admin Console (Vue 3 + Vben) ├── thinglinks-web-visualize/ # Visualization Dashboard (Vue 3 + ECharts) ├── thinglinks-job/ # Scheduled Task Service (XXL-JOB) ├── bifromq-plugin/ # Apache BifroMQ Plugin ├── docker/ # Docker Compose Deployment ├── docs/ # Documentation & Screenshots └── scripts/ # Build & Utility Scripts ``` ## 文档 完整文档包括快速入门指南、开发指南、API 参考和部署说明,请访问官方网站: [![Docs](https://img.shields.io/badge/Documentation-mqttsnet.com-blue?style=for-the-badge)](https://mqttsnet.com) ## 产品截图
基础平台(4 张截图)

Login My Application Access Key

Open API

开发运营系统(7 张截图)

Tenant Management Project Management Application Management

Resource Management Code Generator Ops Interface

ISV Info

物联网业务系统(15 张截图)

Product Management Product Details Product Service

Device Management Device Debug Device Shadow

Device Shadow Detail Asset Statistics Asset Map

Plugin Info Plugin Instance Chained Rule Engine

Device Linkage Groovy Script Rule SCADA

物联卡业务系统(2 张截图)

Card Channel Info SIM Card Info

大屏可视化系统(1 张截图)

Visualization Dashboard

流媒体业务系统(2 张截图)

Media Server Stream Proxy

移动端 H5(5 张截图)

Login Home Dashboard My Home Scene

## 版本对比 | 功能 | 社区版 | 商业版 | 旗舰版 | |------|:------:|:------:|:------:| | 业务层源码 | ✔ 完整(GitHub/Gitee 公开) | ✔ 100% 完整 | ✔ Pro 版 100% 全部 | | ThingLinks-util 底层库 | ✕ JAR 引用 | ✕ JAR 引用 | ✔ 完整源码 | | 技术文档 | 社区文档 | 社区文档 | 完整技术 + 架构文档 | | 私有仓库权限 | ✕ | ✔ | ✔ | | 修改 package 包名 | ✕ 禁止 | ✔ 允许 | ✔ 不受限制 | | 修改 Maven groupId | ✕ 禁止 | ✔ 允许 | ✔ 不受限制 | | 修改作者信息 | ✕ 禁止 | ⚠ 可改,须保留版权 | ✔ 不受限制 | | 修改版权信息 | ✕ 禁止 | ✕ 须保留 | ✔ 不受限制 | > **社区版用户请注意:** 根据 Apache 2.0 协议与 ThingLinks 授权协议,社区版源码中的 package 包名、Maven groupId、作者署名及版权声明均不可修改或移除。违反此规定将构成侵权。如需修改标识信息,请升级至商业版或旗舰版。 > **商业版 / 旗舰版授权激活:** 购买后,请将我们提供的授权 ID 填入 [LICENSE-COMMERCIAL](LICENSE-COMMERCIAL) 文件中的授权信息区域,并通过 git commit 提交。git 提交记录将作为授权生效的关键证明。通过 [mqttsnet.com](https://mqttsnet.com) 可验证授权状态。 ## 路线图 请查看 [GitHub Milestones](https://github.com/mqttsnet/thinglinks/milestones) 了解我们的功能规划和即将发布的版本。 ## Star 趋势 Star History Chart ## 贡献者 感谢所有为本项目做出贡献的优秀开发者! Contributors 欢迎参与贡献!请查阅 [贡献者指南](CONTRIBUTING.md)。 ## 联系我们 - 商业合作:[mqttsnet@163.com](mailto:mqttsnet@163.com) - 问题反馈:[GitHub Issues](https://github.com/mqttsnet/thinglinks/issues) - 提交 PR:[GitHub Pull Requests](https://github.com/mqttsnet/thinglinks/pulls) > **声明:** 本项目同步镜像至多个代码托管平台。Bug 反馈、功能建议、技术讨论的**唯一官方渠道**为 [GitHub Issues](https://github.com/mqttsnet/thinglinks/issues),其他平台(Gitee、Gitea 等)提交的 Issue 不予处理。
微信搜一搜 MqttsNet
微信搜一搜 MqttsNet
## 致谢 - [Apache BifroMQ](https://github.com/apache/bifromq) — 高性能 MQTT Broker ## 开源协议 ThingLinks 社区版基于 [Apache License 2.0](LICENSE) 开源,附加商业条款详见 [LICENSE-COMMERCIAL](LICENSE-COMMERCIAL)。 商业版 / 旗舰版授权请联系 [mqttsnet@163.com](mailto:mqttsnet@163.com)。 ---
Copyright © 2019-present [MqttsNet](https://mqttsnet.com). All rights reserved. [感谢 JetBrains 提供免费 IDE 许可](https://www.jetbrains.com)