<div align="center">

<a href="https://mqttsnet.com"><img src="./docs/images/logo.png" alt="ThingLinks" width="200"></a>

ThingLinks IoT Platform

Multi-tenant SaaS Cloud IoT Platform — High Performance · High Throughput · Highly Scalable

English | 简体中文 | 日本語 | 한국어

<br>

</div>

---

About

ThingLinks is an enterprise-grade multi-tenant SaaS cloud IoT platform built on Spring Cloud microservices architecture. It delivers high-performance, high-throughput, and highly-scalable device connectivity, supporting millions of concurrent connections on a single node with plugin-based extensibility and multi-protocol adaptation.

Architecture

<details> <summary><b>Architecture Diagram</b> (click to expand)</summary> <br> <a href="docs/images/architecture.png"><img src="docs/images/architecture.png" alt="ThingLinks Architecture" width="100%"></a> </details>

Core Features

| Feature | Description | |---------|-------------| | Multi-tenant SaaS | Enterprise-grade multi-tenant architecture with complete tenant isolation | | Million-level Connections | Single node supports millions of concurrent device connections | | Multi-protocol | MQTT, WebSocket, TCP, UDP, CoAP, HTTP, Modbus and more | | Device Management | Unified product model, device lifecycle, device shadow, firmware OTA | | Rule Engine | Chained rules, event orchestration, scene linkage (property/action/timer triggers) | | Alarm Center | Multi-channel alarm notification, alarm records and tracking | | SCADA & Visualization | Asset map, device geographic visualization, SCADA dashboards, large-screen displays | | Time-series Database | TDengine — one table per device, one super-table per device type | | Plugin System | Plugin-based development for custom protocol and feature extensions | | Message Bus | Message governance: formatting, routing, filtering, queueing, security | | Protocol SDK | Java-SDK, C-SDK, Python-SDK for protocol extensions | | IoT Card Management | SIM card channel management, card lifecycle management | | Video Streaming | Media server integration, video stream proxy | | AI Data Platform | Big data platform, AI analytics, BI analysis, video center (Planned) | | Ecosystem | Huawei IoT, Alibaba IoT, Apache BifroMQ integration |

Tech Stack

Quick Start

Requirements

| Component | Version | |-----------|---------| | JDK | 17+ | | Node.js | 18+ | | MySQL | 8.0+ | | Redis | 7.x | | TDengine | 3.x | | Nacos | 3.x |

Backend

# 1. Clone the repository
git clone https://github.com/mqttsnet/thinglinks.git

# 2. Import SQL scripts (see docs/sql/)

# 3. Configure Nacos, MySQL, Redis, TDengine connection info

# 4. Build
cd thinglinks/thinglinks-cloud
mvn clean install -DskipTests

# 5. Start services (gateway, oauth, link, etc.)

Frontend

# Admin Console
cd thinglinks-web
pnpm install
pnpm run dev

# Visualization Dashboard
cd thinglinks-web-visualize
pnpm install
pnpm run dev

Docker

# One-click deployment
docker-compose up -d

For detailed deployment guide, visit mqttsnet.com.

Project Structure

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

Documentation

For complete documentation including quick start guides, development guides, API references, and deployment instructions, visit the official website:

Screenshots

<details> <summary><b>Basic Platform</b> (4 screenshots)</summary> <br> <p> <a href="docs/images/pc/login.png"><img src="docs/images/pc/login.png" width="270" alt="Login"></a> <a href="docs/images/pc/basic/myApplication.png"><img src="docs/images/pc/basic/myApplication.png" width="270" alt="My Application"></a> <a href="docs/images/pc/basic/openAccessKey.png"><img src="docs/images/pc/basic/openAccessKey.png" width="270" alt="Access Key"></a> </p> <p> <a href="docs/images/pc/basic/openApi.png"><img src="docs/images/pc/basic/openApi.png" width="270" alt="Open API"></a> </p> </details> <details> <summary><b>DevOps System</b> (7 screenshots)</summary> <br> <p> <a href="docs/images/pc/devOperation/tenant.png"><img src="docs/images/pc/devOperation/tenant.png" width="270" alt="Tenant Management"></a> <a href="docs/images/pc/devOperation/project.png"><img src="docs/images/pc/devOperation/project.png" width="270" alt="Project Management"></a> <a href="docs/images/pc/devOperation/application.png"><img src="docs/images/pc/devOperation/application.png" width="270" alt="Application Management"></a> </p> <p> <a href="docs/images/pc/devOperation/resource.png"><img src="docs/images/pc/devOperation/resource.png" width="270" alt="Resource Management"></a> <a href="docs/images/pc/devOperation/generator.png"><img src="docs/images/pc/devOperation/generator.png" width="270" alt="Code Generator"></a> <a href="docs/images/pc/devOperation/opsInterface.png"><img src="docs/images/pc/devOperation/opsInterface.png" width="270" alt="Ops Interface"></a> </p> <p> <a href="docs/images/pc/devOperation/sopIsvInfo.png"><img src="docs/images/pc/devOperation/sopIsvInfo.png" width="270" alt="ISV Info"></a> </p> </details> <details> <summary><b>IoT System</b> (15 screenshots)</summary> <br> <p> <a href="docs/images/pc/iotSystem/product.png"><img src="docs/images/pc/iotSystem/product.png" width="270" alt="Product Management"></a> <a href="docs/images/pc/iotSystem/productDetails.png"><img src="docs/images/pc/iotSystem/productDetails.png" width="270" alt="Product Details"></a> <a href="docs/images/pc/iotSystem/productService.png"><img src="docs/images/pc/iotSystem/productService.png" width="270" alt="Product Service"></a> </p> <p> <a href="docs/images/pc/iotSystem/device.png"><img src="docs/images/pc/iotSystem/device.png" width="270" alt="Device Management"></