06 thingsboard-ubuntu20-rk3588-连通性-测试 MQTT HTTP COAP
0. 前言
ThingsBoard作为轻量级物联网平台,租户管理员是承接「平台系统管理」与「终端设备对接」的核心角色,主要负责本租户下客户、设备的生命周期管理,以及设备与平台的通信验证。本次测试基于已部署在RK3588(Ubuntu 20.04 ARM64)环境的ThingsBoard 4.3平台,以租户管理员视角,遵循「创建客户→创建设备→多协议数据上报」的实际运维流程,对设备与平台的连通性展开全面验证。
测试聚焦IoT场景主流的HTTP、MQTT、CoAP三种接入协议,通过平台官方预置的测试指令,在服务器本地完成数据上报测试,既规避了跨网络节点的干扰,也最大程度贴近租户管理员日常的设备接入调试场景。本次测试的核心目标是验证租户侧设备接入的全流程有效性,确认平台对不同协议设备的适配能力,为后续实际物联网设备的批量接入提供可靠的技术验证依据。
1. 创建客户
创建一个测试账号

2. 创建一个设备
设备是属于客户的,因此应该先创建客户,合情合理

3. 连通性测试
官方给出了http、mqtt、coap的指令,使用这些指令可以直接测试,问题奀

3.1 使用http上传数据
指令
shell
curl -v -X POST http://192.168.111.157:8080/api/v1/eubppzqIHQHK5jqQANd9/telemetry --header Content-Type:application/json --data "{temperature:25}"
text
root@zhongrui:~# curl -v -X POST http://192.168.111.157:8080/api/v1/eubppzqIHQHK5jqQANd9/telemetry --header Content-Type:application/json --data "{temperature:89}"
Note: Unnecessary use of -X or --request, POST is already inferred.
* Trying 192.168.111.157:8080...
* TCP_NODELAY set
* Connected to 192.168.111.157 (192.168.111.157) port 8080 (#0)
> POST /api/v1/eubppzqIHQHK5jqQANd9/telemetry HTTP/1.1
> Host: 192.168.111.157:8080
> User-Agent: curl/7.68.0
> Accept: */*
> Content-Type:application/json
> Content-Length: 16
>
* upload completely sent off: 16 out of 16 bytes
* Mark bundle as not supporting multiuse
< HTTP/1.1 200
< Vary: Origin
< Vary: Access-Control-Request-Method
< Vary: Access-Control-Request-Headers
< X-Content-Type-Options: nosniff
< X-XSS-Protection: 0
< Cache-Control: no-cache, no-store, max-age=0, must-revalidate
< Pragma: no-cache
< Expires: 0
< X-Frame-Options: DENY
< Content-Length: 0
< Date: Sun, 25 Jan 2026 09:42:22 GMT
<
* Connection #0 to host 192.168.111.157 left intact

说明:
- 直接在thingsboard的服务器上执行指令,简单直接有疗效
- 如果
curl指令缺失,根据提示安装即可
3.2 使用mqtt上传数据
指令
shell
mosquitto_pub -d -q 1 -h 192.168.111.157 -p 1883 -t v1/devices/me/telemetry -u "eubppzqIHQHK5jqQANd9" -m "{temperature:25}"
执行结果
text
root@zhongrui:~# mosquitto_pub -d -q 1 -h 192.168.111.157 -p 1883 -t v1/devices/me/telemetry -u "eubppzqIHQHK5jqQANd9" -m "{temperature:25}"
Client mosq-EykdwSC2PkonKvjqxi sending CONNECT
Client mosq-EykdwSC2PkonKvjqxi received CONNACK (0)
Client mosq-EykdwSC2PkonKvjqxi sending PUBLISH (d0, q1, r0, m1, 'v1/devices/me/telemetry', ... (16 bytes))
Client mosq-EykdwSC2PkonKvjqxi received PUBACK (Mid: 1, RC:0)
Client mosq-EykdwSC2PkonKvjqxi sending DISCONNECT

说明:
- 直接复制粘结官方的指令即可
- 相当贴心,良心得一匹,把指令都告诉你了,省事
3.3 使用coap上传数据
指令
shell
coap-client -v 6 -m POST -t "application/json" -e "{temperature:100}" coap://192.168.111.157:5683/api/v1/eubppzqIHQHK5jqQANd9/telemetry
执行结果
text
root@zhongrui:~# coap-client -v 6 -m POST -t "application/json" -e "{temperature:100}" coap://192.168.111.157:5683/api/v1/eubppzqIHQHK5jqQANd9/telemetry
v:1 t:CON c:POST i:851a {} [ Uri-Path:api, Uri-Path:v1, Uri-Path:eubppzqIHQHK5jqQANd9, Uri-Path:telemetry, Content-Format:application/json ] :: '{temperature:100}'
v:1 t:CON c:2.01 i:4a0e {} [ ]

4. 总结
本次在RK3588(Ubuntu 20.04)部署的ThingsBoard 4.3平台上,以租户管理员视角完成了设备与平台的连通性全维度测试,核心结论与关键要点如下:
-
测试流程与核心结果 :
遵循「创建客户→创建设备(归属该客户)→多协议数据上报」的合理流程,使用ThingsBoard官方提供的HTTP、MQTT、CoAP指令,在服务器本地直接执行测试,均成功向平台上报温度类遥测数据,平台「最新遥测」模块可实时展示数据,验证了ThingsBoard在ARM64架构下的多协议接入能力完全正常。
-
操作便利性与实用性 :
官方预置的测试指令无需额外修改(仅需替换设备访问令牌),直接复制粘贴即可执行,大幅降低测试门槛;三种协议测试均在服务器本地完成,规避了网络跨节点问题,测试结果直接反映平台核心接入功能的有效性。
-
关键技术要点:
- 核心凭证:设备访问令牌是各协议认证的唯一关键,需准确填写(本次测试令牌为
eubppzqIHQHK5jqQANd9); - 端口验证:8080(HTTP)、1883(MQTT)、5683(CoAP)端口监听正常,是协议连通的基础;
- 工具依赖:测试需确保
curl、mosquitto-clients、coap-client工具已安装,缺失时按需补装即可。
- 核心凭证:设备访问令牌是各协议认证的唯一关键,需准确填写(本次测试令牌为
-
平台能力验证 :
本次测试覆盖IoT场景主流的三种接入协议,均实现数据上报成功,证明部署在RK3588上的ThingsBoard 4.3平台具备完整的多协议设备接入能力,可满足不同类型物联网设备(HTTP客户端、MQTT设备、低功耗CoAP设备)的对接需求。