超详细ThingsBoard部署教程：3种安装方式对比与避坑指南

超详细ThingsBoard部署教程：3种安装方式对比与避坑指南

【免费下载链接】thingsboard Open-source IoT Platform - Device management, data collection, processing and visualization. 项目地址: https://gitcode.com/GitHub_Trending/th/thingsboard

你还在为IoT平台部署繁琐而头疼？本文将详细对比Docker、二进制包和源码编译三种安装方式，帮你快速搭建ThingsBoard环境，避开90%的常见问题。读完本文你将获得：三种部署方式的完整步骤、优缺点分析、性能对比表以及实用避坑指南。

部署方式对比概览

部署方式	难度	适用场景	部署时间	灵活性	维护成本
Docker容器	★☆☆☆☆	快速测试、演示环境	5-10分钟	中	低
二进制包	★★☆☆☆	生产环境、物理服务器	10-15分钟	低	中
源码编译	★★★★☆	二次开发、定制需求	30-60分钟	高	高

环境准备要求

• 最低配置：2核CPU/4GB内存/20GB硬盘
• 推荐配置：4核CPU/8GB内存/40GB SSD
• 操作系统：Linux(Ubuntu 20.04+/CentOS 8+)、Windows 10/11、macOS 12+

Docker容器部署（推荐新手）

Docker部署是最简单快捷的方式，适合快速上手和演示环境。ThingsBoard提供了完整的Docker Compose配置，支持一键启动微服务架构。

部署步骤

1. 安装Docker环境

   # Ubuntu系统
   sudo apt update && sudo apt install docker.io docker-compose -y
   sudo systemctl enable docker && sudo systemctl start docker
   

2. 获取项目代码

   git clone https://gitcode.com/GitHub_Trending/th/thingsboard
   cd thingsboard
   

3. 初始化日志目录

   cd docker
   ./docker-create-log-folders.sh  # 创建日志目录并设置权限
   

4. 启动服务

   ./docker-install-tb.sh --loadDemo  # --loadDemo参数会加载演示数据
   ./docker-start-services.sh
   

5. 访问验证 打开浏览器访问http://localhost:8080，使用默认账号sysadmin@thingsboard.org/sysadmin登录。

核心配置文件说明

• docker-compose.yml：定义服务组合，包含核心服务、规则引擎和传输服务
• tb-node.env：节点配置，可修改JVM参数和数据库连接
• docker-start-services.sh：服务启动脚本

维护命令

# 查看日志
docker-compose logs -f tb-core1 tb-rule-engine1

# 停止服务
./docker-stop-services.sh

# 更新服务
./docker-update-service.sh tb-core

二进制包部署（生产首选）

二进制包部署适合生产环境，具有较好的性能和稳定性。ThingsBoard提供了预编译的安装包，支持Linux、Windows和macOS系统。

部署步骤

1. 下载安装包 从ThingsBoard官方网站下载对应版本的二进制包，或通过项目脚本生成：

   cd packaging/java/scripts
   ./install  # 生成Linux安装包
   

2. 执行安装

   # Linux系统
   sudo ./thingsboard-3.4.0.deb install
   
   # Windows系统
   thingsboard-windows.zip解压后运行install.bat
   

3. 配置数据库 编辑配置文件thingsboard.yml，选择PostgreSQL或Cassandra数据库：

   spring:
     datasource:
       driverClassName: org.postgresql.Driver
       url: jdbc:postgresql://localhost:5432/thingsboard
   

4. 启动服务

   # Linux系统
   sudo systemctl start thingsboard
   
   # Windows系统
   net start thingsboard
   

服务控制脚本

• packaging/java/scripts/control：Linux服务控制脚本
• packaging/java/scripts/windows：Windows服务配置

源码编译部署（开发定制）

源码编译适合需要二次开发或定制功能的场景，需要本地安装Maven和JDK环境。

编译步骤

1. 环境准备

   # 安装JDK 17和Maven
   sudo apt install openjdk-17-jdk maven -y
   

2. 获取代码并编译

   git clone https://gitcode.com/GitHub_Trending/th/thingsboard
   cd thingsboard
   mvn clean install -DskipTests  # 跳过测试加速编译
   

3. 配置数据库

   cd application/src/main/resources
   cp thingsboard.yml.dist thingsboard.yml
   

4. 启动服务

   cd application/target/bin
   ./thingsboard.sh start
   

编译配置说明

根目录的pom.xml定义了项目依赖和模块结构，核心模块包括：

• common：公共工具类
• dao：数据访问层
• transport：设备连接传输层
• ui-ngx：Web前端界面

避坑指南与最佳实践

常见问题解决

1. 端口冲突

   • 修改docker-compose.yml中的端口映射：

     ports:
       - "8081:8080"  # 将8080端口映射到主机8081端口
     

2. 数据库连接失败

   • 检查数据库服务是否启动
   • 验证数据库用户权限：

     GRANT ALL PRIVILEGES ON DATABASE thingsboard TO thingsboard;
     

3. 内存不足

   • 调整JVM参数，编辑tb-node.env：

     JAVA_OPTS=-Xms512m -Xmx1024m  # 根据服务器配置调整
     

性能优化建议

1. 生产环境配置

   • 使用PostgreSQL集群或Cassandra分布式数据库
   • 启用缓存：cache-valkey.env
   • 配置负载均衡：haproxy/config

2. 监控与告警 启用Prometheus和Grafana监控：

   docker-compose -f docker-compose.prometheus-grafana.yml up -d
   

   访问Grafana面板http://localhost:3000，查看系统指标。

部署架构选择建议

根据业务规模选择合适的部署架构：

• 小型应用：单节点Docker部署，使用内置H2数据库
• 中型应用：Docker Compose部署，PostgreSQL数据库+Valkey缓存
• 大型应用：Kubernetes集群部署，微服务架构+分布式数据库

总结与展望

本文详细介绍了三种ThingsBoard部署方式，Docker适合快速上手，二进制包是生产首选，源码编译适合定制开发。建议根据实际需求选择合适的部署方式，并参考避坑指南解决常见问题。后续可以关注ThingsBoard的规则引擎和设备管理功能，实现更复杂的IoT场景。

点赞+收藏本文，下次部署ThingsBoard不迷路！如有疑问，欢迎在评论区留言讨论。

【免费下载链接】thingsboard Open-source IoT Platform - Device management, data collection, processing and visualization. 项目地址: https://gitcode.com/GitHub_Trending/th/thingsboard