thingsboard/tbmq-node

TBMQ Docker镜像文档

镜像概述和主要用途

TBMQ是ThingsBoard旗下开发并分发的开源工业级MQTT broker，旨在提供可靠的MQTT客户端连接、消息发布及订阅者间消息分发能力。本Docker镜像支持TBMQ的单体部署与集群部署，为用户提供便捷、灵活的部署方案，适用于各类需要高效MQTT消息传递的场景。

核心功能和特性

• 开源工业级：基于开源协议分发，具备工业级稳定性与可靠性，满足生产环境对消息传递的高要求。
• MQTT协议支持：全面兼容MQTT协议，实现客户端与broker间的高效通信，支持消息发布、订阅及多订阅者间的消息分发。
• 部署模式灵活：同时支持单体部署（适用于中小型应用）和集群部署（适用于大规模、高可用性需求场景）。
• ThingsBoard生态集成：作为ThingsBoard生态体系的一部分，可与ThingsBoard平台无缝协同，拓展IoT应用能力。

使用场景和适用范围

使用场景

• IoT设备通信：连接各类IoT终端设备，实现设备间、设备与平台的实时消息交互。
• 工业自动化：用于工业环境中的设备状态监控、实时数据采集及控制指令传输。
• 实时数据传输：适用于需要低延迟、高可靠消息传递的场景，如智能家居、智慧城市、远程监控等。

适用范围

• 中小型应用：通过单体部署满足基础MQTT消息传递需求，部署简单、资源占用低。
• 大型分布式系统：通过集群部署提升系统可用性与吞吐量，支持大规模设备接入与高并发消息处理。

详细使用方法和配置说明

文档资源

TBMQ完整文档托管于https://thingsboard.io/products/mqtt-broker/%EF%BC%8C%E5%8C%85%E5%90%AB%E6%9C%80%E6%96%B0%E5%8A%9F%E8%83%BD%E8%AF%B4%E6%98%8E%E4%B8%8E%E4%BD%BF%E7%94%A8%E6%8C%87%E5%8D%97%E3%80%82

安装与部署

部署TBMQ前，可参考官方安装指南获取详细步骤：https://thingsboard.io/docs/mqtt-broker/install/installation-options/%E3%80%82

架构与性能

有关TBMQ的架构设计及性能测试详情，可访问：https://thingsboard.io/docs/mqtt-broker/architecture/%E3%80%82

部署示例

单体部署（基础示例）

bash
docker run -d --name tbmq-monolithic -p 1883:1883 -p 8883:8883 docker.xuanyuan.run/thingsboard/tbmq:latest

注：上述命令映射MQTT标准端口（1883为TCP端口，8883为SSL端口），实际部署时需根据需求调整端口映射及资源配置。

集群部署

集群部署需根据节点数量、网络配置等进行个性化设置，详细步骤及配置说明请参考官方集群部署文档。

注意事项

• 部署前确保Docker环境已正确安装并运行，根据部署模式（单体/集群）分配足够的CPU、内存资源。
• 网络配置需开放必要端口（如MQTT端口1883/8883），并根据安全需求配置防火墙规则。
• 高级配置（如消息持久化、权限控制等）请查阅官方文档获取最新参数说明。