# ThingLinks IoT プラットフォーム **マルチテナント SaaS クラウド IoT プラットフォーム — 高性能 · 高スループット · 高拡張性** [English](README.md) | [简体中文](README.zh-CN.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 は、Spring Cloud マイクロサービスアーキテクチャに基づいて構築されたエンタープライズ向け**マルチテナント SaaS クラウド IoT プラットフォーム**です。**高性能・高スループット・高拡張性**のデバイス接続能力を提供し、単一ノードで**百万レベルの同時接続**をサポートします。プラグインベースの拡張開発とマルチプロトコル対応が可能です。 ## システムアーキテクチャ

アーキテクチャ図（クリックして展開）

ThingLinks Architecture

## 主な機能 | 機能 | 説明 | |------|------| | **マルチテナント SaaS** | エンタープライズ向けマルチテナントアーキテクチャ、完全なテナント分離 | | **百万レベル接続** | 単一ノードで百万レベルのデバイス同時接続をサポート | | **マルチプロトコル** | MQTT、WebSocket、TCP、UDP、CoAP、HTTP、Modbus 等に対応 | | **デバイス管理** | 統一製品モデル、デバイスライフサイクル管理、デバイスシャドウ、ファームウェア OTA | | **ルールエンジン** | チェーンルール、イベントオーケストレーション、シーン連携（プロパティ/アクション/タイマートリガー） | | **アラームセンター** | マルチチャネルアラーム通知、アラーム記録・追跡 | | **SCADA & 可視化** | アセットマップ、デバイス地理位置可視化、SCADA ダッシュボード、大画面表示 | | **時系列データベース** | TDengine — デバイスごとに1テーブル、デバイスタイプごとに1スーパーテーブル | | **プラグインシステム** | プラグインベース開発、カスタムプロトコル・機能拡張対応 | | **メッセージバス** | メッセージガバナンス：フォーマット、ルーティング、フィルタリング、キューイング、セキュリティ | | **プロトコル SDK** | Java-SDK、C-SDK、Python-SDK によるプロトコル拡張 | | **IoT カード管理** | SIM カードチャネル管理、カードライフサイクル管理 | | **ビデオストリーミング** | メディアサーバー統合、ビデオストリームプロキシ | | **AI データプラットフォーム** | ビッグデータプラットフォーム、AI 分析、BI 分析、ビデオセンター（計画中） | | **エコシステム** | Huawei IoT、Alibaba 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) ├── 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 リファレンス、デプロイ手順を含む完全なドキュメントは、公式ウェブサイトをご覧ください： [![Docs](https://img.shields.io/badge/Documentation-mqttsnet.com-blue?style=for-the-badge)](https://mqttsnet.com) ## 🤖 Agent Skills(AI 支援開発) 公式 **Agent Skills** は、本プロジェクトの実コードに基づく知見を AI エージェント(Claude Code · Codex · Cursor)がオンデマンドで読み込めるスキルとして提供します。サブプロジェクトごとに 1 スキル、**[ThingLinks Skills](https://github.com/mqttsnet/thinglinks-skills)** コレクションより: ```bash # 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](https://github.com/mqttsnet/thinglinks-skills)** へ。 ## スクリーンショット

基盤プラットフォーム（4 枚）

DevOps システム（7 枚）

IoT システム（15 枚）

IoT カードシステム（2 枚）

可視化ダッシュボード（1 枚）

ビデオストリーミングシステム（2 枚）

モバイル H5（5 枚）

## エディション比較 | 機能 | コミュニティ版 | 商用版 | エンタープライズ版 | |------|:------------:|:------:|:-----------------:| | ビジネスレイヤーソースコード | ✔ 完全（GitHub/Gitee 公開） | ✔ 100% 完全 | ✔ Pro 版 100% 全体 | | ThingLinks-util コアライブラリ | ✕ JAR 参照 | ✕ JAR 参照 | ✔ 完全ソースコード | | 技術ドキュメント | コミュニティドキュメント | コミュニティドキュメント | 完全な技術 + アーキテクチャドキュメント | | プライベートリポジトリアクセス | ✕ | ✔ | ✔ | | パッケージ名の変更 | ✕ 禁止 | ✔ 許可 | ✔ 制限なし | | Maven groupId の変更 | ✕ 禁止 | ✔ 許可 | ✔ 制限なし | | 作者情報の変更 | ✕ 禁止 | ⚠ 可（著作権表示は保持） | ✔ 制限なし | | 著作権情報の変更 | ✕ 禁止 | ✕ 保持必須 | ✔ 制限なし | > **コミュニティ版ユーザーへの注意：** Apache 2.0 ライセンスおよび ThingLinks 商用ライセンスに基づき、コミュニティ版ソースコードのパッケージ名、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) - プルリクエスト：[GitHub PRs](https://github.com/mqttsnet/thinglinks/pulls) > **注意：** 本プロジェクトは複数のコードホスティングプラットフォームにミラーリングされています。バグ報告、機能リクエスト、技術的な議論の**唯一の公式チャネル**は [GitHub Issues](https://github.com/mqttsnet/thinglinks/issues) です。他のプラットフォーム（Gitee、Gitea など）で提出された Issue は対応いたしません。

WeChat: MqttsNet

_{WeChat: 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)