TCP 客户端接入与数据流程
使用真实 TCP 设备 GUI 完成接入、上行、客户端详情统计、平台下发、设备实收、断开重连和清理。
页面导读
适用场景适合需要用真实 TCP 设备验证接入、上行、平台下发实收、断开重连与清理闭环的实施和运维人员。
前置条件已能登录 FMQ 控制台并具备客户端查看和测试指令权限，准备 LinkPilot 设备协议调试工作台（TCP 端口 8888），预计 45 分钟。
验收点TCP 会话在线，上行进入详情统计和最近消息，下行帧在设备 GUI 实收，断开后有离线记录，重连后恢复并清理临时会话。
阅读方法
先确认入口、权限和目标对象，再按编号完成操作。每一步都包含预期结果；详细字段和选项收在可展开的参考表中。
截图说明
截图来自原始操作手册。公开版会隐藏真实节点地址、连接地址和凭据；示例中的状态、时间和数据不代表当前生产环境。
开始前准备
| 项目 | 说明 |
|---|---|
| 能做什么 | 按协议完成设备接入、上行、客户端详情统计、平台下发、设备实收、断开重连和清理。 |
| 从哪里进入 | 登录 FMQ 控制台后进入设备 → 客户端。 |
| 需要权限 | 具备客户端查看和测试指令权限。 |
| 预计时间 | 45 分钟 |
操作步骤
1. 进入TCP客户端页面
操作位置： 设备→客户端
登录后进入设备 → 客户端，点击协议筛选并使用搜索框定位本次设备会话。
图：① 协议筛选与搜索用于定位当前设备；② 列表显示协议、状态、节点、远端地址、最后活跃和操作入口。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| 客户端列表 | 统一查看 MQTT、TCP、UDP 客户端会话，先用筛选和搜索定位设备。 |
2. 定位TCP目标会话
操作位置： 设备→客户端
在搜索框输入设备 Client ID，确认在线行后点击追踪或直接点击该行打开详情。
图：① Client ID 是单台设备的定位键；② 在线状态与最后活跃时间一起判断会话是否仍在工作。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| 客户端 ID | 设备唯一编号，用于精确定位一台设备。 |
| 协议 | 设备接入使用的 MQTT、TCP 或 UDP 协议。 |
| 状态 | 当前会话在线、离线或其他运行状态。 |
| 节点 | 设备当前归属的集群服务器节点。 |
| 远端地址 | 设备连接到平台时使用的地址和端口。 |
| 心跳时间 | 设备最近一次心跳或保活时间。 |
| 会话模式 | 会话当前采用的连接模式。 |
| 订阅数 | MQTT 会话当前订阅主题的数量。 |
| 最后活跃 | 最近一次收发数据的时间。 |
| 最近离线 | 最近一次离线时间和原因。 |
3. TCP列表操作区
操作位置： 设备→客户端
在目标行查看追踪、查看订阅和断开连接操作；先点击追踪开启当前会话采集。
图：① 追踪开启当前会话采集；② MQTT 可查看订阅；③ 断开连接会改变设备运行状态。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| 搜索 | 按 clientId、sessionId、远端地址或节点缩小结果。 |
| 节点筛选 | 只查看指定集群节点上的会话。 |
| 协议筛选 | 只查看 MQTT、TCP 或 UDP 会话。 |
| 状态筛选 | 按在线或离线状态筛选。 |
| 刷新列表 | 重新读取当前运行面会话。 |
| 分页 | 浏览更多会话记录。 |
| 追踪 | 开启当前会话的详情采集。 |
| 查看订阅 | 进入 MQTT 主题订阅明细。 |
| 断开连接 | 主动结束设备会话并产生离线记录。 |
4. 打开TCP详情并开启采集
操作位置： 设备→客户端
打开客户端详情并确认追踪已开启；先阅读总览中的连接状态、节点、连接时间、订阅数和最后活跃。
图：① 总览确认状态和节点；② 连接时间与最后活跃用于判断会话是否持续工作。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| 连接状态 | 当前设备连接是否有效。 |
| 节点 | 会话所在的集群节点。 |
| 建立时间 | 本次会话建立的时间。 |
| 最后活跃 | 最近一次活跃时间。 |
| 写入字节 | 平台向设备发送的累计字节。 |
| 读取字节 | 平台从设备读取的累计字节。 |
| 写入消息 | 平台向设备发送的消息数量。 |
| 读取消息 | 平台从设备读取的消息数量。 |
| 丢弃/失败 | 被丢弃或发送失败的消息数量。 |
| 订阅数 | 当前订阅数量。 |
| 平均延迟 | 消息处理平均耗时；仅在页面提供时显示。 |
5. TCP查看订阅主题
操作位置： 设备→客户端
打开订阅主题页签，核对 Topic、QoS、Node、NL、RAP、RH；TCP/UDP 记录页面给出的不适用状态。
图：① Topic 是设备接收下行消息的主题；② QoS 表示服务质量级别；③ Node、NL、RAP、RH 用于核对订阅属性。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| Topic | 设备接收下行消息的主题地址。 |
| QoS | 主题服务质量级别。 |
| Node | 订阅所属运行节点。 |
| NL | 是否禁止本地发布回送。 |
| RAP | 是否保持原始发布标志。 |
| RH | 保留消息处理策略。 |
6. TCP设备 GUI 发送上行数据
操作位置： LinkPilot 设备协议调试工作台
在 LinkPilot 的真实协议工作台中保持会话已连接，发送一条包含设备身份和温度值的合法 JSON 上行报文。
图：① LinkPilot 显示会话已连接；② 通信时间线记录本次设备上行帧；③ 协议端口为 MQTT 1883、TCP 8888 或 UDP 8889。
7. TCP查看最近消息
操作位置： 设备→客户端
打开最近消息页签，使用 JSON、原文或 HEX 查看格式，并核对上行/下行、时间、Topic 或地址、消息 ID、大小和 payload。
图：① 上行记录证明消息已进入客户端详情；② JSON/原文/HEX 用于按协议内容阅读；③ 时间、方向和消息 ID 用于关联设备动作。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| 显示格式 | JSON、原文或 HEX 阅读方式。 |
| 上行/下行 | 区分设备上报和平台下发。 |
| 时间 | 消息进入详情记录的时间。 |
| Topic/地址 | 消息来源主题或网络地址。 |
| 消息 ID | 关联一次报文的唯一编号。 |
| Payload 格式 | 原始报文的编码类型。 |
| Payload 大小 | 报文占用的字节数。 |
| 字段识别 | JSON 对象及其字段摘要。 |
8. TCP查看消息流向
操作位置： 设备→客户端
打开消息流向页签，阅读一条真实上行消息从协议接入、事件总线、Alink 组装、规则处理到连接器上报的过程，并展开处理时间线。
图：① 来源 Topic/地址代表设备上行入口；② 中间过程展示平台内部处理链路；③ 连接器成功表示消息已进入配置的上报出口。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| 来源 Topic/地址 | 设备上行进入平台的来源。 |
| 方向 | 上行或下行方向。 |
| 处理节点 | 事件总线和协议处理位置。 |
| Alink 报文 | 平台统一组装后的业务消息。 |
| 规则处理 | 规则是否命中并执行动作。 |
| 连接器 | RabbitMQ/Kafka 等上报出口。 |
| 处理过程 | 可展开查看从接入到上报的时间线。 |
9. TCP查看最近异常
操作位置： 设备→客户端
打开最近异常页签，按时间查看连接、解析、路由、下发或超时异常；没有记录时确认页面空状态。
图：① 时间用于与设备动作对应；② 类型和消息帮助判断连接、解析或处理问题；③ 空状态表示当前会话没有被详情记录的异常。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| 异常时间 | 异常发生时间，用于和设备动作对照。 |
| 异常类型 | 连接、解析、路由、下发或超时等类别。 |
| 异常消息 | 平台记录的具体异常信息。 |
| 空状态 | 没有记录时表示当前会话未产生详情异常。 |
10. TCP填写发送测试指令
操作位置： 设备→客户端
在发送测试指令页选择 Payload 类型；MQTT 填写 Topic、QoS 和 Retain，TCP/UDP 使用当前会话目标，点击格式化确认消息体后再发送。
图：① Topic 决定 MQTT 下行主题；② QoS 0/1/2 表示不同服务质量；③ Retain 控制是否保留消息；④ JSON/原文/HEX 决定 payload 解释方式。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| Topic | MQTT 下行主题；TCP/UDP 使用当前会话目标。 |
| QoS | 选择 0、1 或 2 级服务质量。 |
| Retain | 控制消息是否保留。 |
| Payload 类型 | 选择 JSON、原文或 HEX。 |
| 格式化 | 把 JSON 消息体整理为可读格式。 |
| 消息体 | 填写要发送到设备的内容。 |
| 发送测试指令 | 提交平台下发并等待设备 GUI 实收。 |
11. 平台向TCP设备下发指令并确认实收
操作位置： LinkPilot 设备协议调试工作台
在发送测试指令页填写 JSON payload，MQTT 选择 Topic、QoS 和 Retain；TCP/UDP 使用当前会话目标，点击发送测试指令。随后回到 LinkPilot GUI 查看设备实际收到的下行帧。
图：① LinkPilot 时间线显示平台下行实际到达设备；② MQTT 下行使用 1883 连接和订阅主题；③ TCP/UDP 显示会话收到的原始字节。
12. TCP设备断开并观察离线状态
操作位置： LinkPilot 设备协议调试工作台
在 LinkPilot GUI 主动断开会话，回到 FMQ 客户端列表刷新并查看离线状态、最近离线时间和原因。
图：① 会话状态变为已断开；② 断开动作会在真实 GUI 的交互时间线中留下记录。
13. TCP查看最近离线记录
操作位置： 设备→客户端
在客户端详情的最近离线记录页签或列表空状态中核对离线时间和原因；本次断开后至少确认平台不再显示在线会话。
图：① 离线时间用于判断断开发生时刻；② 原因用于区分人工操作、超时和连接关闭；③ 服务重启会清空内存中的最近记录。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| 离线时间 | 会话离线发生的时间。 |
| 离线原因 | 手动断开、心跳超时、通道关闭、会话替换或 UDP 超时等原因。 |
| 最近 10 条 | 页面最多保留最近十条内存记录。 |
| 重启清空 | 服务重启后这些记录会被清空。 |
14. TCP设备重连并确认恢复
操作位置： LinkPilot 设备协议调试工作台
在 LinkPilot GUI 执行重新连接动作，回到平台刷新客户端详情，核对在线状态和最后活跃时间重新更新。
图：① 重连后 GUI 显示已连接；② 连接信息保留当前协议端口 8888。
15. 清理TCP临时会话
操作位置： 设备→客户端
删除 LinkPilot 临时会话，回到 FMQ 客户端列表按 Client ID 搜索并刷新，确认当前筛选结果为空。
图：① 刷新列表；② 当前 Client ID 不再出现，表示临时会话已清理。
客户端页面字段说明
以下按客户端列表和详情页签的阅读顺序说明页面字段；协议不适用的区域会明确标注，不把技术日志当作页面字段。
完整参考
| 字段 / 单位 | 通俗含义 | 数据方向 / 来源 | 正常判断 | 异常信号与第一检查点 |
|---|---|---|---|---|
| 客户端列表用途 | ||||
| 客户端列表页面字段 | 统一查看 MQTT、TCP、UDP 客户端会话，先用筛选和搜索定位设备。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 客户端列表重点字段 | ||||
| 客户端 ID页面字段 | 设备唯一编号，用于精确定位一台设备。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 协议页面字段 | 设备接入使用的 MQTT、TCP 或 UDP 协议。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 状态页面字段 | 当前会话在线、离线或其他运行状态。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 节点页面字段 | 设备当前归属的集群服务器节点。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 远端地址页面字段 | 设备连接到平台时使用的地址和端口。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 心跳时间页面字段 | 设备最近一次心跳或保活时间。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 会话模式页面字段 | 会话当前采用的连接模式。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 订阅数页面字段 | MQTT 会话当前订阅主题的数量。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 最后活跃页面字段 | 最近一次收发数据的时间。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 最近离线页面字段 | 最近一次离线时间和原因。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 客户端列表操作 | ||||
| 搜索页面字段 | 按 clientId、sessionId、远端地址或节点缩小结果。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 节点筛选页面字段 | 只查看指定集群节点上的会话。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 协议筛选页面字段 | 只查看 MQTT、TCP 或 UDP 会话。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 状态筛选页面字段 | 按在线或离线状态筛选。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 刷新列表页面字段 | 重新读取当前运行面会话。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 分页页面字段 | 浏览更多会话记录。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 追踪页面字段 | 开启当前会话的详情采集。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 查看订阅页面字段 | 进入 MQTT 主题订阅明细。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 断开连接页面字段 | 主动结束设备会话并产生离线记录。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 追踪详情总览 | ||||
| 连接状态页面字段 | 当前设备连接是否有效。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 节点页面字段 | 会话所在的集群节点。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 建立时间页面字段 | 本次会话建立的时间。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 最后活跃页面字段 | 最近一次活跃时间。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 写入字节页面字段 | 平台向设备发送的累计字节。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 读取字节页面字段 | 平台从设备读取的累计字节。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 写入消息页面字段 | 平台向设备发送的消息数量。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 读取消息页面字段 | 平台从设备读取的消息数量。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 丢弃/失败页面字段 | 被丢弃或发送失败的消息数量。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 订阅数页面字段 | 当前订阅数量。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 平均延迟页面字段 | 消息处理平均耗时；仅在页面提供时显示。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 订阅主题 | ||||
| Topic页面字段 | 设备接收下行消息的主题地址。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| QoS页面字段 | 主题服务质量级别。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| Node页面字段 | 订阅所属运行节点。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| NL页面字段 | 是否禁止本地发布回送。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| RAP页面字段 | 是否保持原始发布标志。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| RH页面字段 | 保留消息处理策略。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 最近消息 | ||||
| 显示格式页面字段 | JSON、原文或 HEX 阅读方式。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 上行/下行页面字段 | 区分设备上报和平台下发。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 时间页面字段 | 消息进入详情记录的时间。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| Topic/地址页面字段 | 消息来源主题或网络地址。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 消息 ID页面字段 | 关联一次报文的唯一编号。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| Payload 格式页面字段 | 原始报文的编码类型。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| Payload 大小页面字段 | 报文占用的字节数。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 字段识别页面字段 | JSON 对象及其字段摘要。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 消息流向 | ||||
| 来源 Topic/地址页面字段 | 设备上行进入平台的来源。 | 设备 ↔ FMQ ↔ 上游 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 方向页面字段 | 上行或下行方向。 | 设备 ↔ FMQ ↔ 上游 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 处理节点页面字段 | 事件总线和协议处理位置。 | 设备 ↔ FMQ ↔ 上游 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| Alink 报文页面字段 | 平台统一组装后的业务消息。 | 设备 ↔ FMQ ↔ 上游 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 规则处理页面字段 | 规则是否命中并执行动作。 | 设备 ↔ FMQ ↔ 上游 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 连接器页面字段 | RabbitMQ/Kafka 等上报出口。 | 设备 ↔ FMQ ↔ 上游 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 处理过程页面字段 | 可展开查看从接入到上报的时间线。 | 设备 ↔ FMQ ↔ 上游 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 发送测试指令 | ||||
| Topic页面字段 | MQTT 下行主题；TCP/UDP 使用当前会话目标。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| QoS页面字段 | 选择 0、1 或 2 级服务质量。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| Retain页面字段 | 控制消息是否保留。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| Payload 类型页面字段 | 选择 JSON、原文或 HEX。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 格式化页面字段 | 把 JSON 消息体整理为可读格式。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 消息体页面字段 | 填写要发送到设备的内容。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 发送测试指令页面字段 | 提交平台下发并等待设备 GUI 实收。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 最近异常 | ||||
| 异常时间页面字段 | 异常发生时间，用于和设备动作对照。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 异常类型页面字段 | 连接、解析、路由、下发或超时等类别。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 异常消息页面字段 | 平台记录的具体异常信息。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 空状态页面字段 | 没有记录时表示当前会话未产生详情异常。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 最近离线记录 | ||||
| 离线时间页面字段 | 会话离线发生的时间。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 离线原因页面字段 | 手动断开、心跳超时、通道关闭、会话替换或 UDP 超时等原因。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 最近 10 条页面字段 | 页面最多保留最近十条内存记录。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 重启清空页面字段 | 服务重启后这些记录会被清空。 | FMQ TCP 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
客户端列表与详情
完整参考
| 字段/控件 | 用途说明 | 默认/推荐/示例 | 选项说明 | 作用与影响 | 生效条件 |
|---|---|---|---|---|---|
| 必填 客户端搜索 | 按客户端 ID、会话 ID、远端地址或节点过滤列表。 | 默认：空推荐：填写目标 Client ID示例：按当前环境填写 | 不适用 | 缩小列表范围，便于定位目标设备。 | 范围：当前页面筛选发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 节点筛选 | 按 FMQ 集群节点过滤会话。 | 默认：全部节点推荐：按详情节点选择示例：当前节点 | 全部节点：不限制运行节点。；在所有节点的客户端会话中查找目标。当前节点：只查看当前控制台连接节点。；缩小结果范围，便于核对节点归属。 | 只显示指定节点上的客户端。 | 范围：当前页面筛选发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 刷新列表 | 重新读取当前运行面客户端列表。 | 默认：—推荐：状态变化后刷新示例：刷新列表 | 不适用 | 显示最新在线状态、节点和活跃时间。 | 范围：当前页面数据发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 协议筛选 | 选择 MQTT、TCP 或 UDP 客户端协议。 | 默认：全部推荐：TCP示例：TCP | 不适用 | 只显示所选协议的会话。 | 范围：当前页面筛选发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 状态筛选 | 按在线或离线状态筛选会话。 | 默认：全部推荐：在线示例：在线 | 不适用 | 快速确认设备是否仍在线。 | 范围：当前页面筛选发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 分页 | 在多页客户端结果之间切换。 | 默认：第 1 页推荐：按结果翻页示例：下一页 | 不适用 | 查看当前筛选条件下的其他会话。 | 范围：当前页面数据发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 追踪 | 开启当前客户端的设备级追踪、最近消息和消息流向采集。 | 默认：关闭推荐：打开详情前开启示例：追踪 | 不适用 | 详情页开始显示收发统计、payload 和处理链路。 | 范围：当前客户端会话发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 打开详情 | 打开目标客户端详情抽屉。 | 默认：—推荐：确认目标行后打开示例：打开详情 | 不适用 | 查看总览、订阅、消息、流向、下发、异常和离线记录。 | 范围：当前页面发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 断开连接 | 主动关闭当前客户端运行会话。 | 默认：—推荐：仅在恢复或清理时使用示例：断开连接 | 不适用 | 设备变为离线并产生离线记录。 | 范围：当前运行会话发布：不需要 · 重启：不需要 · 重连：需要 |
| 必填 刷新详情 | 重新读取当前客户端详情和追踪快照。 | 默认：—推荐：上行或下发后刷新示例：刷新详情 | 不适用 | 更新字节、消息、异常和最后活跃等字段。 | 范围：当前客户端详情发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 总览 | 查看连接状态和收发监控指标。 | 默认：总览推荐：先查看示例：总览 | 不适用 | 判断会话是否建立以及上行/下行是否有活动。 | 范围：当前客户端详情发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 订阅主题 | 查看 MQTT 订阅主题及其 QoS 和属性。 | 默认：订阅主题推荐：MQTT 场景核对示例：订阅主题 | 不适用 | 显示 TCP/UDP 不适用 MQTT 订阅。 | 范围：当前客户端详情发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 全局订阅页 | 跳转到全局订阅页面。 | 默认：—推荐：需要跨客户端查询时使用示例：全局订阅页 | 不适用 | 从单个客户端订阅扩展到全局主题检索。 | 范围：全局订阅页面发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 最近消息 | 查看当前会话最近收到和发出的消息。 | 默认：最近消息推荐：设备上行后查看示例：最近消息 | 不适用 | 核对实时方向、时间、主题、大小和 payload。 | 范围：当前客户端详情发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 JSON / 原文 / HEX | 切换消息 payload 的 JSON、原文或 HEX 展示。 | 默认：JSON推荐：JSON 优先，异常时看 HEX示例：HEX | 不适用 | 按可读性或原始字节需要阅读消息内容。 | 范围：当前页面展示发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 消息流向 | 查看消息经过协议、事件总线、规则和连接器的处理过程。 | 默认：消息流向推荐：上行消息后查看示例：消息流向 | 不适用 | 定位消息在哪个处理阶段成功或停留。 | 范围：当前客户端详情发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 发送测试指令 | 打开平台下发测试指令表单。 | 默认：发送测试指令推荐：确认订阅或会话目标后使用示例：发送测试指令 | 不适用 | 为当前设备准备一条可验证的下行消息。 | 范围：当前客户端会话发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 Payload 类型 | 选择下行消息按 JSON、原文或 HEX 发送。 | 默认：JSON推荐：按设备协议选择示例：JSON | 不适用 | 决定平台如何校验和编码消息体。 | 范围：当前下行请求发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 格式化 | 格式化 JSON 消息体。 | 默认：—推荐：发送前点击示例：格式化 JSON | 不适用 | 把紧凑 JSON 整理为可读结构，便于复核。 | 范围：当前下行请求发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 发送测试指令 | 提交当前下行测试指令。 | 默认：—推荐：参数核对后发送示例：发送测试指令 | 不适用 | 平台向目标客户端发送消息，并等待设备 GUI 实收验证。 | 范围：当前设备会话发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 最近异常 | 查看当前客户端最近记录的异常。 | 默认：最近异常推荐：异常排查时查看示例：最近异常 | 不适用 | 按时间和类型定位连接、解析、路由或超时问题。 | 范围：当前客户端详情发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 最近离线记录 | 查看当前客户端最近离线时间和原因。 | 默认：最近离线记录推荐：断开或重连后查看示例：最近离线记录 | 不适用 | 判断人工断开、超时、连接关闭或会话替换。 | 范围：当前客户端详情发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 关闭详情 | 关闭客户端详情抽屉。 | 默认：—推荐：完成核对后关闭示例：关闭详情 | 不适用 | 结束当前详情查看，页面会停止该窗口的追踪采集。 | 范围：当前页面发布：不需要 · 重启：不需要 · 重连：不需要 |
常见问题
TCP 设备接入后怎么确认数据闭环已经跑通？
用 LinkPilot 保持 TCP 会话已连接并发送一条合法 JSON 上行报文，在客户端详情的总览和最近消息中核对到这条上行，再从平台发送测试指令，并在 LinkPilot 时间线确认下行帧实际到达设备。
TCP 客户端也需要配置订阅主题吗？
不需要。订阅主题页签是 MQTT 能力，TCP/UDP 会话在该页签显示不适用；平台向 TCP 设备下发时直接使用当前会话目标，无需填写 Topic。
FastBee 平台怎么向 TCP 设备下发指令？
在客户端详情的「发送测试指令」页选择 Payload 类型（JSON、原文或 HEX）并填写消息体，TCP/UDP 使用当前会话目标，点击发送后回到设备 GUI 核对实收。
TCP 设备断开后怎么判断离线原因？
在 FMQ 客户端列表刷新查看离线状态，并在详情的「最近离线记录」页签核对离线时间和原因；记录最多保留最近 10 条，服务重启后清空。
生产操作提示
截图和示例用于说明操作位置与判断方法，不代表当前生产状态。涉及发布、启停、重绑、重试或删除时，应先确认目标环境、影响范围和恢复方案，并由授权人员执行。
蜂信物联（FastBee） · FMQ 操作手册