ThingLinks IoT Platform

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

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

---

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

Architecture Diagram (click to expand)

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 -f thinglinks-cloud/docker/docker-compose.yml 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
│   └── 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

Documentation

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

🤖 Agent Skills (AI-assisted development)

Official Agent Skills document this project for AI agents (Claude Code · Codex · Cursor) — answers grounded in real code, loaded on demand. One skill per sub-project, from the ThingLinks Skills collection:

# 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

Auto-triggers when you work on rule scripts, the protocol envelope, uplink/downlink, thing-model, ACL, console pages, or BifroMQ auth/event plugins. Browse all skills (incl. thinglinks-util) at mqttsnet/thinglinks-skills.

Screenshots

Basic Platform (4 screenshots)

DevOps System (7 screenshots)

IoT System (15 screenshots)

IoT Card System (2 screenshots)

Visualization Dashboard (1 screenshot)

Video Streaming System (2 screenshots)

Mobile H5 (5 screenshots)

Edition Comparison

Feature	Community	Commercial	Enterprise
Business Layer Source Code	✔ Full (GitHub/Gitee)	✔ 100% Complete	✔ Pro 100% Full
ThingLinks-util Core Library	✕ JAR only	✕ JAR only	✔ Full source
Technical Documentation	Community docs	Community docs	Full technical + architecture docs
Private Repository Access	✕	✔	✔
Modify package name	✕ Prohibited	✔ Allowed	✔ Unrestricted
Modify Maven groupId	✕ Prohibited	✔ Allowed	✔ Unrestricted
Modify author info	✕ Prohibited	⚠ Allowed (keep copyright)	✔ Unrestricted
Modify copyright info	✕ Prohibited	✕ Must retain	✔ Unrestricted

Community Edition Notice: Per the Apache 2.0 License and ThingLinks Commercial License, modification or removal of package names, Maven groupId, author attributions, and copyright notices in community edition source code is prohibited. Upgrade to Commercial or Enterprise edition to modify these identifiers.

Commercial / Enterprise License Activation: After purchasing, fill in the provided Authorization ID in the LICENSE-COMMERCIAL file and commit via git. The git commit history serves as proof of authorized activation. Verify your license at mqttsnet.com.

Roadmap

See GitHub Milestones for our planned features and upcoming releases.

Star History

Contributors

Thanks to all the wonderful people who contribute to this project!

Want to contribute? Check out the Contributor Guide.

Contact

• Business Cooperation: mqttsnet@163.com
• Issues: GitHub Issues
• Pull Requests: GitHub PRs

Note: This project is mirrored to multiple code hosting platforms. The only official channel for bug reports, feature requests, and discussions is GitHub Issues. Issues submitted on other platforms (Gitee, Gitea, etc.) will not be monitored or addressed.

WeChat: MqttsNet

Acknowledgments

• Apache BifroMQ — High-performance MQTT broker

License

ThingLinks Community Edition is licensed under the Apache License 2.0 with additional commercial terms — see LICENSE-COMMERCIAL for details.

For commercial or enterprise licensing, contact mqttsnet@163.com.

---

Copyright © 2019-present MqttsNet. All rights reserved.

Thanks to JetBrains for providing free IDE licenses