©Thingsboard 소규모 IoT 플랫폼 개발 및 배포

Table of Contents

히스토리
관련메타
상위노트
관련링크
ThingsBoard 키워드
ThingsBoard 온프레미스 IoT 서비스 구축 시 결정 사항 및 개발 요소 정리
ThingsBoard PE(Professional Edition) 프로페셔널 에디션 정책
대기중: 소스코드 빌드 프론트엔드 별도 분리

히스토리

[2025-06-26 Thu 15:05] 관련 사례

BIBLIOGRAPHY

thingsboard. (n.d.—a). Building from sources. ThingsBoard. Retrieved July 1, 2025, from https://thingsboard.io/docs/user-guide/install/building-from-source/

thingsboard. (n.d.—b). Thingsboard community edition. ThingsBoard. Retrieved June 26, 2025, from https://thingsboard.io/docs/

Thingsboard pe edition source code 소스코드 백엔드 빌드 프론트엔드. (n.d.). Retrieved July 3, 2025, from https://www.perplexity.ai/search/thingsboard-pe-edition-source-2Bh9L2hkTH.ortT3aohc9g

Thingsboard/thingsboard. (2025). [Computer software]. ThingsBoard - Open-source IoT Platform. https://github.com/thingsboard/thingsboard (2016)

상위노트

2b #업무#프로젝트

ThingsBoard 키워드

1. 시스템 아키텍처

Monolithic deployment: 단일 서버 배포
Microservices cluster: 마이크로서비스 클러스터
Kubernetes: 쿠버네티스
High availability: 고가용성

2. 데이터베이스

PostgreSQL: PostgreSQL
Hybrid storage: 하이브리드 저장 방식
TimescaleDB: TimescaleDB
Partitioning: 파티셔닝

3. 프로토콜

MQTT: MQTT
CoAP: CoAP
LwM2M: 경량 M2M
Payload parsing: 페이로드 파싱

4. 규칙 엔진

Rule Chain: 규칙 체인
Custom rule node: 커스텀 규칙 노드
Alarm threshold: 알람 임계값
Event processing: 이벤트 처리

5. 대시보드

Widget: 위젯
Time-series chart: 시계열 차트
Gauge widget: 게이지 위젯
KPI dashboard: 핵심 성과 지표 대시보드

6. 보안

Two-factor authentication (2FA): 이중 인증
Access token: 액세스 토큰
SSL/TLS: SSL/TLS
Password policy: 비밀번호 정책

7. 연동

REST API: REST API
Webhook: 웹훅
Edge gateway: 에지 게이트웨이
OPC-UA: OPC-UA

8. 성능

JVM heap: JVM 힙 메모리
Connection pool: 커넥션 풀
Load balancing: 로드 밸런싱
Data retention: 데이터 보존

9. 배포

On-premise: 온프레미스
Containerization: 컨테이너화
Disaster recovery: 재해 복구
Backup strategy: 백업 전략

10. 커스텀 개발

Data converter: 데이터 변환기
Protocol adapter: 프로토콜 어댑터
Custom visualization: 커스텀 시각화
Mobile interface: 모바일 인터페이스

이 키워드들은 ThingsBoard 기반 IoT 플랫폼 구축 시 핵심적으로 접하게 되는 용어들입니다.

ThingsBoard 온프레미스 IoT 서비스 구축 시 결정 사항 및 개발 요소 정리

Query Translation: Summary of decisions to make and development components needed when preparing on-premise IoT services by connecting various IoT devices using ThingsBoard, with maximum utilization of existing features

ThingsBoard를 활용한 온프레미스 IoT 서비스 구축 시, 기존 기능을 최대한 활용하면서도 몇 가지 핵심적인 결정 사항과 개발 요소들을 고려해야 합니다. 다음은 체계적인 접근 방법을 제시합니다.

1. 시스템 아키텍처 결정사항

1.1 배포 방식 선택

단일 서버 배포 (Monolithic) - 소규모 환경 (300,000 디바이스 미만, 초당 10,000개 메시지 처리)[1] - 하드웨어 요구사항: 최소 4GB RAM (PostgreSQL), 8GB RAM (Cassandra)[2] - 장점: 간단한 설치 및 관리, 낮은 초기 비용 - 단점: 확장성 제한, 단일 장애점 존재
마이크로서비스 클러스터 배포 - 대규모 환경 (수백만 디바이스 지원)[3] - Kubernetes 기반 컨테이너 오케스트레이션[3] - Apache Kafka, Redis, Cassandra 활용[3] - 장점: 고가용성, 무중단 업그레이드 가능 - 단점: 복잡한 설치 및 관리

1.2 데이터베이스 선택

PostgreSQL (권장) - 엔티티 및 시계열 데이터 통합 저장[4] - 최소 1GB RAM 요구사항[2] - 트랜잭션 지원, 고급 검색 기능 제공[4]
Hybrid 방식 (PostgreSQL + Cassandra/TimescaleDB) - 엔티티는 PostgreSQL, 시계열 데이터는 NoSQL[4] - 대용량 시계열 데이터 처리에 최적화[4] - 최소 8GB RAM 요구사항[2]

1.3 큐잉 시스템 결정

In-Memory (기본값) - 개발 및 테스트 환경에 적합[5] - 메시지 손실 위험 존재
Apache Kafka (운영 환경 권장) - 고성능, 내결함성 보장[5] - 대규모 메시지 처리 지원 - 클러스터 환경에서 필수[3]

2. IoT 디바이스 연결 설정

2.1 프로토콜 선택 및 설정

지원 프로토콜 - MQTT: 경량화, 낮은 대역폭 환경 최적화[6][7] - HTTP: 웹 기반 디바이스, RESTful 통신[6] - CoAP: UDP 기반, 제약 디바이스 지원[6] - LwM2M: 디바이스 관리 프로토콜[6] - SNMP: 네트워크 관리[6]
연결 설정 작업 - 각 프로토콜별 포트 설정 (MQTT: 1883, HTTP: 8080, CoAP: 5683)[8] - SSL/TLS 인증서 설정 (보안 연결 시)[8] - 디바이스별 액세스 토큰 생성[9][10] - MQTT 브로커 설정 (Basic Authentication 지원)[11]

2.2 디바이스 프로파일 구성

디바이스 프로파일 템플릿 개발 - 디바이스 유형별 표준 설정 템플릿 작성[12] - 텔레메트리 키 정의 (온도, 습도, 압력 등)[13] - 속성(Attributes) 구조 설계[13] - RPC 명령 정의[12]
대량 디바이스 프로비저닝 - CSV 파일을 통한 일괄 등록[12] - REST API 활용한 자동화 프로비저닝[12] - 디바이스 자동 검색 및 등록 기능 활용[14]

3. 데이터 처리 및 규칙 엔진 설정

3.1 규칙 체인(Rule Chain) 구성

기본 규칙 체인 활용[15] - 데이터 검증 및 변환 규칙 - 텔레메트리 데이터 저장 규칙 - 디바이스 상태 모니터링 규칙
커스텀 규칙 개발 필요사항 - 비즈니스 로직에 특화된 데이터 처리 - 외부 시스템 연동 (REST API 호출)[16] - 복잡한 이벤트 처리 로직 - 데이터 집계 및 분석 규칙[15]

3.2 알람 시스템 구성

알람 유형 정의[17] - 임계값 기반 알람 (온도, 습도 등) - 디바이스 상태 알람 (온라인/오프라인) - 통신 실패 알람 - 보안 위반 알람
알람 처리 워크플로우[17] - 알람 생성 조건 설정 - 알람 심각도 분류 (Critical, Major, Minor, Warning)[17] - 알람 자동 해제 조건 - 알람 통지 설정 (이메일, SMS, 웹훅)[17]

4. 사용자 인터페이스 및 대시보드 구성

4.1 대시보드 설계

기본 위젯 활용[18][19] - 시계열 차트 (Line, Bar, Point 차트)[19] - 게이지 위젯 (아날로그, 디지털)[20] - 맵 위젯 (디바이스 위치 추적)[20] - 테이블 위젯 (엔티티 목록)[20] - 제어 위젯 (Action, Command, Toggle, Power 버튼)[18]
커스텀 위젯 개발 필요사항 - 산업별 특화 시각화 위젯 - 복잡한 데이터 분석 차트 - 비즈니스 KPI 대시보드 - 실시간 모니터링 패널

4.2 멀티 테넌시 설정

사용자 계층 구조 설계 - 시스템 관리자 (System Administrator) - 테넌트 관리자 (Tenant Administrator) - 고객 사용자 (Customer User)[21] - 디바이스별 액세스 권한 설정

TODO 5. 보안 및 인증 시스템

5.1 사용자 인증 강화

이중 인증(2FA) 설정[22] - SMS 기반 인증 - 인증 앱 (Google Authenticator, Authy) 연동[22] - 백업 코드 시스템[22]
비밀번호 정책 설정[23] - 최소/최대 길이 제한 - 복잡성 요구사항 (대소문자, 숫자, 특수문자)[23] - 비밀번호 만료 주기 설정[23] - 재사용 금지 정책[23]

5.2 디바이스 보안

액세스 토큰 관리 - 디바이스별 고유 토큰 생성[9] - 토큰 주기적 갱신 정책 - 토큰 무효화 기능
네트워크 보안 - SSL/TLS 암호화 설정 - 방화벽 규칙 구성 - VPN 연결 지원

6. 외부 시스템 연동 개발

6.1 REST API 연동

기본 REST API 활용[16] - 디바이스 관리 API - 텔레메트리 데이터 API - 알람 관리 API - 사용자 관리 API
커스텀 API 개발 필요사항 - 외부 ERP/MES 시스템 연동 - 써드파티 분석 도구 연동 - 모바일 앱 백엔드 API - 웹훅 기반 실시간 통지

6.2 게이트웨이 연동

ThingsBoard 게이트웨이 활용[14] - OPC-UA 연결기 - Modbus 연결기 - CAN 버스 연결기 - BLE 연결기
커스텀 게이트웨이 개발 - 산업별 특화 프로토콜 지원 - 레거시 시스템 연동 - 에지 컴퓨팅 기능 추가

7. 성능 최적화 및 모니터링

7.1 성능 튜닝

하드웨어 최적화 - JVM 힙 메모리 설정 (최소 2GB 권장)[5] - 데이터베이스 커넥션 풀 조정 - 네트워크 버퍼 크기 최적화
데이터베이스 최적화 - 인덱스 최적화 - 파티셔닝 설정 - 백업 및 복구 전략

7.2 모니터링 시스템 구축

플랫폼 모니터링 - 시스템 리소스 모니터링 (CPU, 메모리, 디스크) - 네트워크 트래픽 모니터링 - 데이터베이스 성능 모니터링
비즈니스 모니터링 - 디바이스 연결 상태 추적 - 메시지 처리량 모니터링 - 알람 발생 빈도 분석

8. 데이터 관리 및 백업

8.1 데이터 생명주기 관리

데이터 보존 정책 - 실시간 데이터 보존 기간 설정 - 히스토리 데이터 아카이빙 - 압축 및 파티셔닝 전략
데이터 정리 작업 - 자동 데이터 삭제 스케줄링 - 오래된 로그 파일 정리 - 불필요한 알람 히스토리 정리

8.2 백업 및 복구

정기 백업 설정 - 데이터베이스 자동 백업 - 설정 파일 백업 - 시스템 이미지 백업
재해 복구 계획 - 백업 데이터 검증 - 복구 절차 문서화 - 정기적인 복구 테스트

TODO 9. 개발이 필요한 커스텀 구성요소

9.1 필수 개발 항목

데이터 변환기(Data Converter) - 디바이스별 페이로드 파싱[13] - 프로토콜별 데이터 포맷 변환 - 단위 변환 및 데이터 정규화
커스텀 규칙 노드 - 비즈니스 로직 처리 - 외부 API 호출 - 복잡한 데이터 분석
특화 위젯 - 산업별 시각화 요구사항 - 실시간 제어 인터페이스 - 커스텀 차트 및 그래프

9.2 선택적 개발 항목

모바일 애플리케이션 - 현장 작업자용 모바일 앱 - 실시간 알람 수신 - 원격 디바이스 제어
고급 분석 도구 - 머신러닝 기반 예측 분석 - 이상 징후 탐지 - 성능 최적화 추천
통합 보고서 시스템 - 자동화된 보고서 생성 - 다양한 포맷 지원 (PDF, Excel) - 스케줄링 기능

결론

ThingsBoard 온프레미스 서비스 구축 시 기존 기능을 최대한 활용하면 개발 부담을 크게 줄일 수 있습니다. 핵심은 표준 프로토콜과 기본 위젯을 활용하여 80-90%의 기능을 구현하고, 나머지 10-20%만 비즈니스 요구사항에 맞게 커스터마이징하는 것입니다[19].

특히 규칙 엔진, 대시보드 위젯, 알람 시스템 등의 기본 기능들이 충분히 강력하므로, 대부분의 IoT 서비스 요구사항은 설정만으로도 충족할 수 있습니다. 개발이 필요한 부분은 주로 특화된 데이터 변환, 외부 시스템 연동, 그리고 산업별 특수 요구사항에 국한됩니다.

모델 정보: Claude 3.5 Sonnet
생성 일시: 2025년 6월 26일 목요일 오후 2:46 KST
토큰 수: 약 45,000 토큰 (입력) + 8,200 토큰 (출력)

Citations:

이전 대화의 잉클 및 ThingsBoard 분석 내용
ThingsBoard installation options[1]
ThingsBoard IoT Platform deployment scenarios[3]
ThingsBoard Installations[24]
ThingsBoard Professional Edition installation options[25]
Install ThingsBoard Locally - Semtech Learning Center[8]
THINGSBOARD COMMUNITY EDITION installation tutorial on Ubuntu[26]
TCP Integration with ThingsBoard[27]
Installing ThingsBoard CE on Ubuntu Server[5]
Device Connectivity Protocols - ThingsBoard[6]
MQTT protocol - ThingsBoard[7]
Integrating MQTT with ThingsBoard for IoT Data Visualization[28]
ThingsBoard-Platform-Protocol-Test-Tool - GitHub[29]
Configuring ThingsBoard and Chirpstack[9]
Getting Started with Rule Engine[15]
Monitoring with ThingsBoard IoT Platform[11]
ThingsBoard Integration - tektelic[10]
Installing ThingsBoard CE on CentOS/RHEL[2]
Hardware requirement for 10 datapoints per second - GitHub[30]
Two-factor authentication - ThingsBoard[22]
ThingsBoard architecture[4]
Installing ThingsBoard Edge on Ubuntu Server[31]
Security settings - ThingsBoard[23]
Advanced widgets for enhanced IoT dashboards[18]
Enhancing IoT data visualization: new time series charts[19]
Working with alarms - ThingsBoard[17]
Working with IoT Dashboards[20]
Customization - Using-TA65-with-ThingsBoard[21]
Configure alarm details dashboards[32]
Edge Device Management - ThingsBoard[12]
Getting Started with ThingsBoard Edge[33]
Getting started with ThingsBoard IoT Gateway[14]
Device-profile templates - ChirpStack[34]
REST API Call Plugin - ThingsBoard[16]
Configure ThingsBoard With MQTT/HTTP Integrations[13]
IoT Solution templates overview[35]
How to invoke REST APIs from ThingsBoard dashboard widgets[36]

모델 정보: Claude 3.5 Sonnet 생성 일시: 2025년 6월 26일 목요일 오후 2:46 KST 토큰 수: 약 45,000 토큰 (입력) + 8,200 토큰 (출력)

레퍼런스

ThingsBoard PE(Professional Edition) 프로페셔널 에디션 정책

ThingsBoard PE(Professional Edition) 소스코드 관련 정보

영문 요약:
Query: Is the source code for ThingsBoard Professional Edition (PE) available, and how can it be accessed or modified? https://www.perplexity.ai/search/thingsboard-pe-edition-source-2Bh9L2hkTH.ortT3aohc9g

1. ThingsBoard PE 소스코드 공개 여부

ThingsBoard PE(Professional Edition)는 오픈소스가 아닙니다.
공식적으로 ThingsBoard는 Community Edition(CE, 커뮤니티 에디션)만 오픈소스로 소스코드를 공개하고 있습니다.
PE는 상용 라이선스 기반의 제품으로, 소스코드는 공개되어 있지 않습니다[2][1].
Stack Overflow 등 공식 커뮤니티에서도 PE는 소스코드 수정이 불가하다고 명확히 안내
“This is only possible for ThingsBoard CE, since it includes features like RBAC and Integrations which aren’t completely open source. Therefore you need to stick to official builds by ThingsBoard Dev team.”
즉, CE(Community Edition)만 소스코드 변경이 가능하며, PE는 공식 빌드만 사용할 수 있습니다[2].

2. ThingsBoard PE에서 확장/커스터마이즈 방법

공식적으로 지원되는 확장 방법
PE 소스코드를 직접 수정할 수는 없으나, 공식 문서에서는 다음과 같은 확장 포인트를 제공합니다.
- 커스텀 디바이스 인티그레이션(Integration)
- 커스텀 룰 노드(Rule Node)
- 커스텀 위젯(Widget) 개발
  이 방법을 통해 ThingsBoard PE의 기능을 확장할 수 있습니다[2].
관련 공식 가이드

3. ThingsBoard PE 관련 오픈소스 리소스

Kubernetes 배포 스크립트 등은 공개
PE 자체의 소스코드는 아니지만, Kubernetes 등 클라우드 배포를 위한 스크립트와 문서는 GitHub에서 공개되어 있습니다[3].
→ 이 리포지토리는 PE의 배포 자동화, 설정 등 인프라 관련 코드만 포함하며, ThingsBoard PE의 핵심 소스코드는 포함하지 않습니다.

4. Community Edition(CE)과의 차이

Edition	소스코드 공개	주요 차별점	확장성
Community Edition (CE)	O	기본 IoT 기능, 오픈소스	직접 소스 수정 가능
Professional Edition(PE)	X	고급 RBAC, 스케줄러, 리포팅 등 추가	공식 확장만 가능

5. 참고 사항

PE의 모바일 앱(Flutter 기반)은 오픈소스로 제공되지만, 서버 코어는 아닙니다[7].
PE의 각종 가이드, API 문서, 배포 가이드 등은 공식 홈페이지에서 확인할 수 있습니다[4][5][8].

결론:
ThingsBoard Professional Edition(PE)의 서버 소스코드는 공개되어 있지 않으며, 직접 수정이 불가능합니다.
커스터마이징이 필요하다면 공식적으로 제공하는 확장 포인트(Integration, Rule Node, Widget 등)를 활용해야 하며, 오픈소스가 필요한 경우 Community Edition(CE)을 사용해야 합니다.

Citations

[1]
[2]
[3]
[4]
[5]
[7]
[8]

사용 모델: Perplexity (2024-07-01)
답변 생성 시각: 2025-07-01 17:08 KST
토큰 수: 약 1,000 tokens

[1] https://github.com/thingsboard/thingsboard.github.io/blob/master/products/thingsboard-pe/index.md [2] https://stackoverflow.com/questions/71923192/thingsboard-service-how-do-i-change-the-source-code [3] https://github.com/thingsboard/thingsboard-pe-k8s [4] https://thingsboard.io/docs/pe/ [5] https://thingsboard.io/docs/pe/guides/ [6] https://thingsboard.io [7] https://thingsboard.io/products/mobile-pe/ [8] https://thingsboard.io/docs/pe/reference/releases/ [9] https://thingsboard.io/docs/pe/devices-library/ [10] https://thingsboard.io/docs/user-guide/install/building-from-source/

대기중: 소스코드 빌드 프론트엔드 별도 분리

Thingsboard Pe Edition Source Code 소스코드 백엔드 빌드 프론트엔드

(Thingsboard Pe Edition Source Code 소스코드 백엔드 빌드 프론트엔드, n.d.)

Building from Sources

(thingsboard, n.d.—a)

thingsboard

Building ThingsBoard IoT platform from sources

> thingsboard@4.2.0 start
> node --max_old_space_size=8048 ./node_modules/@angular/cli/bin/ng serve --configuration development --host 0.0.0.0 --open
 
 
Warning: This is a simple server for use in testing or debugging Angular applications
locally. It hasn't been reviewed for security issues.
 
Binding this server to an open connection can result in compromising your application or
computer. Using a different host than the one passed to the "--host" flag might result in
websocket connection issues. You might need to use "--disable-host-check" if that's the
case.
 
 
warn - You have enabled experimental features: optimizeUniversalDefaults
warn - Experimental features in Tailwind CSS are not covered by semver, may introduce breaking changes, and can change at any time.
Initial chunk files                 | Names                   |  Raw size
chunk-QG7K4YEH.js                   | -                       |   4.39 MB |
main.js                             | main                    | 600.00 kB |
styles.css                          | styles                  | 564.72 kB |
chunk-BUENTTSA.js                   | -                       | 359.89 kB |
polyfills.js                        | polyfills               | 230.87 kB |
scripts.js                          | scripts                 | 189.76 kB |
chunk-FIN6XRPE.js                   | -                       |  78.03 kB |
chunk-BMNQUJB7.js                   | -                       |  43.74 kB |
chunk-OXJS36M5.js                   | -                       |  36.80 kB |
chunk-KR2AHMDB.js                   | -                       |   2.91 kB |
chunk-NKZWBFNG.js                   | -                       |   2.62 kB |
 
                                    | Initial total           |   6.50 MB
 
Lazy chunk files                    | Names                   |  Raw size
chunk-6ILQA6BL.js                   | -                       |  15.63 MB |
home-pages.module-GNPMK5ZL.js       | home-pages-module       |   2.82 MB |
rulechain-page.module-LJYQLH34.js   | rulechain-page-module   |   1.25 MB |
chunk-3IXAOMZD.js                   | -                       | 223.87 kB |
chunk-J6LQEHAJ.js                   | -                       | 101.92 kB |
map-widget2-WRZ5HXCT.js             | map-widget2             |  95.90 kB |
chunk-W6E7QIIP.js                   | -                       |  92.64 kB |
chunk-JSLGJJQB.js                   | -                       |  53.38 kB |
chunk-7KJZRMQ6.js                   | -                       |  45.67 kB |
mode-tbel-D66MWVQJ.js               | mode-tbel               |  30.38 kB |
chunk-GLM67B5B.js                   | -                       |  28.44 kB |
chunk-AKXNNXW4.js                   | -                       |  24.63 kB |
chunk-OFJXGMM2.js                   | -                       |  22.49 kB |
custom-dashboard.module-NWA64JED.js | custom-dashboard-module |  11.58 kB |
digital-gauge-3VHFBU7M.js           | digital-gauge           |   9.79 kB |
...and 11 more lazy chunks files. Use "--verbose" to show all the files.
 
Application bundle generation complete. [40.028 seconds]
 
Watch mode enabled. Watching for file changes...
NOTE: Raw file sizes do not reflect development server per-request transformations.
  ➜  Local:   http://localhost:4200/
  ➜  Network: http://192.168.165.95:4200/
  ➜  Network: http://172.18.0.1:4200/
  ➜  press h + enter to show help
⠇ Changes detected. Rebuilding...                            Initial chunk files                 | Names                   |  Raw size
main.js                             | main                    | 600.00 kB |
 
Lazy chunk files                    | Names                   |  Raw size
chunk-QK54BTKW.js                   | -                       |  15.63 MB |
home-pages.module-UUJG7XJK.js       | home-pages-module       |   2.82 MB |
rulechain-page.module-EC6CM7IT.js   | rulechain-page-module   |   1.25 MB |
chunk-CFMMH2U5.js                   | -                       | 223.87 kB |
chunk-XX4UJKFZ.js                   | -                       |  92.64 kB |
custom-dashboard.module-CZWCI7EF.js | custom-dashboard-module |  11.58 kB |
dashboard-pages.module-XJJTJSHV.js  | dashboard-pages-module  |   6.03 kB |
 
Application bundle generation complete. [35.136 seconds]

junghanacs🧠