ThingLinks 物联网平台

README

<div align="center">

<a href="https://mqttsnet.com"><img src="https://web-code-img.oss-cn-shanghai.aliyuncs.com/readme/36131e785d213e9e98a292ce.png" alt="ThingLinks" width="200"></a>

# ThingLinks 物联网平台

**多租户 SaaS 云物联网平台 — 高性能 · 高吞吐 · 高扩展**

[English](https://gitee.com/mqttsnet/thinglinks/blob/main/README.md) | 简体中文 | [日本語](https://gitee.com/mqttsnet/thinglinks/blob/main/README.ja.md) | [한국어](https://gitee.com/mqttsnet/thinglinks/blob/main/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)

<br>

[![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)

</div>

---

## 平台简介

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

## 系统架构

<details>
<summary><b>架构图</b>（点击展开）</summary>
<br>
<a href="https://gitee.com/mqttsnet/thinglinks/blob/main/docs/images/architecture.png"><img src="https://web-code-img.oss-cn-shanghai.aliyuncs.com/readme/efccb8373c50f2db70c66e62.png" alt="ThingLinks Architecture" width="100%"></a>
</details>

## 核心特性

| 特性 | 说明 |
|------|------|
| **多租户 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 -f thinglinks-cloud/docker/docker-compose.yml 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
│   └── docker/                      # Cloud Docker Compose Deployment
├── thinglinks-web/                  # Admin Console (Vue 3 + Vben)
├── thinglink