分享｜五分钟学会 ThingsBoard 本地编译运行和 Linux 部署

ThingsBoard 是一个强大的开源平台，可以简化设备连接、数据收集和可视化展示的过程。本文将指导你在五分钟内学会如何在本地编译运行 ThingsBoard，并在 Linux 环境中进行部署。

本地部署

准备条件

ThingsBoard 服务在 Java 11 上运行。您可以使用以下命令检查安装情况：

java -version

源码下载

源码地址：https://github.com/thingsboard/thingsboard.git

git clone https://github.com/thingsboard/thingsboard.git

在源码根目录找到pom.xml，查找license-maven-plugin，如下图，注释掉整个plugin。

编译

注意！！！有时因为各种奇怪原因导致编译失败，这时可以删除本地的 maven 仓库重新下载依赖

cd thingsboard
mvn clean install -DskipTests

项目运行

修改thingsboard.yml中数据库相关配置，替换用户名密码。

将dao模块下，sql文件拷贝至application模块data/sql目录中

运行 ThingsboardInstallApplication，完成thingsboard表结构和数据的初始化。默认情况下，使用系统管理员sysadmin@thingsboard.org，sysadmin进行登录。当然，初始化用户可以在配置文件中自定义。

接着运行ThingsboardServerApplication，访问http://localhost:8080/ 自动跳转至登录页面

Linux 部署

安装 Java 11

sudo apt update
sudo apt install openjdk-11-jdk

ThingsBoard 服务安装

将编译好的二进制文件上传至 Linux

scp /Users/bijw/devel/thingsboard/application/target/thingsboard.deb pi@linux ip:

将 ThingsBoard 安装为服务

sudo dpkg -i thingsboard.deb

配置 ThingsBoard 数据库

PostgreSQL 安装

# install **wget** if not already installed:
sudo apt install -y wget

# import the repository signing key:
wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo apt-key add -

# add repository contents to your system:
echo "deb https://apt.postgresql.org/pub/repos/apt/ $(lsb_release -cs)-pgdg main" | sudo tee  /etc/apt/sources.list.d/pgdg.list

# install and launch the postgresql service:
sudo apt update
sudo apt -y install postgresql-15
sudo service postgresql start

ThingsBoard 配置

编辑 ThingsBoard 配置文件

sudo nano /etc/thingsboard/conf/thingsboard.conf

将以下行添加到配置文件中。不要忘记将PUT_YOUR_POSTGRESQL_PASSWORD_HERE替换为您真实的 postgres 用户密码：

# DB Configuration
export DATABASE_TS_TYPE=sql
export SPRING_DATASOURCE_URL=jdbc:postgresql://localhost:5432/thingsboard
export SPRING_DATASOURCE_USERNAME=postgres
export SPRING_DATASOURCE_PASSWORD=PUT_YOUR_POSTGRESQL_PASSWORD_HERE
# Specify partitioning size for timestamp key-value storage. Allowed values: DAYS, MONTHS, YEARS, INDEFINITE.
export SQL_POSTGRES_TS_KV_PARTITIONING=MONTHS

运行安装脚本

安装 ThingsBoard 服务并更新数据库配置后，您可以执行以下脚本：

sudo /usr/share/thingsboard/bin/install/install.sh

启动 ThingsBoard 服务

sudo service thingsboard start

如何查看 thingsboard 运行日志？

tail -f /var/log/thingsboard/thingsboard.log

常见问题 FAQ

关于如何停止或卸载 thingsboard 服务

查看运行的所有服务

systemctl list-units --all --type=service

停止服务

systemctl service stop thingsboard

如果您想删除软件包本身（不带配置文件），则必须运行：

dpkg -r thingsboard

如果您想完全删除（清除）软件包（带有配置文件），则必须运行：

dpkg -P thingsboard

您可以检查包是否已成功删除 - 只需运行：

dpkg -l '*thingsboard*'

关于亿琪软件

亿琪软件

上海亿琪软件有限公司，全球开放边缘计算和物联网领域的领导者，全球领先的工业物联网软件开发商和解决方案提供商，助力企业和组织实现数字化转型。公司专注于 5G 通信、AI 人工智能、边缘计算和大数据网络安全多项技术领域，致力于物联网领域前沿技术的创新，为用户提供全方位、智能化和安全的物联网解决方案。

2023 年，公司发布“ YiFUSION ｜工业边缘智能融合网关 ”产品，为工业客户提供一整套的边缘计算+AI 能力：高性能数据采集、多类型数据融合、AI 算法集成、云端业务对接。在边缘网关的基础上，集成了 IoT 平台的边缘协同能力、本地 Web SCADA 和 HMI 功能、本地数据存储、边缘 AI 视频分析、行业应用集成等。
2022 年，公司推出 “ YiCLOUD ｜亿琪云 ”一站式物联网应用解决方案。公司的业务涵盖了智慧城市、智慧农业、智能工厂和智慧园区等多个领域，公司软硬件产品和解决方案获得华为技术认证，得到中国移动 OCP 认证，公司还是边缘计算产业联盟 ECC 成员。

关注我们

公司公众号	中文社区公众号

联系我们--商业服务

网站：http://yiqisoft.cn
邮件：support@yiqisoft.cn
电话：021-68863086
手机：186-1666-9123