FMQ 服务管理
展示巡检按页面区域阅读；操作说明按目标节点和协议查阅。所有写操作只说明步骤和预期结果，本轮未执行。
阅读方法
先确认入口、权限和目标对象，再按编号完成操作。每一步都包含预期结果；详细字段和选项收在可展开的参考表中。
截图说明
截图来自原始操作手册。公开版会隐藏真实节点地址、连接地址和凭据；示例中的状态、时间和数据不代表当前生产环境。
开始前准备
| 项目 | 说明 |
|---|---|
| 能做什么 | 按节点理解各监听入口的状态、字段与操作边界，并查阅配置、启停、重启和重绑说明。 |
| 从哪里进入 | 监控 → 服务管理 |
| 需要权限 | 已有 FMQ 控制台访问权限；实际运行变更须由授权运维人员在维护窗口执行。 |
| 预计时间 | 15 分钟 |
操作步骤
1. 确认管理范围与刷新入口
操作位置： 监控→服务管理
从监控菜单进入 服务管理，先读页面范围说明，再找到 刷新。
图：先确认页面仅按目标节点操作，并查看刷新入口。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| 监控范围 | 页面以当前选中节点为范围展示运行快照；节点概览用于切换目标，不代表所有节点同步操作。 |
| 采样时间 | 以节点卡片的同步时间和最近快照时间判断本页数据新鲜度。 |
| 整体健康状态 | 结合在线节点、离线节点和失败监听器数量判断整体健康，不把单一“在线”标签当作全部正常。 |
| 仅运行时生效 | 说明当前入口操作的是节点正在运行的服务。 |
| 不回写部署配置 | 页面声明不修改部署文件；不等于不写运行配置中心。 |
| 不自动同步其他节点 | 页面操作不能当作所有节点同时变更。 |
2. 读取节点与所选节点汇总
操作位置： 监控→服务管理
查看汇总卡片，区分集群节点数量和 所选节点会话、所选节点监听器 的统计范围。
图：区分集群节点统计和当前所选节点统计。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| 节点总数 | 当前快照中可见的节点数量。 |
| 在线节点 | 页面统计中未标记离线或断开的节点数，不等于全部健康。 |
| 离线 | 被标记离线或断开的节点数。 |
| 所选节点会话 | 当前选中节点汇总的会话数量，不是全集群总量。 |
| 所选节点监听器 | 所选节点返回的监听器条目数量。 |
| 运行中 | 所选节点状态为运行中的监听器数量。 |
| 失败 | 所选节点状态为失败的监听器数量。 |
3. 确认节点身份与快照新鲜度
操作位置： 监控→服务管理
在 集群节点概览 中核对节点名称、地址、状态与时间，再选择目标节点。
图：核对节点身份、在线状态、会话和同步时间。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| 节点名称 | 用于选择操作目标的节点身份。 |
| 当前节点／远端节点 | 当前节点是本控制台对应节点；其他节点为远端。 |
| 节点地址 | 区分部署节点的网络地址。 |
| 节点状态 | 页面区分在线、离线、异常或告警。 |
| 监听器 | 此节点返回的监听入口数量。 |
| 会话 | 此节点的会话汇总。 |
| 同步时间 | 节点快照最近同步时间，不是设备最后上报时间。 |
| 最近快照时间 | 这次页面快照的时间标识。 |
4. 确认当前监听器工作区
操作位置： 监控→服务管理
选择节点后，核对 监听器工作区 标题与所选节点一致，再向下查看各协议入口。
图：工作区标题决定下方所有监听卡片的节点归属。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| 工作区节点名称 | 下方全部监听卡片属于标题所示节点。 |
| 当前节点／远端节点 | 提醒后续操作的节点归属。 |
| 仅运行时生效 | 这里控制的是节点运行入口，不是批量全局开关。 |
5. 读取 MQTT TCP 监听状态
操作位置： 监控→服务管理
在外部接入中找到 MQTT TCP，依次查看状态、端点、会话和时间；不点击启停按钮。
图：核对 MQTT TCP 监听端点、运行状态、会话数和时间。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| MQTT 接入 | MQTT TCP：MQTT TCP 的页面用途分组。 |
| 运行状态 | MQTT TCP：区分运行中、启动中、停止中、已停止、失败和未知。 |
| 监听端点 | MQTT TCP：展示服务绑定的地址和端口；0.0.0.0 是绑定所有接口，不是设备应填写的目标地址。 |
| 当前节点口径 | MQTT TCP：卡片数值不是全集群合计。 |
| 活跃会话 | MQTT TCP：MQTT TCP 入口归属的活跃会话数量。 |
| 运行时长 | MQTT TCP：监听器最近一次启动后的持续运行时间；停止时显示横线。 |
| 最近操作 | MQTT TCP：最近一次监听器生命周期操作时间，不是设备报文时间。 |
| 停止时间 | MQTT TCP：最近停止时间；无相应记录时显示横线。 |
6. 读取 MQTT WebSocket 监听状态
操作位置： 监控→服务管理
在外部接入中找到 MQTT WebSocket，依次查看状态、端点、会话和时间；不点击启停按钮。
图：WebSocket 端点还包含路径，并可处于已停止状态。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| WebSocket 接入 | MQTT WebSocket：MQTT WebSocket 的页面用途分组。 |
| 运行状态 | MQTT WebSocket：区分运行中、启动中、停止中、已停止、失败和未知。 |
| 监听端点 | MQTT WebSocket：由监听地址、端口和 WebSocket 路径组成。 |
| 当前节点口径 | MQTT WebSocket：卡片数值不是全集群合计。 |
| 活跃会话 | MQTT WebSocket：MQTT WebSocket 入口归属的活跃会话数量。 |
| 运行时长 | MQTT WebSocket：监听器最近一次启动后的持续运行时间；停止时显示横线。 |
| 最近操作 | MQTT WebSocket：最近一次监听器生命周期操作时间，不是设备报文时间。 |
| 停止时间 | MQTT WebSocket：最近停止时间；无相应记录时显示横线。 |
7. 读取 TCP 监听状态
操作位置： 监控→服务管理
在外部接入中找到 TCP，依次查看状态、端点、会话和时间；不点击启停按钮。
图：核对 TCP 端点、运行状态、会话数和时间。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| TCP 接入 | TCP：TCP 的页面用途分组。 |
| 运行状态 | TCP：区分运行中、启动中、停止中、已停止、失败和未知。 |
| 监听端点 | TCP：展示服务绑定的地址和端口；0.0.0.0 是绑定所有接口，不是设备应填写的目标地址。 |
| 当前节点口径 | TCP：卡片数值不是全集群合计。 |
| 活跃会话 | TCP：TCP 入口归属的活跃会话数量。 |
| 运行时长 | TCP：监听器最近一次启动后的持续运行时间；停止时显示横线。 |
| 最近操作 | TCP：最近一次监听器生命周期操作时间，不是设备报文时间。 |
| 停止时间 | TCP：最近停止时间；无相应记录时显示横线。 |
8. 读取 UDP 监听状态
操作位置： 监控→服务管理
在外部接入中找到 UDP，依次查看状态、端点、会话和时间；不点击启停按钮。
图：核对 UDP 端点、逻辑会话数和运行状态。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| UDP 接入 | UDP：UDP 的页面用途分组。 |
| 运行状态 | UDP：区分运行中、启动中、停止中、已停止、失败和未知。 |
| 监听端点 | UDP：展示服务绑定的地址和端口；0.0.0.0 是绑定所有接口，不是设备应填写的目标地址。 |
| 当前节点口径 | UDP：卡片数值不是全集群合计。 |
| 活跃会话 | UDP：UDP 逻辑会话数量，不代表建立了 TCP 式连接。 |
| 运行时长 | UDP：监听器最近一次启动后的持续运行时间；停止时显示横线。 |
| 最近操作 | UDP：最近一次监听器生命周期操作时间，不是设备报文时间。 |
| 停止时间 | UDP：最近停止时间；无相应记录时显示横线。 |
9. 读取 Cluster TCP 监听状态
操作位置： 监控→服务管理
在内部监听中找到 Cluster TCP，依次查看状态、端点、会话和时间；不点击启停按钮。
图：集群通道属于内部链路，并标记为不持久化。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| 集群通道 | Cluster TCP：Cluster TCP 的页面用途分组。 |
| 运行状态 | Cluster TCP：区分运行中、启动中、停止中、已停止、失败和未知。 |
| 监听端点 | Cluster TCP：展示服务绑定的地址和端口；0.0.0.0 是绑定所有接口，不是设备应填写的目标地址。 |
| 当前节点口径 | Cluster TCP：卡片数值不是全集群合计。 |
| 活跃会话 | Cluster TCP：集群通道卡片返回的会话数，不能替代集群健康判断。 |
| 运行时长 | Cluster TCP：监听器最近一次启动后的持续运行时间；停止时显示横线。 |
| 最近操作 | Cluster TCP：最近一次监听器生命周期操作时间，不是设备报文时间。 |
| 停止时间 | Cluster TCP：最近停止时间；无相应记录时显示横线。 |
| 不持久化 | Cluster TCP：集群通道卡片明确标出的配置持久化限制。 |
10. 读取 HTTP Control Plane 只读状态
操作位置： 监控→服务管理
在控制面中找到 HTTP Control Plane，依次查看状态、端点、会话和时间；不点击启停按钮。
图：HTTP 控制面为只读展示，不提供启停和配置按钮。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| 管理接口 | HTTP Control Plane：HTTP Control Plane 的页面用途分组。 |
| 运行状态 | HTTP Control Plane：区分运行中、启动中、停止中、已停止、失败和未知。 |
| 监听端点 | HTTP Control Plane：展示服务绑定的地址和端口；0.0.0.0 是绑定所有接口，不是设备应填写的目标地址。 |
| 当前节点口径 | HTTP Control Plane：卡片数值不是全集群合计。 |
| 活跃会话 | HTTP Control Plane：管理接口不应按设备连接数解释；0 不代表控制台不可用。 |
| 运行时长 | HTTP Control Plane：当前源码固定返回 0，不能用它判断 HTTP 刚重启。 |
| 最近操作 | HTTP Control Plane：最近一次监听器生命周期操作时间，不是设备报文时间。 |
| 停止时间 | HTTP Control Plane：最近停止时间；无相应记录时显示横线。 |
| 只读 | HTTP Control Plane：本页不提供 HTTP 控制面的启停与配置。 |
11. 选择正确的操作节点
操作位置： 监控→服务管理
先点击 节点卡片，再核对工作区节点名称和地址。不要把当前页面当作所有节点的统一开关。
图：节点卡片决定下方监听器工作区的操作目标，选中后摘要与工作区同步切换。
12. 查看 MQTT TCP 配置与协议差异
操作位置： 监控→服务管理
在 MQTT TCP 卡片点击 配置，按下表理解字段。本次只查看，不修改、不保存；查看后点击 取消。
图：本次只查看字段和当前值，不修改、不保存。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| 启用状态 | 允许或禁止该监听入口；关闭后保留配置，但不再接收新接入。；允许或禁止该监听入口；关闭后保留配置，但不再接收新接入。必填 · 推荐：保持已验证的部署值 · 示例：以现场值为准 |
| 端口 | 监听入口端口，范围 1–65535；应使用部署规划中未冲突的端口。；监听入口端口，范围 1–65535；应使用部署规划中未冲突的端口。必填 · 推荐：保持已验证的部署值 · 示例：以现场值为准 |
| KeepAlive | 页面可读写的 MQTT KeepAlive 配置。当前源码实际连接空闲超时取自客户端 CONNECT 心跳值的 1.5 倍，不能承诺修改此字段会改变设备心跳。；页面可读写的 MQTT KeepAlive 配置。当前源码实际连接空闲超时取自客户端 CONNECT 心跳值的 1.5 倍，不能承诺修改此字段会改变设备心跳。必填 · 推荐：保持已验证的部署值 · 示例：以现场值为准 |
| SO_BACKLOG | 等待完成连接建立的队列容量，范围 1–65535；不是在线设备数上限。；等待完成连接建立的队列容量，范围 1–65535；不是在线设备数上限。必填 · 推荐：保持已验证的部署值 · 示例：以现场值为准 |
| 最大报文大小 | MQTT 解码允许的单报文大小，单位字节；页面范围 1024–67108864（64 MiB）。；MQTT 解码允许的单报文大小，单位字节；页面范围 1024–67108864（64 MiB）。必填 · 推荐：保持已验证的部署值 · 示例：以现场值为准 |
| SO_KEEPALIVE | 是否开启操作系统 TCP 保活；不等同于 MQTT PING 心跳间隔。；是否开启操作系统 TCP 保活；不等同于 MQTT PING 心跳间隔。必填 · 推荐：保持已验证的部署值 · 示例：以现场值为准 |
| 立即重绑 | 保存时释放并重新绑定入口；MQTT TCP、WebSocket、TCP 必要时会先断开该节点旧连接。；保存时释放并重新绑定入口；MQTT TCP、WebSocket、TCP 必要时会先断开该节点旧连接。选填 · 推荐：维护窗口内按影响评估决定，不为试验而切换 · 示例：以现场值为准 |
13. 查看 MQTT WebSocket 配置与协议差异
操作位置： 监控→服务管理
在 MQTT WebSocket 卡片点击 配置，按下表理解字段。本次只查看，不修改、不保存；查看后点击 取消。
图：WebSocket 配置包含端口和 Path，本次未保存。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| 启用状态 | 允许或禁止该监听入口；关闭后保留配置，但不再接收新接入。；允许或禁止该监听入口；关闭后保留配置，但不再接收新接入。必填 · 推荐：保持已验证的部署值 · 示例：以现场值为准 |
| 端口 | 监听入口端口，范围 1–65535；应使用部署规划中未冲突的端口。；监听入口端口，范围 1–65535；应使用部署规划中未冲突的端口。必填 · 推荐：保持已验证的部署值 · 示例：以现场值为准 |
| WebSocket Path | 浏览器 MQTT 客户端的接入路径；不能为空，未以 / 开头时页面会补齐。；浏览器 MQTT 客户端的接入路径；不能为空，未以 / 开头时页面会补齐。必填 · 推荐：与客户端完全一致，例如 /mqtt · 示例：以现场值为准 |
| 立即重绑 | 保存时释放并重新绑定入口；MQTT TCP、WebSocket、TCP 必要时会先断开该节点旧连接。；保存时释放并重新绑定入口；MQTT TCP、WebSocket、TCP 必要时会先断开该节点旧连接。选填 · 推荐：维护窗口内按影响评估决定，不为试验而切换 · 示例：以现场值为准 |
14. 查看 TCP 配置与协议差异
操作位置： 监控→服务管理
在 TCP 卡片点击 配置，按下表理解字段。本次只查看，不修改、不保存；查看后点击 取消。
图：TCP 配置包含端口、KeepAlive 和 SO_BACKLOG，本次未保存。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| 启用状态 | 允许或禁止该监听入口；关闭后保留配置，但不再接收新接入。；允许或禁止该监听入口；关闭后保留配置，但不再接收新接入。必填 · 推荐：保持已验证的部署值 · 示例：以现场值为准 |
| 端口 | 监听入口端口，范围 1–65535；应使用部署规划中未冲突的端口。；监听入口端口，范围 1–65535；应使用部署规划中未冲突的端口。必填 · 推荐：保持已验证的部署值 · 示例：以现场值为准 |
| KeepAlive | TCP 连接连续无读写的空闲检测间隔，单位秒；页面范围 1–86400。并非每隔该时间自动发送心跳包。；TCP 连接连续无读写的空闲检测间隔，单位秒；页面范围 1–86400。并非每隔该时间自动发送心跳包。必填 · 推荐：保持已验证的部署值 · 示例：以现场值为准 |
| SO_BACKLOG | 等待完成连接建立的队列容量，范围 1–65535；不是在线设备数上限。；等待完成连接建立的队列容量，范围 1–65535；不是在线设备数上限。必填 · 推荐：保持已验证的部署值 · 示例：以现场值为准 |
| 立即重绑 | 保存时释放并重新绑定入口；MQTT TCP、WebSocket、TCP 必要时会先断开该节点旧连接。；保存时释放并重新绑定入口；MQTT TCP、WebSocket、TCP 必要时会先断开该节点旧连接。选填 · 推荐：维护窗口内按影响评估决定，不为试验而切换 · 示例：以现场值为准 |
15. 查看 UDP 配置与协议差异
操作位置： 监控→服务管理
在 UDP 卡片点击 配置，按下表理解字段。本次只查看，不修改、不保存；查看后点击 取消。
图：UDP 配置使用 SO_RCVBUF，不套用 TCP 的 KeepAlive 或 SO_BACKLOG。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| 启用状态 | 允许或禁止该监听入口；关闭后保留配置，但不再接收新接入。；允许或禁止该监听入口；关闭后保留配置，但不再接收新接入。必填 · 推荐：保持已验证的部署值 · 示例：以现场值为准 |
| 端口 | 监听入口端口，范围 1–65535；应使用部署规划中未冲突的端口。；监听入口端口，范围 1–65535；应使用部署规划中未冲突的端口。必填 · 推荐：保持已验证的部署值 · 示例：以现场值为准 |
| SO_RCVBUF | UDP 接收缓冲区大小，单位字节；页面范围 1024–134217728（128 MiB），实际分配受系统限制。；UDP 接收缓冲区大小，单位字节；页面范围 1024–134217728（128 MiB），实际分配受系统限制。必填 · 推荐：保持已验证的部署值 · 示例：以现场值为准 |
| 立即重绑 | 保存时释放并重新绑定入口；MQTT TCP、WebSocket、TCP 必要时会先断开该节点旧连接。；保存时释放并重新绑定入口；MQTT TCP、WebSocket、TCP 必要时会先断开该节点旧连接。选填 · 推荐：维护窗口内按影响评估决定，不为试验而切换 · 示例：以现场值为准 |
16. 查看 Cluster TCP 配置与协议差异
操作位置： 监控→服务管理
在 Cluster TCP 卡片点击 配置，按下表理解字段。本次只查看，不修改、不保存；查看后点击 取消。
图：Cluster TCP 只在当前节点修改运行时端口；端口变更时立即重绑会先断开旧连接再切换。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| 启用状态 | 允许或禁止该监听入口；关闭后保留配置，但不再接收新接入。；允许或禁止该监听入口；关闭后保留配置，但不再接收新接入。必填 · 推荐：保持已验证的部署值 · 示例：以现场值为准 |
| 端口 | 监听入口端口，范围 1–65535；应使用部署规划中未冲突的端口。；监听入口端口，范围 1–65535；应使用部署规划中未冲突的端口。必填 · 推荐：保持已验证的部署值 · 示例：以现场值为准 |
| 立即重绑 | 保存时释放并重新绑定入口；MQTT TCP、WebSocket、TCP 必要时会先断开该节点旧连接。；保存时释放并重新绑定入口；MQTT TCP、WebSocket、TCP 必要时会先断开该节点旧连接。选填 · 推荐：维护窗口内按影响评估决定，不为试验而切换 · 示例：以现场值为准 |
17. 理解保存、重绑与生效边界
操作位置： 监控→服务管理
实际维护时先确认节点和字段，再评估 立即重绑，最后才点击 保存运行时配置。本次只展示保存前面板，未点击保存。
图：保存前先核对立即重绑风险和目标节点；本次没有点击保存运行时配置。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| 立即重绑 | 保存时释放并重新绑定入口；MQTT TCP、WebSocket、TCP 必要时会先断开该节点旧连接。；保存时释放并重新绑定入口；MQTT TCP、WebSocket、TCP 必要时会先断开该节点旧连接。选填 · 推荐：维护窗口内按影响评估决定，不为试验而切换 · 示例：以现场值为准 |
操作边界
预期结果（未执行）：预期：校验通过后请求目标节点应用配置，并返回反馈；还应刷新核对端点和状态。保存请求可能使已停止但启用的入口启动。 风险与恢复：运行中表单会提交端口等重绑字段；当前源码可能要求立即重绑，即便值未改。不要为查看反馈试点保存。失败时先读取错误，再由运维核对端口、节点和原配置。
18. 理解启动确认
操作位置： 监控→服务管理
在适用监听器卡片点击 启动，核对确认框的节点、端点与影响范围。本次点击 取消，不点击“确认启动”。
图：确认框会再次列出目标节点、监听端点和影响范围；本次只查看并取消，没有启动监听器。
操作边界
预期结果（未执行）：预期：目标监听器绑定入口，刷新后应显示运行中；不等于已有设备连上。 风险与恢复：入口未启用、端口冲突或节点离线可能导致失败；先读反馈，不要反复确认。
19. 理解停止确认
操作位置： 监控→服务管理
在适用监听器卡片点击 停止，核对确认框的节点、端点与影响范围。本次点击 取消，不点击“确认停止”。
图：停止只关闭当前节点的新连接入口，默认不踢掉已建立连接；本次只查看并取消，没有停止监听器。
操作边界
预期结果（未执行）：预期：目标入口停止接收新接入；MQTT/TCP 已建立连接不默认主动断开，UDP 报文接收会受到影响。 风险与恢复：停止非目标入口会影响业务；恢复前核对节点和端口，再按维护流程启动。
20. 理解重启确认
操作位置： 监控→服务管理
在适用监听器卡片点击 重启，核对确认框的节点、端点与影响范围。本次点击 取消，不点击“确认重启”。
图：重启会在当前节点先释放监听再重新绑定，短时间影响新连接；本次只查看并取消，没有重启监听器。
操作边界
预期结果（未执行）：预期：先释放目标入口再重新绑定，期间新连接或报文可能无法进入；完成后需刷新核对。 风险与恢复：重启不是无损操作；失败时检查端口、服务日志和原配置，不能只凭按钮点击判定完成。
21. 操作后应如何检查与恢复
操作位置： 监控→服务管理
实际变更后应点击 刷新，检查节点、端点、监听状态和时间；再按业务需要验证设备接入。本次只读查看，不作为变更成功证明。
图：远端节点可以查看监听状态，但 Cluster TCP 的停止、重启和配置均禁用，应登录目标节点本地维护。
操作边界
预期结果（未执行）：预期：快照应反映目标节点真实状态。运行中只证明监听入口状态，不证明设备、上行或下行业务已经打通。 风险与恢复：节点离线时只看旧快照并恢复通信；端口冲突先查占用；远端集群通道回本地维护；HTTP 控制面走部署流程。当前源码支持部分运行配置持久化，不承诺重启后必然恢复旧值。
页面字段说明
完整参考
| 字段 / 单位 | 通俗含义 | 数据方向 / 来源 | 正常判断 | 异常信号与第一检查点 |
|---|---|---|---|---|
| 确认管理范围与刷新入口 | ||||
| 监控范围范围 | 页面以当前选中节点为范围展示运行快照；节点概览用于切换目标，不代表所有节点同步操作。 | 目标节点运行快照 → 当前页面 | 所选节点与工作区标题一致。 | 选错节点会把其他节点的状态当成本机状态。第一检查点：先核对节点名称、地址和工作区标题。 |
| 采样时间时间 | 以节点卡片的同步时间和最近快照时间判断本页数据新鲜度。 | 目标节点运行快照 → 当前页面 | 刷新后时间合理更新。 | 时间长期不变或明显早于当前巡检。第一检查点：检查节点同步、接口响应和服务器时区。 |
| 整体健康状态状态 | 结合在线节点、离线节点和失败监听器数量判断整体健康，不把单一“在线”标签当作全部正常。 | 目标节点运行快照 → 当前页面 | 所需节点在线且失败监听器为 0。 | 节点离线、监听器失败或状态与业务需要不符。第一检查点：先定位异常节点，再查看对应监听器卡片的最近错误。 |
| 仅运行时生效边界 | 说明当前入口操作的是节点正在运行的服务。 | 目标节点运行快照 → 当前页面 | 维护动作只针对选定入口。 | 把该入口当成全平台配置中心会误判影响。第一检查点：先核对目标节点。 |
| 不回写部署配置边界 | 页面声明不修改部署文件；不等于不写运行配置中心。 | 目标节点运行快照 → 当前页面 | 部署文件和运行配置记录分别维护。 | 不能据此断言重启后一定丢失设置。第一检查点：核对当前部署的运行配置中心及版本。 |
| 不自动同步其他节点边界 | 页面操作不能当作所有节点同时变更。 | 目标节点运行快照 → 当前页面 | 各节点按各自入口核对。 | 只改一个节点却期待全局改变。第一检查点：逐节点确认端点和状态。 |
| 读取节点与所选节点汇总 | ||||
| 节点总数个 | 当前快照中可见的节点数量。 | 目标节点运行快照 → 当前页面 | 与预期部署拓扑一致。 | 少于预期时可能有节点未加入或快照不完整。第一检查点：检查节点列表。 |
| 在线节点个 | 页面统计中未标记离线或断开的节点数，不等于全部健康。 | 目标节点运行快照 → 当前页面 | 结合节点卡片告警一起判断。 | 在线数量正常但仍可能有异常或告警节点。第一检查点：查看各节点状态标签。 |
| 离线个 | 被标记离线或断开的节点数。 | 目标节点运行快照 → 当前页面 | 无计划离线时通常应为 0。 | 业务节点非计划离线。第一检查点：确认主机与集群通信。 |
| 所选节点会话个 | 当前选中节点汇总的会话数量，不是全集群总量。 | 目标节点运行快照 → 当前页面 | 随该节点实际业务变化。 | 与预期设备活动长期不符。第一检查点：核对所选节点及客户端页面。 |
| 所选节点监听器个 | 所选节点返回的监听器条目数量。 | 目标节点运行快照 → 当前页面 | 与该节点启用的服务类型对应。 | 某类入口缺失。第一检查点：核对节点部署与返回快照。 |
| 运行中个 | 所选节点状态为运行中的监听器数量。 | 目标节点运行快照 → 当前页面 | 只要求业务需要的入口运行。 | 必需入口停止或缺失。第一检查点：定位对应监听器卡片。 |
| 失败个 | 所选节点状态为失败的监听器数量。 | 目标节点运行快照 → 当前页面 | 正常巡检通常为 0。 | 出现失败入口。第一检查点：读取卡片最近错误再检查端口占用。 |
| 确认节点身份与快照新鲜度 | ||||
| 节点名称标识 | 用于选择操作目标的节点身份。 | 目标节点运行快照 → 当前页面 | 与维护目标匹配。 | 名称或地址不符。第一检查点：停止后续变更并重新选择。 |
| 当前节点／远端节点类型 | 当前节点是本控制台对应节点；其他节点为远端。 | 目标节点运行快照 → 当前页面 | 操作入口与目标一致。 | 远端集群通道不可操作并非按钮故障。第一检查点：切换到该节点本地控制台。 |
| 节点地址地址 | 区分部署节点的网络地址。 | 目标节点运行快照 → 当前页面 | 与部署记录一致。 | 地址与预期不符。第一检查点：核对节点归属。 |
| 节点状态状态 | 页面区分在线、离线、异常或告警。 | 目标节点运行快照 → 当前页面 | 在线且无异常信息。 | 离线时仅能查看最近同步快照。第一检查点：先恢复节点通信再操作。 |
| 监听器个 | 此节点返回的监听入口数量。 | 目标节点运行快照 → 当前页面 | 符合该节点部署。 | 节点间差异无法解释。第一检查点：核对节点启用协议。 |
| 会话个 | 此节点的会话汇总。 | 目标节点运行快照 → 当前页面 | 与节点业务活动相符。 | 业务活跃但数量长期不符。第一检查点：打开该节点客户端查看。 |
| 同步时间时间 | 节点快照最近同步时间，不是设备最后上报时间。 | 目标节点运行快照 → 当前页面 | 随刷新及同步更新。 | 长期停留旧时间。第一检查点：检查节点同步和时区。 |
| 最近快照时间时间 | 这次页面快照的时间标识。 | 目标节点运行快照 → 当前页面 | 点击刷新后返回合理时间。 | 刷新后时间长期不变。第一检查点：检查查询、节点同步及服务器时间。 |
| 确认当前监听器工作区 | ||||
| 工作区节点名称标识 | 下方全部监听卡片属于标题所示节点。 | 目标节点运行快照 → 当前页面 | 与刚选中的节点卡片一致。 | 标题仍是其他节点。第一检查点：重新选择并等待快照加载。 |
| 当前节点／远端节点范围 | 提醒后续操作的节点归属。 | 目标节点运行快照 → 当前页面 | 按目标节点维护。 | 把远端状态误当成本机状态。第一检查点：先看标题和地址。 |
| 仅运行时生效边界 | 这里控制的是节点运行入口，不是批量全局开关。 | 目标节点运行快照 → 当前页面 | 仅处理需要维护的入口。 | 未确认影响范围就准备启停。第一检查点：先读对应操作章节。 |
| 读取 MQTT TCP 监听状态 | ||||
| MQTT 接入用途 | MQTT TCP：MQTT TCP 的页面用途分组。 | 目标节点运行快照 → 当前页面 | MQTT TCP：与实际设备或客户端接入协议一致。 | MQTT TCP：用途与正在排查的业务不符。第一检查点：MQTT TCP：换到对应协议入口检查。 |
| 运行状态状态 | MQTT TCP：区分运行中、启动中、停止中、已停止、失败和未知。 | 目标节点运行快照 → 当前页面 | MQTT TCP：只有必需服务才要求运行；停用的非业务入口可以是已停止。 | MQTT TCP：所需入口失败或长期停在过渡状态。第一检查点：MQTT TCP：刷新后读取最近错误，确认端口与节点状态。 |
| 监听端点地址:端口 | MQTT TCP：展示服务绑定的地址和端口；0.0.0.0 是绑定所有接口，不是设备应填写的目标地址。 | 目标节点运行快照 → 当前页面 | MQTT TCP：与部署和客户端配置对应。 | MQTT TCP：设备填写 0.0.0.0 或使用错误端口。第一检查点：MQTT TCP：使用实际可达的节点地址及正确端口。 |
| 当前节点口径范围 | MQTT TCP：卡片数值不是全集群合计。 | 目标节点运行快照 → 当前页面 | MQTT TCP：仅用于该节点判断。 | MQTT TCP：直接与全集群设备总数比较。第一检查点：MQTT TCP：统一节点范围后再对照。 |
| 活跃会话个 | MQTT TCP：MQTT TCP 入口归属的活跃会话数量。 | 目标节点运行快照 → 当前页面 | MQTT TCP：结合该入口实际业务判断，静默或无设备时 0 可以正常。 | MQTT TCP：有明确接入预期但数量不符。第一检查点：MQTT TCP：核对节点范围、客户端在线状态和接入地址。 |
| 运行时长时长 | MQTT TCP：监听器最近一次启动后的持续运行时间；停止时显示横线。 | 目标节点运行快照 → 当前页面 | MQTT TCP：运行中随时间增加。 | MQTT TCP：运行时长异常归零或反复变化。第一检查点：MQTT TCP：结合最近操作和服务日志确认原因。 |
| 最近操作时间 | MQTT TCP：最近一次监听器生命周期操作时间，不是设备报文时间。 | 目标节点运行快照 → 当前页面 | MQTT TCP：符合已知维护记录。 | MQTT TCP：出现无法解释的近期变化。第一检查点：MQTT TCP：核对运维操作记录。 |
| 停止时间时间 | MQTT TCP：最近停止时间；无相应记录时显示横线。 | 目标节点运行快照 → 当前页面 | MQTT TCP：与运行状态和维护记录对应。 | MQTT TCP：运行状态与时间关系异常。第一检查点：MQTT TCP：刷新快照并检查日志。 |
| 读取 MQTT WebSocket 监听状态 | ||||
| WebSocket 接入用途 | MQTT WebSocket：MQTT WebSocket 的页面用途分组。 | 目标节点运行快照 → 当前页面 | MQTT WebSocket：与实际设备或客户端接入协议一致。 | MQTT WebSocket：用途与正在排查的业务不符。第一检查点：MQTT WebSocket：换到对应协议入口检查。 |
| 运行状态状态 | MQTT WebSocket：区分运行中、启动中、停止中、已停止、失败和未知。 | 目标节点运行快照 → 当前页面 | MQTT WebSocket：只有必需服务才要求运行；停用的非业务入口可以是已停止。 | MQTT WebSocket：所需入口失败或长期停在过渡状态。第一检查点：MQTT WebSocket：刷新后读取最近错误，确认端口与节点状态。 |
| 监听端点地址:端口 | MQTT WebSocket：由监听地址、端口和 WebSocket 路径组成。 | 目标节点运行快照 → 当前页面 | MQTT WebSocket：与部署和客户端配置对应。 | MQTT WebSocket：设备填写 0.0.0.0 或使用错误端口。第一检查点：MQTT WebSocket：使用实际可达的节点地址及正确端口。 |
| 当前节点口径范围 | MQTT WebSocket：卡片数值不是全集群合计。 | 目标节点运行快照 → 当前页面 | MQTT WebSocket：仅用于该节点判断。 | MQTT WebSocket：直接与全集群设备总数比较。第一检查点：MQTT WebSocket：统一节点范围后再对照。 |
| 活跃会话个 | MQTT WebSocket：MQTT WebSocket 入口归属的活跃会话数量。 | 目标节点运行快照 → 当前页面 | MQTT WebSocket：结合该入口实际业务判断，静默或无设备时 0 可以正常。 | MQTT WebSocket：有明确接入预期但数量不符。第一检查点：MQTT WebSocket：核对节点范围、客户端在线状态和接入地址。 |
| 运行时长时长 | MQTT WebSocket：监听器最近一次启动后的持续运行时间；停止时显示横线。 | 目标节点运行快照 → 当前页面 | MQTT WebSocket：运行中随时间增加。 | MQTT WebSocket：运行时长异常归零或反复变化。第一检查点：MQTT WebSocket：结合最近操作和服务日志确认原因。 |
| 最近操作时间 | MQTT WebSocket：最近一次监听器生命周期操作时间，不是设备报文时间。 | 目标节点运行快照 → 当前页面 | MQTT WebSocket：符合已知维护记录。 | MQTT WebSocket：出现无法解释的近期变化。第一检查点：MQTT WebSocket：核对运维操作记录。 |
| 停止时间时间 | MQTT WebSocket：最近停止时间；无相应记录时显示横线。 | 目标节点运行快照 → 当前页面 | MQTT WebSocket：与运行状态和维护记录对应。 | MQTT WebSocket：运行状态与时间关系异常。第一检查点：MQTT WebSocket：刷新快照并检查日志。 |
| 读取 TCP 监听状态 | ||||
| TCP 接入用途 | TCP：TCP 的页面用途分组。 | 目标节点运行快照 → 当前页面 | TCP：与实际设备或客户端接入协议一致。 | TCP：用途与正在排查的业务不符。第一检查点：TCP：换到对应协议入口检查。 |
| 运行状态状态 | TCP：区分运行中、启动中、停止中、已停止、失败和未知。 | 目标节点运行快照 → 当前页面 | TCP：只有必需服务才要求运行；停用的非业务入口可以是已停止。 | TCP：所需入口失败或长期停在过渡状态。第一检查点：TCP：刷新后读取最近错误，确认端口与节点状态。 |
| 监听端点地址:端口 | TCP：展示服务绑定的地址和端口；0.0.0.0 是绑定所有接口，不是设备应填写的目标地址。 | 目标节点运行快照 → 当前页面 | TCP：与部署和客户端配置对应。 | TCP：设备填写 0.0.0.0 或使用错误端口。第一检查点：TCP：使用实际可达的节点地址及正确端口。 |
| 当前节点口径范围 | TCP：卡片数值不是全集群合计。 | 目标节点运行快照 → 当前页面 | TCP：仅用于该节点判断。 | TCP：直接与全集群设备总数比较。第一检查点：TCP：统一节点范围后再对照。 |
| 活跃会话个 | TCP：TCP 入口归属的活跃会话数量。 | 目标节点运行快照 → 当前页面 | TCP：结合该入口实际业务判断，静默或无设备时 0 可以正常。 | TCP：有明确接入预期但数量不符。第一检查点：TCP：核对节点范围、客户端在线状态和接入地址。 |
| 运行时长时长 | TCP：监听器最近一次启动后的持续运行时间；停止时显示横线。 | 目标节点运行快照 → 当前页面 | TCP：运行中随时间增加。 | TCP：运行时长异常归零或反复变化。第一检查点：TCP：结合最近操作和服务日志确认原因。 |
| 最近操作时间 | TCP：最近一次监听器生命周期操作时间，不是设备报文时间。 | 目标节点运行快照 → 当前页面 | TCP：符合已知维护记录。 | TCP：出现无法解释的近期变化。第一检查点：TCP：核对运维操作记录。 |
| 停止时间时间 | TCP：最近停止时间；无相应记录时显示横线。 | 目标节点运行快照 → 当前页面 | TCP：与运行状态和维护记录对应。 | TCP：运行状态与时间关系异常。第一检查点：TCP：刷新快照并检查日志。 |
| 读取 UDP 监听状态 | ||||
| UDP 接入用途 | UDP：UDP 的页面用途分组。 | 目标节点运行快照 → 当前页面 | UDP：与实际设备或客户端接入协议一致。 | UDP：用途与正在排查的业务不符。第一检查点：UDP：换到对应协议入口检查。 |
| 运行状态状态 | UDP：区分运行中、启动中、停止中、已停止、失败和未知。 | 目标节点运行快照 → 当前页面 | UDP：只有必需服务才要求运行；停用的非业务入口可以是已停止。 | UDP：所需入口失败或长期停在过渡状态。第一检查点：UDP：刷新后读取最近错误，确认端口与节点状态。 |
| 监听端点地址:端口 | UDP：展示服务绑定的地址和端口；0.0.0.0 是绑定所有接口，不是设备应填写的目标地址。 | 目标节点运行快照 → 当前页面 | UDP：与部署和客户端配置对应。 | UDP：设备填写 0.0.0.0 或使用错误端口。第一检查点：UDP：使用实际可达的节点地址及正确端口。 |
| 当前节点口径范围 | UDP：卡片数值不是全集群合计。 | 目标节点运行快照 → 当前页面 | UDP：仅用于该节点判断。 | UDP：直接与全集群设备总数比较。第一检查点：UDP：统一节点范围后再对照。 |
| 活跃会话个 | UDP：UDP 逻辑会话数量，不代表建立了 TCP 式连接。 | 目标节点运行快照 → 当前页面 | UDP：结合该入口实际业务判断，静默或无设备时 0 可以正常。 | UDP：有明确接入预期但数量不符。第一检查点：UDP：核对节点范围、客户端在线状态和接入地址。 |
| 运行时长时长 | UDP：监听器最近一次启动后的持续运行时间；停止时显示横线。 | 目标节点运行快照 → 当前页面 | UDP：运行中随时间增加。 | UDP：运行时长异常归零或反复变化。第一检查点：UDP：结合最近操作和服务日志确认原因。 |
| 最近操作时间 | UDP：最近一次监听器生命周期操作时间，不是设备报文时间。 | 目标节点运行快照 → 当前页面 | UDP：符合已知维护记录。 | UDP：出现无法解释的近期变化。第一检查点：UDP：核对运维操作记录。 |
| 停止时间时间 | UDP：最近停止时间；无相应记录时显示横线。 | 目标节点运行快照 → 当前页面 | UDP：与运行状态和维护记录对应。 | UDP：运行状态与时间关系异常。第一检查点：UDP：刷新快照并检查日志。 |
| 读取 Cluster TCP 监听状态 | ||||
| 集群通道用途 | Cluster TCP：Cluster TCP 的页面用途分组。 | 目标节点运行快照 → 当前页面 | Cluster TCP：用于节点间协同，不是设备业务入口。 | Cluster TCP：用途与正在排查的业务不符。第一检查点：Cluster TCP：换到对应协议入口检查。 |
| 运行状态状态 | Cluster TCP：区分运行中、启动中、停止中、已停止、失败和未知。 | 目标节点运行快照 → 当前页面 | Cluster TCP：只有必需服务才要求运行；停用的非业务入口可以是已停止。 | Cluster TCP：所需入口失败或长期停在过渡状态。第一检查点：Cluster TCP：刷新后读取最近错误，确认端口与节点状态。 |
| 监听端点地址:端口 | Cluster TCP：展示服务绑定的地址和端口；0.0.0.0 是绑定所有接口，不是设备应填写的目标地址。 | 目标节点运行快照 → 当前页面 | Cluster TCP：与部署和客户端配置对应。 | Cluster TCP：设备填写 0.0.0.0 或使用错误端口。第一检查点：Cluster TCP：使用实际可达的节点地址及正确端口。 |
| 当前节点口径范围 | Cluster TCP：卡片数值不是全集群合计。 | 目标节点运行快照 → 当前页面 | Cluster TCP：仅用于该节点判断。 | Cluster TCP：直接与全集群设备总数比较。第一检查点：Cluster TCP：统一节点范围后再对照。 |
| 活跃会话个 | Cluster TCP：集群通道卡片返回的会话数，不能替代集群健康判断。 | 目标节点运行快照 → 当前页面 | Cluster TCP：结合该入口实际业务判断，静默或无设备时 0 可以正常。 | Cluster TCP：有明确接入预期但数量不符。第一检查点：Cluster TCP：核对节点范围、客户端在线状态和接入地址。 |
| 运行时长时长 | Cluster TCP：监听器最近一次启动后的持续运行时间；停止时显示横线。 | 目标节点运行快照 → 当前页面 | Cluster TCP：运行中随时间增加。 | Cluster TCP：运行时长异常归零或反复变化。第一检查点：Cluster TCP：结合最近操作和服务日志确认原因。 |
| 最近操作时间 | Cluster TCP：最近一次监听器生命周期操作时间，不是设备报文时间。 | 目标节点运行快照 → 当前页面 | Cluster TCP：符合已知维护记录。 | Cluster TCP：出现无法解释的近期变化。第一检查点：Cluster TCP：核对运维操作记录。 |
| 停止时间时间 | Cluster TCP：最近停止时间；无相应记录时显示横线。 | 目标节点运行快照 → 当前页面 | Cluster TCP：与运行状态和维护记录对应。 | Cluster TCP：运行状态与时间关系异常。第一检查点：Cluster TCP：刷新快照并检查日志。 |
| 不持久化边界 | Cluster TCP：集群通道卡片明确标出的配置持久化限制。 | 目标节点运行快照 → 当前页面 | Cluster TCP：需长期保留的设置由部署维护。 | Cluster TCP：期望仅靠本页修改跨重启长期保留。第一检查点：Cluster TCP：由运维核对部署配置。 |
| 读取 HTTP Control Plane 只读状态 | ||||
| 管理接口用途 | HTTP Control Plane：HTTP Control Plane 的页面用途分组。 | 目标节点运行快照 → 当前页面 | HTTP Control Plane：用于控制台管理和观测。 | HTTP Control Plane：用途与正在排查的业务不符。第一检查点：HTTP Control Plane：换到对应协议入口检查。 |
| 运行状态状态 | HTTP Control Plane：区分运行中、启动中、停止中、已停止、失败和未知。 | 目标节点运行快照 → 当前页面 | HTTP Control Plane：只有必需服务才要求运行；停用的非业务入口可以是已停止。 | HTTP Control Plane：所需入口失败或长期停在过渡状态。第一检查点：HTTP Control Plane：刷新后读取最近错误，确认端口与节点状态。 |
| 监听端点地址:端口 | HTTP Control Plane：展示服务绑定的地址和端口；0.0.0.0 是绑定所有接口，不是设备应填写的目标地址。 | 目标节点运行快照 → 当前页面 | HTTP Control Plane：与部署和客户端配置对应。 | HTTP Control Plane：设备填写 0.0.0.0 或使用错误端口。第一检查点：HTTP Control Plane：使用实际可达的节点地址及正确端口。 |
| 当前节点口径范围 | HTTP Control Plane：卡片数值不是全集群合计。 | 目标节点运行快照 → 当前页面 | HTTP Control Plane：仅用于该节点判断。 | HTTP Control Plane：直接与全集群设备总数比较。第一检查点：HTTP Control Plane：统一节点范围后再对照。 |
| 活跃会话个 | HTTP Control Plane：管理接口不应按设备连接数解释；0 不代表控制台不可用。 | 目标节点运行快照 → 当前页面 | HTTP Control Plane：结合该入口实际业务判断，静默或无设备时 0 可以正常。 | HTTP Control Plane：有明确接入预期但数量不符。第一检查点：HTTP Control Plane：核对控制台可达性和节点健康。 |
| 运行时长时长 | HTTP Control Plane：当前源码固定返回 0，不能用它判断 HTTP 刚重启。 | 目标节点运行快照 → 当前页面 | HTTP Control Plane：只作为页面展示值，不作重启判断。 | HTTP Control Plane：运行时长异常归零或反复变化。第一检查点：HTTP Control Plane：结合最近操作和服务日志确认原因。 |
| 最近操作时间 | HTTP Control Plane：最近一次监听器生命周期操作时间，不是设备报文时间。 | 目标节点运行快照 → 当前页面 | HTTP Control Plane：符合已知维护记录。 | HTTP Control Plane：出现无法解释的近期变化。第一检查点：HTTP Control Plane：核对运维操作记录。 |
| 停止时间时间 | HTTP Control Plane：最近停止时间；无相应记录时显示横线。 | 目标节点运行快照 → 当前页面 | HTTP Control Plane：与运行状态和维护记录对应。 | HTTP Control Plane：运行状态与时间关系异常。第一检查点：HTTP Control Plane：刷新快照并检查日志。 |
| 只读权限 | HTTP Control Plane：本页不提供 HTTP 控制面的启停与配置。 | 目标节点运行快照 → 当前页面 | HTTP Control Plane：没有操作按钮是设计限制。 | HTTP Control Plane：把没有按钮当成服务故障。第一检查点：HTTP Control Plane：需要变更时走部署维护流程。 |
服务管理与配置面板
完整参考
| 字段/控件 | 用途说明 | 默认/推荐/示例 | 选项说明 | 作用与影响 | 生效条件 |
|---|---|---|---|---|---|
| 服务管理 | 从监控菜单进入监听器页面。 | 默认：以当前面板为准推荐：保持已验证的部署值示例：以现场值为准 | 不适用 | 从监控菜单进入监听器页面。 | 范围：所选节点；部署文件与运行配置中心的保存行为分别判断发布：不需要 · 重启：不需要 · 重连：不需要 |
| 刷新 | 重新请求节点与监听器快照，不修改配置。 | 默认：以当前面板为准推荐：保持已验证的部署值示例：以现场值为准 | 不适用 | 重新请求节点与监听器快照，不修改配置。 | 范围：所选节点；部署文件与运行配置中心的保存行为分别判断发布：不需要 · 重启：不需要 · 重连：不需要 |
| 节点卡片 | 切换下方工作区的目标节点，不是切换全集群总开关。 | 默认：以当前面板为准推荐：保持已验证的部署值示例：以现场值为准 | 不适用 | 切换下方工作区的目标节点，不是切换全集群总开关。 | 范围：所选节点；部署文件与运行配置中心的保存行为分别判断发布：不需要 · 重启：不需要 · 重连：不需要 |
| 取消／关闭 | 退出配置面板或确认框，不提交当前表单。 | 默认：以当前面板为准推荐：保持已验证的部署值示例：以现场值为准 | 不适用 | 退出配置面板或确认框，不提交当前表单。 | 范围：所选节点；部署文件与运行配置中心的保存行为分别判断发布：不需要 · 重启：不需要 · 重连：不需要 |
| 配置 | 打开对应监听器的运行时配置面板，打开本身不会保存。 | 默认：以当前面板为准推荐：保持已验证的部署值示例：以现场值为准 | 不适用 | 打开对应监听器的运行时配置面板，打开本身不会保存。 | 范围：所选节点；部署文件与运行配置中心的保存行为分别判断发布：不需要 · 重启：不需要 · 重连：不需要 |
| 保存运行时配置 | 校验表单后提交目标节点配置；可能触发重绑或启动，不能把保存当作无影响动作。 | 默认：以当前面板为准推荐：保持已验证的部署值示例：以现场值为准 | 不适用 | 校验表单后提交目标节点配置；可能触发重绑或启动，不能把保存当作无影响动作。 | 范围：所选节点；部署文件与运行配置中心的保存行为分别判断发布：不需要 · 重启：不需要 · 重连：需要 |
| 启动／确认启动 | 启动按钮先打开确认框；确认启动才尝试绑定端口并接收连接或报文。 | 默认：以当前面板为准推荐：保持已验证的部署值示例：以现场值为准 | 不适用 | 启动按钮先打开确认框；确认启动才尝试绑定端口并接收连接或报文。 | 范围：所选节点；部署文件与运行配置中心的保存行为分别判断发布：不需要 · 重启：不需要 · 重连：不需要 |
| 停止／确认停止 | 停止按钮先打开确认框；确认后释放入口，不应把不默认断开旧 TCP 连接理解为所有协议都无影响。 | 默认：以当前面板为准推荐：保持已验证的部署值示例：以现场值为准 | 不适用 | 停止按钮先打开确认框；确认后释放入口，不应把不默认断开旧 TCP 连接理解为所有协议都无影响。 | 范围：所选节点；部署文件与运行配置中心的保存行为分别判断发布：不需要 · 重启：不需要 · 重连：不需要 |
| 重启／确认重启 | 确认后先停止监听再启动，期间新连接或 UDP 报文可能无法进入。 | 默认：以当前面板为准推荐：保持已验证的部署值示例：以现场值为准 | 不适用 | 确认后先停止监听再启动，期间新连接或 UDP 报文可能无法进入。 | 范围：所选节点；部署文件与运行配置中心的保存行为分别判断发布：不需要 · 重启：不需要 · 重连：需要 |
| 必填 启用状态 | 允许或禁止该监听入口；关闭后保留配置，但不再接收新接入。 | 默认：以当前面板为准推荐：保持已验证的部署值示例：以现场值为准 | 已启用：已启用；已启用已停用：已停用；已停用 | 允许或禁止该监听入口；关闭后保留配置，但不再接收新接入。 | 范围：所选节点；部署文件与运行配置中心的保存行为分别判断发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 端口 | 监听入口端口，范围 1–65535；应使用部署规划中未冲突的端口。 | 默认：以当前面板为准推荐：保持已验证的部署值示例：以现场值为准 | 不适用 | 监听入口端口，范围 1–65535；应使用部署规划中未冲突的端口。 | 范围：所选节点；部署文件与运行配置中心的保存行为分别判断发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 KeepAlive | 页面可读写的 MQTT KeepAlive 配置。当前源码实际连接空闲超时取自客户端 CONNECT 心跳值的 1.5 倍，不能承诺修改此字段会改变设备心跳。 | 默认：以当前面板为准推荐：保持已验证的部署值示例：以现场值为准 | 不适用 | 页面可读写的 MQTT KeepAlive 配置。当前源码实际连接空闲超时取自客户端 CONNECT 心跳值的 1.5 倍，不能承诺修改此字段会改变设备心跳。 | 范围：所选节点；部署文件与运行配置中心的保存行为分别判断发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 SO_BACKLOG | 等待完成连接建立的队列容量，范围 1–65535；不是在线设备数上限。 | 默认：以当前面板为准推荐：保持已验证的部署值示例：以现场值为准 | 不适用 | 等待完成连接建立的队列容量，范围 1–65535；不是在线设备数上限。 | 范围：所选节点；部署文件与运行配置中心的保存行为分别判断发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 最大报文大小 | MQTT 解码允许的单报文大小，单位字节；页面范围 1024–67108864（64 MiB）。 | 默认：以当前面板为准推荐：保持已验证的部署值示例：以现场值为准 | 不适用 | MQTT 解码允许的单报文大小，单位字节；页面范围 1024–67108864（64 MiB）。 | 范围：所选节点；部署文件与运行配置中心的保存行为分别判断发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 SO_KEEPALIVE | 是否开启操作系统 TCP 保活；不等同于 MQTT PING 心跳间隔。 | 默认：以当前面板为准推荐：保持已验证的部署值示例：以现场值为准 | 已开启：已开启；已开启已关闭：已关闭；已关闭 | 是否开启操作系统 TCP 保活；不等同于 MQTT PING 心跳间隔。 | 范围：所选节点；部署文件与运行配置中心的保存行为分别判断发布：不需要 · 重启：不需要 · 重连：不需要 |
| 立即重绑 | 保存时释放并重新绑定入口；MQTT TCP、WebSocket、TCP 必要时会先断开该节点旧连接。 | 默认：当前源码：运行中默认勾选，停止状态默认不勾选推荐：维护窗口内按影响评估决定，不为试验而切换示例：以现场值为准 | 勾选：勾选；勾选不勾选：不勾选；不勾选 | 保存时释放并重新绑定入口；MQTT TCP、WebSocket、TCP 必要时会先断开该节点旧连接。 | 范围：所选节点；部署文件与运行配置中心的保存行为分别判断发布：不需要 · 重启：不需要 · 重连：需要 |
| 必填 启用状态 | 允许或禁止该监听入口；关闭后保留配置，但不再接收新接入。 | 默认：以当前面板为准推荐：保持已验证的部署值示例：以现场值为准 | 已启用：已启用；已启用已停用：已停用；已停用 | 允许或禁止该监听入口；关闭后保留配置，但不再接收新接入。 | 范围：所选节点；部署文件与运行配置中心的保存行为分别判断发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 端口 | 监听入口端口，范围 1–65535；应使用部署规划中未冲突的端口。 | 默认：以当前面板为准推荐：保持已验证的部署值示例：以现场值为准 | 不适用 | 监听入口端口，范围 1–65535；应使用部署规划中未冲突的端口。 | 范围：所选节点；部署文件与运行配置中心的保存行为分别判断发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 WebSocket Path | 浏览器 MQTT 客户端的接入路径；不能为空，未以 / 开头时页面会补齐。 | 默认：以当前面板为准推荐：与客户端完全一致，例如 /mqtt示例：以现场值为准 | 不适用 | 浏览器 MQTT 客户端的接入路径；不能为空，未以 / 开头时页面会补齐。 | 范围：所选节点；部署文件与运行配置中心的保存行为分别判断发布：不需要 · 重启：不需要 · 重连：不需要 |
| 立即重绑 | 保存时释放并重新绑定入口；MQTT TCP、WebSocket、TCP 必要时会先断开该节点旧连接。 | 默认：当前源码：运行中默认勾选，停止状态默认不勾选推荐：维护窗口内按影响评估决定，不为试验而切换示例：以现场值为准 | 勾选：勾选；勾选不勾选：不勾选；不勾选 | 保存时释放并重新绑定入口；MQTT TCP、WebSocket、TCP 必要时会先断开该节点旧连接。 | 范围：所选节点；部署文件与运行配置中心的保存行为分别判断发布：不需要 · 重启：不需要 · 重连：需要 |
| 必填 启用状态 | 允许或禁止该监听入口；关闭后保留配置，但不再接收新接入。 | 默认：以当前面板为准推荐：保持已验证的部署值示例：以现场值为准 | 已启用：已启用；已启用已停用：已停用；已停用 | 允许或禁止该监听入口；关闭后保留配置，但不再接收新接入。 | 范围：所选节点；部署文件与运行配置中心的保存行为分别判断发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 端口 | 监听入口端口，范围 1–65535；应使用部署规划中未冲突的端口。 | 默认：以当前面板为准推荐：保持已验证的部署值示例：以现场值为准 | 不适用 | 监听入口端口，范围 1–65535；应使用部署规划中未冲突的端口。 | 范围：所选节点；部署文件与运行配置中心的保存行为分别判断发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 KeepAlive | TCP 连接连续无读写的空闲检测间隔，单位秒；页面范围 1–86400。并非每隔该时间自动发送心跳包。 | 默认：以当前面板为准推荐：保持已验证的部署值示例：以现场值为准 | 不适用 | TCP 连接连续无读写的空闲检测间隔，单位秒；页面范围 1–86400。并非每隔该时间自动发送心跳包。 | 范围：所选节点；部署文件与运行配置中心的保存行为分别判断发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 SO_BACKLOG | 等待完成连接建立的队列容量，范围 1–65535；不是在线设备数上限。 | 默认：以当前面板为准推荐：保持已验证的部署值示例：以现场值为准 | 不适用 | 等待完成连接建立的队列容量，范围 1–65535；不是在线设备数上限。 | 范围：所选节点；部署文件与运行配置中心的保存行为分别判断发布：不需要 · 重启：不需要 · 重连：不需要 |
| 立即重绑 | 保存时释放并重新绑定入口；MQTT TCP、WebSocket、TCP 必要时会先断开该节点旧连接。 | 默认：当前源码：运行中默认勾选，停止状态默认不勾选推荐：维护窗口内按影响评估决定，不为试验而切换示例：以现场值为准 | 勾选：勾选；勾选不勾选：不勾选；不勾选 | 保存时释放并重新绑定入口；MQTT TCP、WebSocket、TCP 必要时会先断开该节点旧连接。 | 范围：所选节点；部署文件与运行配置中心的保存行为分别判断发布：不需要 · 重启：不需要 · 重连：需要 |
| 必填 启用状态 | 允许或禁止该监听入口；关闭后保留配置，但不再接收新接入。 | 默认：以当前面板为准推荐：保持已验证的部署值示例：以现场值为准 | 已启用：已启用；已启用已停用：已停用；已停用 | 允许或禁止该监听入口；关闭后保留配置，但不再接收新接入。 | 范围：所选节点；部署文件与运行配置中心的保存行为分别判断发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 端口 | 监听入口端口，范围 1–65535；应使用部署规划中未冲突的端口。 | 默认：以当前面板为准推荐：保持已验证的部署值示例：以现场值为准 | 不适用 | 监听入口端口，范围 1–65535；应使用部署规划中未冲突的端口。 | 范围：所选节点；部署文件与运行配置中心的保存行为分别判断发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 SO_RCVBUF | UDP 接收缓冲区大小，单位字节；页面范围 1024–134217728（128 MiB），实际分配受系统限制。 | 默认：以当前面板为准推荐：保持已验证的部署值示例：以现场值为准 | 不适用 | UDP 接收缓冲区大小，单位字节；页面范围 1024–134217728（128 MiB），实际分配受系统限制。 | 范围：所选节点；部署文件与运行配置中心的保存行为分别判断发布：不需要 · 重启：不需要 · 重连：不需要 |
| 立即重绑 | 保存时释放并重新绑定入口；MQTT TCP、WebSocket、TCP 必要时会先断开该节点旧连接。 | 默认：当前源码：运行中默认勾选，停止状态默认不勾选推荐：维护窗口内按影响评估决定，不为试验而切换示例：以现场值为准 | 勾选：勾选；勾选不勾选：不勾选；不勾选 | 保存时释放并重新绑定入口；MQTT TCP、WebSocket、TCP 必要时会先断开该节点旧连接。 | 范围：所选节点；部署文件与运行配置中心的保存行为分别判断发布：不需要 · 重启：不需要 · 重连：需要 |
| 必填 启用状态 | 允许或禁止该监听入口；关闭后保留配置，但不再接收新接入。 | 默认：以当前面板为准推荐：保持已验证的部署值示例：以现场值为准 | 已启用：已启用；已启用已停用：已停用；已停用 | 允许或禁止该监听入口；关闭后保留配置，但不再接收新接入。 | 范围：所选节点；部署文件与运行配置中心的保存行为分别判断发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 端口 | 监听入口端口，范围 1–65535；应使用部署规划中未冲突的端口。 | 默认：以当前面板为准推荐：保持已验证的部署值示例：以现场值为准 | 不适用 | 监听入口端口，范围 1–65535；应使用部署规划中未冲突的端口。 | 范围：所选节点；部署文件与运行配置中心的保存行为分别判断发布：不需要 · 重启：不需要 · 重连：不需要 |
| 立即重绑 | 保存时释放并重新绑定入口；MQTT TCP、WebSocket、TCP 必要时会先断开该节点旧连接。 | 默认：当前源码：运行中默认勾选，停止状态默认不勾选推荐：维护窗口内按影响评估决定，不为试验而切换示例：以现场值为准 | 勾选：勾选；勾选不勾选：不勾选；不勾选 | 保存时释放并重新绑定入口；MQTT TCP、WebSocket、TCP 必要时会先断开该节点旧连接。 | 范围：所选节点；部署文件与运行配置中心的保存行为分别判断发布：不需要 · 重启：不需要 · 重连：需要 |
生产操作提示
截图和示例用于说明操作位置与判断方法，不代表当前生产状态。涉及发布、启停、重绑、重试或删除时，应先确认目标环境、影响范围和恢复方案，并由授权人员执行。
蜂信物联（FastBee） · FMQ 操作手册