xTag

Overview

Full name
docker.io/thingsboard/tb-mqtt-transport
Registry
docker.io
Namespace
thingsboard
Repository
tb-mqtt-transport
Cached tags
68
Last synced
07/06/2026, 02:56 PM
Topics
常用应用

Introduction

ThingsBoard MQTT 传输微服务镜像，接收设备 MQTT 消息并写入 Kafka/队列供 Core 消费，IoT 平台数据面组件，需与 tb-core 及消息中间件联部署。

Details

thingsboard/tb-mqtt-transport 是 ThingsBoard 3.x 微服务架构中的 MQTT 接入层，监听 1883/8883 处理设备 publish/subscribe，经 Kafka 或 RabbitMQ 转发至 tb-core。镜像无 UI，配置通过 env 或 tb-mqtt-transport.conf 指定 queue 与 Zookeeper/Kafka 地址。与 monolithic thingsboard 镜像不同——本镜像仅为传输层；生产应固定 tag、TLS 与设备认证，并与 tb-core、tb-rule-engine 版本对齐。

快速启动

docker run -d --name tb-mqtt-transport \
  -p 1883:1883 \
  -e TB_QUEUE_TYPE=kafka \
  -e TB_KAFKA_SERVERS=kafka:9092 \
  docker.io/thingsboard/tb-mqtt-transport:latest

推荐实践

docker run -d --name tb-mqtt-transport \
  --restart unless-stopped \
  -p 1883:1883 -p 8883:8883 \
  -e TB_QUEUE_TYPE=kafka \
  -e TB_KAFKA_SERVERS=kafka.internal:9092 \
  -e MQTT_BIND_ADDRESS=0.0.0.0 \
  -e MQTT_BIND_PORT=1883 \
  docker.io/thingsboard/tb-mqtt-transport:3.8.0

核心参数说明

  • -p 1883:1883 — MQTT 明文（内网）
  • -p 8883:8883 — MQTT over TLS
  • -e TB_KAFKA_SERVERS — 消息队列地址
  • -e TB_QUEUE_TYPE=kafka — 队列类型
  • -e MQTT_BIND_PORT — 监听端口
  • --restart unless-stopped — IoT 接入层持续在线

Kubernetes

apiVersion: apps/v1
kind: Deployment
metadata:
  name: tb-mqtt-transport
spec:
  replicas: 2
  selector:
    matchLabels:
      app: tb-mqtt-transport
  template:
    metadata:
      labels:
        app: tb-mqtt-transport
    spec:
      containers:
        - name: transport
          image: docker.io/thingsboard/tb-mqtt-transport:3.8.0
          ports:
            - containerPort: 1883
          env:
            - name: TB_KAFKA_SERVERS
              value: kafka:9092
---
apiVersion: v1
kind: Service
metadata:
  name: tb-mqtt-transport
spec:
  selector:
    app: tb-mqtt-transport
  ports:
    - port: 1883
      targetPort: 1883

Kafka 与 tb-core 独立 Deployment；LoadBalancer 暴露 1883 供设备接入，TLS 证书经 Secret。

Latest tags (20)

View all 68 tags →
TagArchPushed AtSizeDigestSyncWishAction
docker.io/thingsboard/tb-mqtt-transport
:4.3.1-latest
linux/amd64linux/arm64
2026/06/30 01:59470.5 MBsha256:12fc284328e7…
docker.io/thingsboard/tb-mqtt-transport
:4.3.1.3
linux/amd64linux/arm64
2026/06/30 01:59470.5 MBsha256:12fc284328e7…
docker.io/thingsboard/tb-mqtt-transport
:latest
linux/amd64linux/arm64
2026/06/30 01:58470.5 MBsha256:12fc284328e7…
docker.io/thingsboard/tb-mqtt-transport
:4.2.2-latest
linux/amd64linux/arm64
2026/06/29 23:57446.1 MBsha256:43b7234a25e3…
docker.io/thingsboard/tb-mqtt-transport
:4.2.2.3
linux/amd64linux/arm64
2026/06/29 23:57446.1 MBsha256:43b7234a25e3…
docker.io/thingsboard/tb-mqtt-transport
:4.3.1.2
linux/amd64linux/arm64
2026/05/29 04:04463.6 MBsha256:912fc986aba2…
docker.io/thingsboard/tb-mqtt-transport
:4.2.2.2
linux/amd64linux/arm64
2026/05/29 02:19440.8 MBsha256:7caa9faf27f8…
docker.io/thingsboard/tb-mqtt-transport
:4.3.1.1
linux/amd64linux/arm64
2026/03/31 02:25473.1 MBsha256:75ba764687d2…
docker.io/thingsboard/tb-mqtt-transport
:4.2.2.1
linux/amd64linux/arm64
2026/03/30 23:34438.1 MBsha256:705536452776…
docker.io/thingsboard/tb-mqtt-transport
:4.3.1
linux/amd64linux/arm64
2026/03/10 00:11461.0 MBsha256:a4d3c99a4b35…
docker.io/thingsboard/tb-mqtt-transport
:4.2.2
linux/amd64linux/arm64
2026/03/09 22:17437.1 MBsha256:e69458fb0e13…
docker.io/thingsboard/tb-mqtt-transport
:4.3.0-latest
linux/amd64linux/arm64
2026/02/03 18:58463.7 MBsha256:3869f2c1da3e…
docker.io/thingsboard/tb-mqtt-transport
:4.3.0.1
linux/amd64linux/arm64
2026/02/03 18:58463.7 MBsha256:3869f2c1da3e…
docker.io/thingsboard/tb-mqtt-transport
:4.2.1-latest
linux/amd64linux/arm64
2026/02/03 17:55437.0 MBsha256:3ab67326655a…
docker.io/thingsboard/tb-mqtt-transport
:4.2.1.2
linux/amd64linux/arm64
2026/02/03 17:55437.0 MBsha256:3ab67326655a…
docker.io/thingsboard/tb-mqtt-transport
:4.3.0
linux/amd64linux/arm64
2026/01/20 17:26460.9 MBsha256:301f12d9e551…
docker.io/thingsboard/tb-mqtt-transport
:4.2.1.1
linux/amd64linux/arm64
2025/12/23 21:51437.0 MBsha256:62fd9d677b5f…
docker.io/thingsboard/tb-mqtt-transport
:4.2.1
linux/amd64linux/arm64
2025/10/14 17:43433.9 MBsha256:e3ac18771994…
docker.io/thingsboard/tb-mqtt-transport
:4.2.0
linux/amd64linux/arm64
2025/08/15 16:57433.8 MBsha256:8876e3cf5985…
docker.io/thingsboard/tb-mqtt-transport
:4.1.0
linux/amd64linux/arm64
2025/07/03 18:39422.0 MBsha256:96416789e4a2…