ThingsBoard三阶段部署指南：从测试到生产的完整实践路径

引言

在物联网（IoT）项目开发过程中，选择合适的部署方式是确保系统稳定运行的关键一步。本文将以场景驱动的方式，引导您完成ThingsBoard从快速体验到生产部署再到定制开发的全流程。无论您是初学者还是有经验的开发者，都能从中找到适合自己需求的部署方案。

第一阶段：快速体验——3分钟启动测试环境

环境评估

适用场景：功能验证、演示环境、短期测试 硬件要求：2核CPU、4GB内存、20GB硬盘 预计部署时间：5-10分钟

决策流程图

是否需要快速验证功能？→ 是 → 选择Docker容器部署 → 否 → 考虑生产部署或定制开发

实施步骤

🔧 安装Docker环境

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

原理卡片：Docker通过容器化技术，将应用及其依赖打包成标准化单元，实现环境一致性和快速部署。Docker Compose则用于定义和运行多容器Docker应用。

🔧 获取项目代码

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

🔧 初始化日志目录

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

原理卡片：日志目录初始化确保容器有适当的权限写入日志，避免因权限问题导致服务启动失败。

🔧 启动服务

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

原理卡片：--loadDemo参数会在数据库中预置演示数据，包括设备、仪表板和规则链，便于快速体验系统功能。

验证方法

打开浏览器访问http://localhost:8080，使用默认账号[e-mail]/sysadmin登录。成功登录后，您将看到ThingsBoard的主界面，包含演示仪表板和设备数据。

进度检查点

1. 成功启动Docker容器并访问Web界面
2. 使用默认账号登录系统
3. 查看演示仪表板中的示例数据

第二阶段：生产部署——构建稳定可靠的物联网平台

环境评估

适用场景：生产环境、长期运行、业务系统 硬件要求：4核CPU、8GB内存、40GB SSD 预计部署时间：15-20分钟

决策流程图

是否需要高可用性？→ 是 → 考虑集群部署 → 否 → 选择单节点二进制部署 是否需要自定义配置？→ 是 → 修改配置文件 → 否 → 使用默认配置

实施步骤

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

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

原理卡片：二进制包包含预编译的应用程序和依赖，避免了源码编译的时间和资源消耗，适合生产环境快速部署。

🔧 执行安装

# Linux系统
sudo ./thingsboard-3.4.0.deb install

🔧 配置数据库 编辑配置文件，选择PostgreSQL或Cassandra数据库：

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

原理卡片：ThingsBoard支持多种数据库，PostgreSQL适合中小规模部署，Cassandra则适用于大规模分布式场景。正确配置数据库连接是系统稳定运行的基础。

🔧 启动服务

# Linux系统
sudo systemctl start thingsboard

验证方法

检查服务状态：

sudo systemctl status thingsboard

若显示"active (running)"，则表示服务启动成功。访问http://服务器IP:8080，使用管理员账号登录，验证系统功能是否正常。

进度检查点

1. 服务成功启动并保持运行状态
2. 数据库连接正常，无错误日志
3. 系统功能完整，无异常报错

第三阶段：定制开发——打造专属物联网解决方案

环境评估

适用场景：二次开发、功能定制、企业级应用 硬件要求：8核CPU、16GB内存、100GB SSD 预计部署时间：30-60分钟

决策流程图

是否需要修改核心功能？→ 是 → 修改源码并重新编译 → 否 → 使用插件扩展 是否需要前端定制？→ 是 → 修改UI代码 → 否 → 仅后端开发

实施步骤

🔧 环境准备

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

原理卡片：JDK是Java应用开发的基础，Maven用于项目构建和依赖管理，确保开发环境的一致性。

🔧 获取代码并编译

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

原理卡片：Maven通过pom.xml文件管理项目依赖和构建流程，-DskipTests参数可以跳过测试阶段，加快编译速度。

🔧 配置数据库

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

编辑thingsboard.yml文件，配置数据库连接和其他参数。

🔧 启动服务

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

验证方法

查看启动日志：

tail -f logs/thingsboard.log

确认服务启动成功后，访问Web界面，测试自定义功能是否正常工作。

进度检查点

1. 源码编译成功，无错误输出
2. 自定义功能按预期工作
3. 系统性能满足设计要求

维护与优化指南

问题-解决方案对照

问题：服务启动失败 解决方案：检查日志文件，确认数据库连接和端口占用情况。

问题：系统响应缓慢 解决方案：优化JVM参数，增加内存分配。编辑配置文件：

JAVA_OPTS=-Xms2g -Xmx4g  # 根据服务器配置调整

问题：数据库连接数不足 解决方案：调整数据库连接池配置，增加最大连接数。

症状-病因-处方

症状：Web界面无法访问 病因：可能是服务未启动或端口被占用 处方：检查服务状态，确认端口占用情况，重启服务或修改端口配置

症状：设备连接失败 病因：可能是传输服务未启动或防火墙阻止 处方：检查传输服务状态，确认防火墙规则，确保设备可以访问服务器端口

症状：数据查询缓慢 病因：可能是数据库索引不足或查询语句优化不够 处方：添加适当的数据库索引，优化查询语句

部署资源计算器

根据设备数量估算服务器配置：

• 设备数量 < 1000：2核CPU，4GB内存，50GB存储
• 1000 ≤ 设备数量 < 10000：4核CPU，8GB内存，100GB存储
• 10000 ≤ 设备数量 < 100000：8核CPU，16GB内存，200GB存储
• 设备数量 ≥ 100000：考虑分布式部署，16核CPU，32GB内存，500GB存储

计算公式：内存需求 = 基础内存(4GB) + 设备数量 * 0.004GB

自动化脚本获取路径

• Docker部署脚本：项目根目录/docker/
• 二进制包生成脚本：项目根目录/packaging/java/scripts/
• 服务控制脚本：项目根目录/packaging/java/scripts/control/

部署后必做的5项安全配置

1. 修改默认管理员密码，使用强密码策略
2. 配置HTTPS，加密传输数据
3. 限制数据库访问权限，仅允许应用服务器连接
4. 开启审计日志，记录关键操作
5. 定期备份数据库，防止数据丢失

结语

本文详细介绍了ThingsBoard的三种部署方式，从快速体验到生产部署再到定制开发，涵盖了不同场景下的需求。通过场景驱动的方式，帮助您选择最适合的部署方案，并提供了实用的维护和优化建议。无论您是初学者还是有经验的开发者，都能通过本文快速掌握ThingsBoard的部署技巧，构建稳定可靠的物联网平台。

图：ThingsBoard告警部件示例，显示实时告警信息