Thingsboard物联网平台Docker化部署与定制化实践-代码聚汇网

Thingsboard物联网平台Docker化部署与定制化实践

ThingsboardDocker部署物联网平台

|难度：普通|阅读约 13 分钟

1. Thingsboard物联网平台Docker化部署背景

作为一款开源的物联网平台，Thingsboard凭借其强大的设备管理、数据可视化和规则引擎功能，在智能家居、工业物联网等领域广泛应用。传统部署方式需要手动配置Java环境、数据库依赖，而Docker容器化部署方案能显著降低环境复杂度。我在实际项目中发现，当需要运行定制化jar包时，标准的Docker镜像往往无法满足需求，这就需要我们掌握自定义构建的技巧。

需要模型API调用？免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。

2. 基础环境准备

2.1 系统要求确认

推荐使用Ubuntu 20.04/22.04 LTS或CentOS 7+系统，确保：

内存≥4GB（生产环境建议8GB+）
存储空间≥10GB
已安装Docker 20.10+和Docker Compose 2.0+

重要提示：避免使用Windows系统进行生产部署，WSL2可能存在性能损耗

2.2 Docker环境配置

bash复制# 卸载旧版本
sudo apt-get remove docker docker-engine docker.io containerd runc

# 安装依赖
sudo apt-get update
sudo apt-get install \
    ca-certificates \
    curl \
    gnupg \
    lsb-release

# 添加Docker官方GPG密钥
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

# 设置稳定版仓库
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# 安装Docker引擎
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin

# 验证安装
sudo docker run hello-world

3. 定制化Jar包处理

3.1 获取基础代码

建议从GitHub克隆官方仓库：

bash复制git clone https://github.com/thingsboard/thingsboard.git
cd thingsboard

3.2 修改源码关键点

常见定制需求包括：

协议扩展（如BACnet支持）
自定义认证逻辑
数据持久化策略修改
规则节点开发

修改后使用Maven打包：

bash复制mvn clean install -DskipTests

生成的jar包位于：

code复制application/target/thingsboard-3.4.4-boot.jar

4. Docker镜像定制方案

4.1 基础镜像选择

推荐使用官方的thingsboard/tb-postgres作为基础镜像，通过Dockerfile扩展：

dockerfile复制FROM thingsboard/tb-postgres:3.4.0

# 替换为定制jar包
COPY ./thingsboard-3.4.4-boot.jar /usr/share/thingsboard/bin/thingsboard.jar

# 修改启动参数（示例）
ENV SPRING_JPA_PROPERTIES_HIBERNATE_DIALECT=org.hibernate.dialect.PostgreSQLDialect

4.2 多阶段构建优化

对于生产环境，建议采用多阶段构建减小镜像体积：

dockerfile复制# 构建阶段
FROM maven:3.8.6-openjdk-11 AS builder
WORKDIR /app
COPY . .
RUN mvn clean package -DskipTests

# 运行阶段
FROM thingsboard/tb-postgres:3.4.0
COPY --from=builder /app/application/target/thingsboard-*.jar /usr/share/thingsboard/bin/thingsboard.jar

5. 容器编排部署

5.1 docker-compose.yml配置

yaml复制version: '3.0'
services:
  tb:
    image: your-custom-tb-image:latest
    restart: always
    ports:
      - "8080:9090"
      - "1883:1883"
      - "5683:5683/udp"
    environment:
      TB_QUEUE_TYPE=in-memory
      SPRING_DATASOURCE_URL=jdbc:postgresql://postgres:5432/thingsboard
    depends_on:
      - postgres

  postgres:
    image: postgres:13
    restart: always
    environment:
      POSTGRES_DB: thingsboard
      POSTGRES_PASSWORD: postgres
    volumes:
      - pgdata:/var/lib/postgresql/data

volumes:
  pgdata:

5.2 数据库优化建议

对于高负载场景：

将PostgreSQL替换为Cassandra集群
添加Redis缓存层
配置独立的TB_QUEUE服务（Kafka/RabbitMQ）

6. 运维监控方案

6.1 健康检查配置

在docker-compose中增加：

yaml复制healthcheck:
  test: ["CMD", "curl", "-f", "http://localhost:8080/api/v1/health"]
  interval: 30s
  timeout: 10s
  retries: 3

6.2 日志管理

推荐配置：

bash复制docker logs -f tb  # 实时查看日志
docker exec -it tb grep "ERROR" /var/log/thingsboard/thingsboard.log  # 错误检索

7. 常见问题排查

7.1 启动失败排查步骤

检查端口冲突：

bash复制netstat -tulnp | grep 8080

验证数据库连接：

bash复制docker exec -it postgres psql -U postgres -d thingsboard

查看JVM参数：

bash复制docker exec tb java -XX:+PrintFlagsFinal -version | grep -i heap

7.2 性能优化参数

在环境变量中添加：

yaml复制environment:
  JAVA_OPTS: "-Xms2g -Xmx2g -XX:+UseG1GC"
  TB_SERVER_REST_MAX_MEMORY: "4096"
  TB_SERVER_REST_MIN_MEMORY: "512"

8. 安全加固措施

修改默认管理员账号(tenant@thingsboard.org)密码
启用HTTPS：

bash复制openssl req -newkey rsa:2048 -nodes -keyout key.pem -x509 -days 365 -out cert.pem

配置防火墙规则：

bash复制ufw allow 8080/tcp
ufw allow 1883/tcp

9. 版本升级策略

备份数据库：

bash复制docker exec postgres pg_dump -U postgres thingsboard > backup.sql

测试环境验证
滚动更新：

bash复制docker-compose pull
docker-compose up -d

10. 扩展开发建议

自定义Widget开发：

javascript复制self.onInit = function() {
    // 自定义逻辑
}

规则链插件开发：

java复制@RuleNode(
    type = ComponentType.ACTION,
    name = "custom-plugin",
    configClazz = CustomConfig.class
)
public class CustomNode implements TbNode {
    // 实现逻辑
}

我在实际部署中发现，当使用定制jar包时，务必保持与原版相同的目录结构。曾遇到因缺少/var/lib/thingsboard目录导致设备影子数据丢失的情况。建议在Dockerfile中显式创建所有必要目录：

dockerfile复制RUN mkdir -p /var/lib/thingsboard \
    && chown -R thingsboard:thingsboard /var/lib/thingsboard