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 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 에이전트(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룰 스크립트, 프로토콜 envelope, 업/다운링크, 사물모델, 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를 확인하세요.
이 프로젝트에 기여해주신 모든 분들께 감사드립니다!
기여에 참여하고 싶으시다면 기여자 가이드를 확인해주세요.
- 비즈니스 협력: mqttsnet@163.com
- 이슈 보고: GitHub Issues
- 풀 리퀘스트: GitHub PRs
안내: 본 프로젝트는 여러 코드 호스팅 플랫폼에 미러링됩니다. 버그 보고, 기능 요청, 기술 토론의 유일한 공식 채널은 GitHub Issues입니다. 다른 플랫폼(Gitee, Gitea 등)에서 제출된 이슈는 처리되지 않습니다.
 WeChat: MqttsNet |
- Apache BifroMQ — 고성능 MQTT Broker
ThingLinks 커뮤니티 에디션은 Apache License 2.0에 따라 오픈소스로 제공됩니다. 추가 상용 조건은 LICENSE-COMMERCIAL을 참조하십시오.
상용 / 엔터프라이즈 라이선스는 mqttsnet@163.com으로 문의하십시오.
Copyright © 2019-present MqttsNet. All rights reserved.