---

プラットフォーム概要

ThingLinks は、Spring Cloud マイクロサービスアーキテクチャに基づいて構築されたエンタープライズ向けマルチテナント SaaS クラウド IoT プラットフォームです。高性能・高スループット・高拡張性のデバイス接続能力を提供し、単一ノードで百万レベルの同時接続をサポートします。プラグインベースの拡張開発とマルチプロトコル対応が可能です。

システムアーキテクチャ

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

主な機能

機能	説明
マルチテナント 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 統合

技術スタック

クイックスタート

必要条件

コンポーネント	バージョン
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)がオンデマンドで読み込めるスキルとして提供します。サブプロジェクトごとに 1 スキル、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 枚）

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 ファイルに記入し、git commit で記録してください。git コミット履歴がライセンス認証の証明となります。mqttsnet.com で認証状態を確認できます。

ロードマップ

計画中の機能と今後のリリースについては、GitHub Milestones をご覧ください。

Star 推移

コントリビューター

このプロジェクトに貢献してくださった皆様に感謝します！

貢献に参加しませんか？コントリビューターガイドをご覧ください。

お問い合わせ

• ビジネス協力：[email protected]
• 問題報告：GitHub Issues
• プルリクエスト：GitHub PRs

注意： 本プロジェクトは複数のコードホスティングプラットフォームにミラーリングされています。バグ報告、機能リクエスト、技術的な議論の唯一の公式チャネルは GitHub Issues です。他のプラットフォーム（Gitee、Gitea など）で提出された Issue は対応いたしません。

WeChat: MqttsNet

謝辞

• Apache BifroMQ — 高性能 MQTT Broker

ライセンス

ThingLinks コミュニティ版は Apache License 2.0 に基づきオープンソースで提供されます。追加の商用条件は LICENSE-COMMERCIAL をご参照ください。

商用版 / エンタープライズ版のライセンスについては [email protected] までお問い合わせください。

---