thingsboard通过网关

### ThingsBoard 网关集成配置教程

#### 一、概述
ThingsBoard IoT Gateway 是一个开源解决方案，旨在将连接到传统和第三方系统的设备与 ThingsBoard 集成[^1]。该网关提供了多种协议的支持，如 OPC-UA、MQTT、Modbus、CAN bus、BACnet、BLE、ODBC 和 REST 协议，从而能够适应不同的应用场景。

#### 二、环境准备
在开始之前，请确认已经成功部署了 ThingsBoard 平台以及目标通信协议所需的硬件或软件环境。对于特定场景下的安装指南，例如 Raspberry Pi4 上 Zigbee2MQTT 的安装方法已有专门文档提供指导[^4]。

#### 三、下载并安装 ThingsBoard Gateway
前往官方 GitHub 页面获取最新版本的 ThingsBoard Gateway 源码包或者预编译二进制文件，并按照说明完成本地安装过程。如果是在 Linux 或 MacOS 下操作，则可以通过 pip 工具简化此步骤：

pip install thingsboard-gateway

#### 四、创建配置文件
根据实际需求选择合适的连接器类型，在 `config` 文件夹下新建对应的 JSON 格式的配置文件。以 MQTT 连接为例，需编辑如下字段：
- **broker**: 设置消息代理服务器地址；
- **port**: 指定端口号，默认为 1883；
- **username/password**: 如果启用了认证机制则填写相应凭证信息；

示例代码片段展示了一个简单的 MQTT Connector 配置方式:

{
    "name": "mqtt_example",
    "type": "mqtt",
    "configuration": {
        "broker": "tcp://localhost:1883",
        "mapping": [
            {
                "topicFilter": "#",
                "converter": {
                    "type": "json"
                }
            }
        ]
    }
}

#### 五、启动服务并与 ThingsBoard 后端建立联系
当所有前置工作完成后即可尝试首次运行程序。通常情况下只需执行命令行指令即可轻松实现这一点：

tb-gateway start

此时应能看到日志输出表明客户端已成功订阅主题并向远端推送数据流至 ThingsBoard 实例中去处理分析。

#### 六、验证功能有效性
最后一步是要确保整个链路畅通无阻——即从物理层面上的数据采集直至最终呈现在 Web UI 中间没有任何障碍存在。为此建议先手动发送几条测试性质的消息给指定 topic ，观察其能否被正确解析入库显示出来。