---

平台简介

ThingLinks 是一款企业级多租户 SaaS 云物联网平台，基于 Spring Cloud 微服务架构构建，具备高性能、高吞吐、高扩展的设备接入能力。单机支持百万级并发连接，支持插件化扩展开发和多协议适配。

系统架构

架构图（点击展开）

核心特性

特性	说明
多租户 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 集成

技术栈

快速开始

环境要求

组件	版本
JDK	17+
Node.js	18+
MySQL	8.0+
Redis	7.x
TDengine	3.x
Nacos	3.x

后端

# 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 等）

前端

# 管理控制台
cd thinglinks-web
pnpm install
pnpm run dev

# 可视化大屏
cd thinglinks-web-visualize
pnpm install
pnpm run dev

Docker

# 一键部署
docker compose -f thinglinks-cloud/docker/docker-compose.yml up -d

详细部署指南请访问 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
│   └── docker/                      # Cloud Docker Compose Deployment
├── 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
├── docs/                            # Documentation & Screenshots
└── scripts/                         # Build & Utility Scripts

文档

完整文档包括快速入门指南、开发指南、API 参考和部署说明，请访问官方网站：

🤖 Agent Skills(AI 辅助开发)

官方 Agent Skills 把本项目的真实代码结论整理成 AI 代理(Claude Code · Codex · Cursor)按需加载的技能包,按子项目拆分,来自 ThingLinks Skills 集合:

# global (-g); drop -g to install into the current project only
npx skills add mqttsnet/thinglinks-skills@thinglinks-cloud -g    # backend microservices
npx skills add mqttsnet/thinglinks-skills@thinglinks-web -g      # admin console (Vue3)
npx skills add mqttsnet/thinglinks-skills@bifromq-plugin -g      # BifroMQ broker plugins

当你编写规则脚本、协议报文、上行/下行链路、物模型、ACL、控制台页面或 BifroMQ 鉴权/事件插件时自动触发。全部技能(含 thinglinks-util)见 mqttsnet/thinglinks-skills。

产品截图

基础平台（4 张截图）

开发运营系统（7 张截图）

物联网业务系统（15 张截图）

物联卡业务系统（2 张截图）

大屏可视化系统（1 张截图）

流媒体业务系统（2 张截图）

移动端 H5（5 张截图）

版本对比

功能	社区版	商业版	旗舰版
业务层源码	✔ 完整（GitHub/Gitee 公开）	✔ 100% 完整	✔ Pro 版 100% 全部
ThingLinks-util 底层库	✕ JAR 引用	✕ JAR 引用	✔ 完整源码
技术文档	社区文档	社区文档	完整技术 + 架构文档
私有仓库权限	✕	✔	✔
修改 package 包名	✕ 禁止	✔ 允许	✔ 不受限制
修改 Maven groupId	✕ 禁止	✔ 允许	✔ 不受限制
修改作者信息	✕ 禁止	⚠ 可改，须保留版权	✔ 不受限制
修改版权信息	✕ 禁止	✕ 须保留	✔ 不受限制

社区版用户请注意： 根据 Apache 2.0 协议与 ThingLinks 授权协议，社区版源码中的 package 包名、Maven groupId、作者署名及版权声明均不可修改或移除。违反此规定将构成侵权。如需修改标识信息，请升级至商业版或旗舰版。

商业版 / 旗舰版授权激活： 购买后，请将我们提供的授权 ID 填入 LICENSE-COMMERCIAL 文件中的授权信息区域，并通过 git commit 提交。git 提交记录将作为授权生效的关键证明。通过 mqttsnet.com 可验证授权状态。

路线图

请查看 GitHub Milestones 了解我们的功能规划和即将发布的版本。

Star 趋势

贡献者

感谢所有为本项目做出贡献的优秀开发者！

欢迎参与贡献！请查阅 贡献者指南。

联系我们

• 商业合作：[email protected]
• 问题反馈：GitHub Issues
• 提交 PR：GitHub Pull Requests

声明： 本项目同步镜像至多个代码托管平台。Bug 反馈、功能建议、技术讨论的唯一官方渠道为 GitHub Issues，其他平台（Gitee、Gitea 等）提交的 Issue 不予处理。

微信搜一搜 MqttsNet

致谢

• Apache BifroMQ — 高性能 MQTT Broker

开源协议

ThingLinks 社区版基于 Apache License 2.0 开源，附加商业条款详见 LICENSE-COMMERCIAL。

商业版 / 旗舰版授权请联系 [email protected]。

---