ThingsBoard 快速上手从克隆到第一块监控面板的实战指南【免费下载链接】thingsboardOpen-source IoT Platform - Device management, data collection, processing and visualization.项目地址: https://gitcode.com/GitHub_Trending/th/thingsboardThingsBoard 是一个开源的 IoT 平台一次性解决设备接入、数据收集、规则处理和可视化这整条链路的问题。这篇文章的目标很直接先让它跑起来再按你实际要干的三件事——把数据接进来、让规则引擎处理、把面板搭出来——逐一说清楚。跑起来Docker 一条命令拉起完整集群ThingsBoard 的 Docker Compose 部署默认就是一套微服务集群两个核心节点tb-core1/tb-core2、两个规则引擎节点、两套 MQTT/HTTP 传输、两套 Web UI外加 ZooKeeper 和 JS 脚本执行器定义都在 docker/docker-compose.yml 里。你不需要逐个理解它们装完能登录就行。克隆仓库并执行安装脚本git clone https://gitcode.com/GitHub_Trending/th/thingsboard cd thingsboard/docker ./docker-install-tb.sh --loadDemo--loadDemo会额外加载演示数据示例设备、面板、规则链建议第一次就带上后面看面板时有东西可看。⚠️ 如果脚本提示权限问题先执行一次./docker-create-log-folders.sh它会为各服务创建日志目录并改属主需要 sudo。数据库和缓存类型在 docker/.env 里选DATABASEpostgres默认或hybrid实体数据走 PostgreSQL、时序数据走 CassandraCACHE可选 valkey 单机/集群/sentinel 三种模式。改完再跑安装脚本即可。看到登录页就算成功浏览器打开http://localhost出现 ThingsBoard 登录页说明集群就绪。默认账号系统管理员sysadminthingsboard.org/sysadmin租户管理员带 demo 数据时tenantthingsboard.org/tenant用租户账号登录后你能看到 demo 设备、现成的仪表盘和默认规则链可以直接进入下一节动手。核心能力拆解接入、处理、可视化用 MQTT 把传感器数据推上来MQTT 是最常用的接入方式连接地址localhost:1883用户名填设备 Access Token在 设备 → 选中某设备 → Credentials 标签页里拿到Token 就是认证凭证密码不用管。最小 payload 就是一个 JSON 对象发往主题v1/devices/me/telemetryimport paho.mqtt.client as mqtt import json ACCESS_TOKEN 从设备Credentials页复制的Token client mqtt.Client() client.username_pw_set(ACCESS_TOKEN) client.connect(localhost, 1883, 60) telemetry {temperature: 25.5, humidity: 60, pressure: 1013} client.publish(v1/devices/me/telemetry, json.dumps(telemetry))发完之后不用做任何配置设备详情页的 Telemetry 标签下立刻能看到这三条数据——传输层收到后直接入库这是 ThingsBoard 的默认行为。仓库里 tools/src/main/python/mqtt-send-telemetry.py 有一个可运行的类似脚本可参考。 其他协议也各占一个端口HTTP 是 8081POSThttp://host:8081/api/token/telemetryCoAP/LWM2M/SNMP 见文末端口表认证方式类似。给遥测数据挂一条告警规则链设备数据进来后默认落库但温度过高就报警这类逻辑要交给规则引擎。每个租户自带一条 Default 规则链新设备的所有遥测、属性更新、连接事件都会先经过它。典型做法是在规则链编辑器里往链路上加两个节点Filter / 脚本节点判断temperature 30Alarm 节点满足条件时创建一条 Alarm再往下接 Email/SMS 等通知节点。规则节点之间的连线用success/failure两条出口表达分支下图是规则节点编辑器的实际界面每个节点右侧能看到输入字段的映射 写过滤逻辑时遥测值取msg.temperature这种字段路径来自消息体实体属性用device.temperature前缀区分。调试时开着规则链编辑器底部的日志面板每条消息走到哪个节点都看得到比自己猜快得多。三步搭出第一块监控面板数据已经在库里了把它画出来只需三步新建 DashboardDashboard 菜单 → 新建命名如设备监控加 Widget拖入 Chart曲线图或 Latest Value最新值卡片数据源选刚才那台设备key 填temperature、humidity保存曲线开始实时刷新再配一个 Alarm Widget 把告警状态也摆上桌面。仓库帮助文档里有一批 Widget 示例图比如告警类 Widget 长这样如果不想从零搭租户界面里的 Solution Templates 有智能能源、车队跟踪等现成模板导入后把设备绑定换掉就能用。生产要点与延伸关键配置文件作用docker/tb-node/conf/thingsboard.conf核心/规则引擎节点主配置数据库、队列、gRPCdocker/tb-transports/mqtt/conf/tb-mqtt-transport.confMQTT 传输层配置端口、TLS、并发docker/.env数据库/缓存类型、镜像仓库、版本docker/haproxy/config/haproxy.cfg负载均衡Web/HTTP 传输/API 统一从 80 端口进docker/README.md部署、启停脚本、监控Prometheus/Grafana说明常用端口协议端口传输层Web / REST API80haproxy/ 8080直连TCPMQTT1883TCPHTTP 设备接入8081直连/ 80经 haproxyTCPCoAP5683UDPLWM2M5685 / 5686UDPSNMP1620UDPEdge RPC7070TCP日志位置各服务日志映射到宿主机核心节点在docker/tb-node/log容器内/var/log/thingsboardMQTT 传输在docker/tb-transports/mqtt/log格式由各自的logback.xml控制。快速排查用docker-compose logs -f tb-core1 tb-mqtt-transport1。下一步方向换hybrid数据库 Kafka 队列docker/docker-compose.kafka.yml把时序写入和解耦处理撑到生产量级上 Prometheus Grafana 监控集群自身docker/monitoring/评估 Edge 网关模式把部分规则下放到远端节点到这里日常接入一台设备、配一条告警、看一块面板的路径就齐了再深的集群调优和 Edge 部署翻 docker/README.md 和官方文档即可。许可证LICENSEApache 2.0。【免费下载链接】thingsboardOpen-source IoT Platform - Device management, data collection, processing and visualization.项目地址: https://gitcode.com/GitHub_Trending/th/thingsboard创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考