FMQ 运行配置中心
完整解释运行配置中心页面、28 个字段、保存方式、生效范围、重绑风险、只读边界、缓存刷新和审计检查。
阅读方法
先确认入口、权限和目标对象，再按编号完成操作。每一步都包含预期结果；详细字段和选项收在可展开的参考表中。
截图说明
截图来自原始操作手册。公开版会隐藏真实节点地址、连接地址和凭据；示例中的状态、时间和数据不代表当前生产环境。
开始前准备
| 项目 | 说明 |
|---|---|
| 能做什么 | 先读懂 8 个模块和 28 个字段，再按生效方式区分普通保存、开关即保存、监听器重绑和只读启动项。 |
| 从哪里进入 | 设备 → 运行配置中心 |
| 需要权限 | 已登录 FMQ 控制台；写操作须由授权人员在维护窗口执行。 |
| 预计时间 | 18 分钟 |
操作步骤
1. 页面范围与配置统计
操作位置： 设备→运行配置中心
进入 运行配置中心，先读取当前节点、缓存时间和 5 张统计卡，再查看模块分组。
图：真实页面首屏，先确认当前节点、缓存时间和配置统计。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| 当前节点 | 说明本页正在读取哪个 FMQ 节点的节点级配置。 |
| 整体健康状态（本页不提供） | 运行配置中心只展示配置和值，不计算监听器或业务链路的整体健康状态。 |
| 缓存刷新时间 | 显示页面最近一次读取配置后的时间。 |
| 其他节点感知延迟 | 提示全局配置由其他节点最多约 5 秒后通过周期刷新感知。 |
| 功能模块 | 当前页面按服务聚合出的模块数量。 |
| 纳入字段 | 运行配置白名单中在页面展示的字段总数。 |
| 可前端修改 | 允许在运行配置中心提交的字段数量。 |
| 节点级字段 | 只作用于指定 FMQ 节点的监听器字段数量。 |
| 需重绑字段 | 变更后需要立即重绑或等待监听器下次重启的字段数量。 |
2. MQTT TCP 基础配置
操作位置： 设备→运行配置中心
选择对应模块，读取 MQTT TCP 基础配置 的当前值、默认值、生效方式和风险提示；本次不编辑、不保存。
图：真实运行配置中心的MQTT TCP 基础配置；图下逐项解释本区字段。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| MQTT TCP 启用状态 | 决定 MQTT TCP 监听器是否允许启动；切换会直接保存。 当前页面值为“true”，默认值为“true”，生效方式为“立即生效”。 |
| MQTT TCP 端口 | MQTT TCP 对外监听端口，设备连接地址必须与它一致。 当前页面值为“1884”，默认值为“1884”，生效方式为“需重绑监听器”。 |
| MQTT 默认心跳 | 客户端未声明心跳时使用的默认保活时间。 当前页面值为“60”，默认值为“60”，生效方式为“立即生效”。 |
| MQTT 连接等待队列 | TCP 握手完成后等待应用接收的连接队列长度。 当前页面值为“1024”，默认值为“1024”，生效方式为“需重绑监听器”。 |
| MQTT Socket KeepAlive | 开启操作系统 TCP keepalive，仅影响重新绑定后的监听器。 当前页面值为“true”，默认值为“true”，生效方式为“需重绑监听器”。 |
3. MQTT 载荷与 WebSocket 配置
操作位置： 设备→运行配置中心
选择对应模块，读取 MQTT 载荷与 WebSocket 配置 的当前值、默认值、生效方式和风险提示；本次不编辑、不保存。
图：真实运行配置中心的MQTT 载荷与 WebSocket 配置；图下逐项解释本区字段。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| MQTT 最大载荷 | 限制单个 MQTT 报文允许的最大字节数。 当前页面值为“8092”，默认值为“8092”，生效方式为“立即生效”。 |
| MQTT WebSocket 启用状态 | 决定浏览器或 WebSocket MQTT 客户端是否可接入。 当前页面值为“false”，默认值为“false”，生效方式为“立即生效”。 |
| MQTT WebSocket 端口 | WebSocket MQTT 握手使用的监听端口。 当前页面值为“8084”，默认值为“8084”，生效方式为“需重绑监听器”。 |
| MQTT WebSocket 路径 | WebSocket 握手路径；后端会自动补齐开头的斜杠。 当前页面值为“/mqtt”，默认值为“/mqtt”，生效方式为“下次重绑生效”。 |
4. TCP 接入配置
操作位置： 设备→运行配置中心
选择对应模块，读取 TCP 接入配置 的当前值、默认值、生效方式和风险提示；本次不编辑、不保存。
图：真实运行配置中心的TCP 接入配置；图下逐项解释本区字段。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| TCP 监听启用状态 | 决定通用 TCP 监听器是否允许启动；切换会直接保存。 当前页面值为“true”，默认值为“true”，生效方式为“立即生效”。 |
| TCP 监听端口 | 通用 TCP 设备连接的监听端口。 当前页面值为“8888”，默认值为“8888”，生效方式为“需重绑监听器”。 |
| TCP 默认心跳 | 通用 TCP 连接空闲保活时间。 当前页面值为“60”，默认值为“60”，生效方式为“需重绑监听器”。 |
| TCP 连接等待队列 | TCP 监听器等待应用接受的连接队列长度。 当前页面值为“1024”，默认值为“1024”，生效方式为“需重绑监听器”。 |
5. UDP 接入配置
操作位置： 设备→运行配置中心
选择对应模块，读取 UDP 接入配置 的当前值、默认值、生效方式和风险提示；本次不编辑、不保存。
图：真实运行配置中心的UDP 接入配置；图下逐项解释本区字段。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| UDP 监听启用状态 | 决定 UDP 监听器是否允许接收报文；切换会直接保存。 当前页面值为“true”，默认值为“true”，生效方式为“立即生效”。 |
| UDP 监听端口 | UDP 设备发送报文的目标端口。 当前页面值为“8889”，默认值为“8889”，生效方式为“需重绑监听器”。 |
| UDP 接收缓冲区 | 操作系统 UDP socket 的接收缓冲区大小。 当前页面值为“1048576”，默认值为“1048576”，生效方式为“需重绑监听器”。 |
6. 观测默认策略
操作位置： 设备→运行配置中心
选择对应模块，读取 观测默认策略 的当前值、默认值、生效方式和风险提示；本次不编辑、不保存。
图：真实运行配置中心的观测默认策略；图下逐项解释本区字段。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| 会话监控默认开启 | 决定新会话是否默认采集收发和活动计数。 当前页面值为“false”，默认值为“false”，生效方式为“立即生效”。 |
| 最近消息默认开启 | 决定新会话是否默认保留最近报文摘要。 当前页面值为“false”，默认值为“false”，生效方式为“立即生效”。 |
| 设备追踪目标上限 | 限制集群内同时追踪的设备数量。 当前页面值为“10”，默认值为“10”，生效方式为“立即生效”。 |
| 设备追踪保留天数 | 设备追踪历史的默认保留周期。 当前页面值为“30”，默认值为“30”，生效方式为“立即生效”。 |
7. 记录保留与清理策略
操作位置： 设备→运行配置中心
选择对应模块，读取 记录保留与清理策略 的当前值、默认值、生效方式和风险提示；本次不编辑、不保存。
图：真实运行配置中心的记录保留与清理策略；图下逐项解释本区字段。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| 规则执行日志保留天数 | 规则执行日志的默认保留周期。 当前页面值为“15”，默认值为“15”，生效方式为“立即生效”。 |
| 规则重放审计保留天数 | 规则重放审计的默认保留周期。 当前页面值为“30”，默认值为“30”，生效方式为“立即生效”。 |
| 记录查询默认窗口 | 查询未指定时间范围时默认读取最近天数。 当前页面值为“7”，默认值为“7”，生效方式为“立即生效”。 |
| 记录清理批次 | 单次历史记录清理的最大行数。 当前页面值为“1000”，默认值为“1000”，生效方式为“立即生效”。 |
8. 数据库连接启动项
操作位置： 设备→运行配置中心
选择对应模块，读取 数据库连接启动项 的当前值、默认值、生效方式和风险提示；本次不编辑、不保存。
图：真实运行配置中心的数据库连接启动项；图下逐项解释本区字段。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| 数据库连接地址 | MySQL 主配置库连接地址，只在本页展示，不可运行期修改。 当前页面值为“当前 JDBC 地址”，默认值为“当前 JDBC 地址”，生效方式为“应用重启”。 |
9. 事件总线启动项
操作位置： 设备→运行配置中心
选择对应模块，读取 事件总线启动项 的当前值、默认值、生效方式和风险提示；本次不编辑、不保存。
图：真实运行配置中心的事件总线启动项；图下逐项解释本区字段。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| 事件总线 RingBuffer | 设备事件总线的环形缓冲区容量，只能由部署侧调整。 当前页面值为“8192”，默认值为“8192”，生效方式为“应用重启”。 |
10. FastBee WEB 地址
操作位置： 设备→运行配置中心
选择对应模块，读取 FastBee WEB 地址 的当前值、默认值、生效方式和风险提示；本次不编辑、不保存。
图：真实运行配置中心的FastBee WEB 地址；图下逐项解释本区字段。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| FastBee WEB 地址 | FMQ 调用 FastBee WEB 协议助手接口的基础地址；Token 不在此页填写。 当前页面值为“空”，默认值为“空”，生效方式为“立即生效”。 |
11. HTTP 控制面启动项
操作位置： 设备→运行配置中心
选择对应模块，读取 HTTP 控制面启动项 的当前值、默认值、生效方式和风险提示；本次不编辑、不保存。
图：真实运行配置中心的HTTP 控制面启动项；图下逐项解释本区字段。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| HTTP 管理端口 | 控制台与 API 服务使用的 HTTP 端口，只读展示。 当前页面值为“18083”，默认值为“18083”，生效方式为“应用重启”。 |
12. 最近变更与运行边界
操作位置： 设备→运行配置中心→页面底部
滚动到 最近变更审计，读取配置 key、范围、新值、操作者、结果和时间，再查看右侧运行边界。
图：真实页面裁取的最近 MQTT 配置变更与运行边界；未包含长拓扑请求标识。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| 配置 key | 标识发生变更的具体运行配置项。 |
| 范围 | 显示变更是全局还是指定节点。 |
| 新值 | 记录保存后的新配置值。 |
| 操作者 | 记录本次变更来源或操作账号。 |
| 结果 | 显示本次变更是否成功。 |
| 时间 | 记录变更发生时间。 |
| 不做通用 yml 编辑器 | 数据库、线程池、HTTP 端口等基础设施字段只读。 |
| 热路径不查库 | 运行组件优先读取本地缓存，其他节点按周期感知全局变化。 |
| 监听器重绑 | 端口、path、backlog、buffer 等字段可能影响设备入口。 |
13. 按模块和关键词定位字段
操作位置： 设备→运行配置中心
先选择 模块分组，再在 搜索配置名、key、风险提示 中输入关键词；清空搜索后恢复模块全部字段。
图：真实页面操作入口；本步骤只说明操作方法和预期结果，未执行写操作。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| 搜索配置名、key、风险提示 | 按中文名称、原始 key、生效方式或风险提示缩小字段范围。；按中文名称、原始 key、生效方式或风险提示缩小字段范围。选填 · 推荐：保持当前值，变更前先核对影响范围 · 示例：以现场规划值为准 |
| 设备追踪保留天数 | 设备追踪历史的默认保留周期。；全局；立即生效必填 · 推荐：先保持当前值 30；按现场容量评估后调整 · 示例：30 |
| 规则执行日志保留天数 | 规则执行日志的默认保留周期。；全局；立即生效必填 · 推荐：先保持当前值 15；按现场容量评估后调整 · 示例：15 |
| 规则重放审计保留天数 | 规则重放审计的默认保留周期。；全局；立即生效必填 · 推荐：先保持当前值 30；按现场容量评估后调整 · 示例：30 |
操作边界
预期结果（未执行）：预期：页面只保留同时符合当前模块和关键词的字段；筛选不会保存配置。 风险与恢复：结果为空时先清空关键词，再检查是否选错模块。
14. 理解开关切换即保存
操作位置： 设备→运行配置中心
确认目标范围和当前连接后再切换 会话监控默认开启 或 最近消息默认开启；开关变化会立即调用保存，不会再出现独立保存按钮。
图：真实页面操作入口；本步骤只说明操作方法和预期结果，未执行写操作。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| 会话监控默认开启 | 决定新会话是否默认采集收发和活动计数。；全局；立即生效必填 · 推荐：先保持当前值 false；按现场容量评估后调整 · 示例：false |
| 最近消息默认开启 | 决定新会话是否默认保留最近报文摘要。；全局；立即生效必填 · 推荐：先保持当前值 false；按现场容量评估后调整 · 示例：false |
| 保存后立即应用 | 决定监听器相关变更是否立即重绑；普通立即生效字段默认勾选。；决定监听器相关变更是否立即重绑；普通立即生效字段默认勾选。选填 · 推荐：保持当前值，变更前先核对影响范围 · 示例：以现场规划值为准 |
操作边界
预期结果（未执行）：预期（未执行）：页面提示保存成功并重新读取当前值；仅影响保存后读取配置的新会话策略。 风险与恢复：误触开关时立即切回原值，并在最近变更审计确认两次记录。
15. 区分 MQTT 立即生效与重绑
操作位置： 设备→运行配置中心
逐行查看 生效方式：启用状态和默认心跳可立即生效，端口和 backlog 必须确认 保存后立即应用 是否勾选。
图：真实页面操作入口；本步骤只说明操作方法和预期结果，未执行写操作。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| MQTT TCP 启用状态 | 决定 MQTT TCP 监听器是否允许启动；切换会直接保存。；当前节点；立即生效必填 · 推荐：先保持当前值 true；按现场容量评估后调整 · 示例：true |
| MQTT TCP 端口 | MQTT TCP 对外监听端口，设备连接地址必须与它一致。；当前节点；需重绑监听器必填 · 推荐：先保持当前值 1884；按现场容量评估后调整 · 示例：1884 |
| MQTT 默认心跳 | 客户端未声明心跳时使用的默认保活时间。；当前节点；立即生效必填 · 推荐：先保持当前值 60；按现场容量评估后调整 · 示例：60 |
| MQTT 连接等待队列 | TCP 握手完成后等待应用接收的连接队列长度。；当前节点；需重绑监听器必填 · 推荐：先保持当前值 1024；按现场容量评估后调整 · 示例：1024 |
| 保存后立即应用 | 决定监听器相关变更是否立即重绑；普通立即生效字段默认勾选。；决定监听器相关变更是否立即重绑；普通立即生效字段默认勾选。选填 · 推荐：保持当前值，变更前先核对影响范围 · 示例：以现场规划值为准 |
操作边界
预期结果（未执行）：预期（未执行）：立即生效字段保存后更新运行配置；重绑字段按勾选状态立即重绑或等待下次监听器重启。 风险与恢复：不能确认维护窗口时取消保存；不要用同一判断套用所有 MQTT 字段。
16. 配置 MQTT 端口、队列和 Socket 保活
操作位置： 设备→运行配置中心
修改 MQTT TCP 端口、连接等待队列或 Socket KeepAlive 前先记录旧值；需要立即重绑时才勾选 保存后立即应用。
图：真实页面操作入口；本步骤只说明操作方法和预期结果，未执行写操作。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| MQTT TCP 端口 | MQTT TCP 对外监听端口，设备连接地址必须与它一致。；当前节点；需重绑监听器必填 · 推荐：先保持当前值 1884；按现场容量评估后调整 · 示例：1884 |
| MQTT 连接等待队列 | TCP 握手完成后等待应用接收的连接队列长度。；当前节点；需重绑监听器必填 · 推荐：先保持当前值 1024；按现场容量评估后调整 · 示例：1024 |
| MQTT Socket KeepAlive | 开启操作系统 TCP keepalive，仅影响重新绑定后的监听器。；当前节点；需重绑监听器必填 · 推荐：先保持当前值 true；按现场容量评估后调整 · 示例：true |
| MQTT WebSocket 端口 | WebSocket MQTT 握手使用的监听端口。；当前节点；需重绑监听器必填 · 推荐：先保持当前值 8084；按现场容量评估后调整 · 示例：8084 |
| 保存后立即应用 | 决定监听器相关变更是否立即重绑；普通立即生效字段默认勾选。；决定监听器相关变更是否立即重绑；普通立即生效字段默认勾选。选填 · 推荐：保持当前值，变更前先核对影响范围 · 示例：以现场规划值为准 |
操作边界
预期结果（未执行）：预期（未执行）：立即重绑成功后服务管理显示新监听参数；不立即应用时配置保存，当前监听器继续使用旧绑定直到重启。 风险与恢复：重绑失败时停止继续修改；后端不会在运行更新失败后持久化新值，先确认旧监听器仍可用。
17. 同步 WebSocket 端口与路径
操作位置： 设备→运行配置中心
修改 MQTT WebSocket 端口 或路径时同步调整客户端/反向代理；路径未以斜杠开头时后端会自动补齐。
图：真实页面操作入口；本步骤只说明操作方法和预期结果，未执行写操作。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| MQTT WebSocket 端口 | WebSocket MQTT 握手使用的监听端口。；当前节点；需重绑监听器必填 · 推荐：先保持当前值 8084；按现场容量评估后调整 · 示例：8084 |
| MQTT WebSocket 路径 | WebSocket 握手路径；后端会自动补齐开头的斜杠。；当前节点；下次重绑生效必填 · 推荐：先保持当前值 /mqtt；按现场容量评估后调整 · 示例：/mqtt |
| 保存后立即应用 | 决定监听器相关变更是否立即重绑；普通立即生效字段默认勾选。；决定监听器相关变更是否立即重绑；普通立即生效字段默认勾选。选填 · 推荐：保持当前值，变更前先核对影响范围 · 示例：以现场规划值为准 |
操作边界
预期结果（未执行）：预期（未执行）：端口按重绑选择生效；路径至少在下次监听器重绑后生效，客户端使用相同路径才能握手。 风险与恢复：握手失败时恢复旧端口和路径，检查代理转发与服务管理监听状态。
18. 维护 TCP 监听参数
操作位置： 设备→运行配置中心
在 TCP 模块分别核对 监听启用状态、端口、心跳和 backlog；端口、心跳、backlog 都按重绑字段处理。
图：真实页面操作入口；本步骤只说明操作方法和预期结果，未执行写操作。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| TCP 监听启用状态 | 决定通用 TCP 监听器是否允许启动；切换会直接保存。；当前节点；立即生效必填 · 推荐：先保持当前值 true；按现场容量评估后调整 · 示例：true |
| TCP 监听端口 | 通用 TCP 设备连接的监听端口。；当前节点；需重绑监听器必填 · 推荐：先保持当前值 8888；按现场容量评估后调整 · 示例：8888 |
| TCP 默认心跳 | 通用 TCP 连接空闲保活时间。；当前节点；需重绑监听器必填 · 推荐：先保持当前值 60；按现场容量评估后调整 · 示例：60 |
| TCP 连接等待队列 | TCP 监听器等待应用接受的连接队列长度。；当前节点；需重绑监听器必填 · 推荐：先保持当前值 1024；按现场容量评估后调整 · 示例：1024 |
| 保存后立即应用 | 决定监听器相关变更是否立即重绑；普通立即生效字段默认勾选。；决定监听器相关变更是否立即重绑；普通立即生效字段默认勾选。选填 · 推荐：保持当前值，变更前先核对影响范围 · 示例：以现场规划值为准 |
操作边界
预期结果（未执行）：预期（未执行）：保存后当前节点使用新配置；选择立即应用会重绑 TCP 监听器并可能影响连接。 风险与恢复：维护前先查看 TCP 会话；异常时恢复旧值并重启或重绑 TCP 监听器。
19. 维护 UDP 端口与接收缓冲区
操作位置： 设备→运行配置中心
在 UDP 模块确认 UDP 监听端口 与设备目标一致，再按突发流量评估接收缓冲区；需要立即生效时才选择重绑。
图：真实页面操作入口；本步骤只说明操作方法和预期结果，未执行写操作。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| UDP 监听启用状态 | 决定 UDP 监听器是否允许接收报文；切换会直接保存。；当前节点；立即生效必填 · 推荐：先保持当前值 true；按现场容量评估后调整 · 示例：true |
| UDP 监听端口 | UDP 设备发送报文的目标端口。；当前节点；需重绑监听器必填 · 推荐：先保持当前值 8889；按现场容量评估后调整 · 示例：8889 |
| UDP 接收缓冲区 | 操作系统 UDP socket 的接收缓冲区大小。；当前节点；需重绑监听器必填 · 推荐：先保持当前值 1048576；按现场容量评估后调整 · 示例：1048576 |
| 保存后立即应用 | 决定监听器相关变更是否立即重绑；普通立即生效字段默认勾选。；决定监听器相关变更是否立即重绑；普通立即生效字段默认勾选。选填 · 推荐：保持当前值，变更前先核对影响范围 · 示例：以现场规划值为准 |
操作边界
预期结果（未执行）：预期（未执行）：重绑后 UDP 设备向新端口发送；缓冲区新值用于重新绑定的 socket。 风险与恢复：收不到报文时恢复旧端口，检查设备目标、防火墙和服务管理状态。
20. 调整记录保留周期
操作位置： 设备→运行配置中心
按审计与容量要求填写设备追踪、规则执行日志和规则重放审计的保留天数，确认单位后点击 保存；这些字段为全局范围。
图：真实页面操作入口；本步骤只说明操作方法和预期结果，未执行写操作。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| 设备追踪保留天数 | 设备追踪历史的默认保留周期。；全局；立即生效必填 · 推荐：先保持当前值 30；按现场容量评估后调整 · 示例：30 |
| 规则执行日志保留天数 | 规则执行日志的默认保留周期。；全局；立即生效必填 · 推荐：先保持当前值 15；按现场容量评估后调整 · 示例：15 |
| 规则重放审计保留天数 | 规则重放审计的默认保留周期。；全局；立即生效必填 · 推荐：先保持当前值 30；按现场容量评估后调整 · 示例：30 |
| 保存后立即应用 | 决定监听器相关变更是否立即重绑；普通立即生效字段默认勾选。；决定监听器相关变更是否立即重绑；普通立即生效字段默认勾选。选填 · 推荐：保持当前值，变更前先核对影响范围 · 示例：以现场规划值为准 |
操作边界
预期结果（未执行）：预期（未执行）：保存后本地缓存立即读取新的保留周期，其他节点最多约 5 秒后通过周期刷新感知。 风险与恢复：记录表增长异常时恢复旧值，再检查清理任务和存储容量。
21. 调整查询窗口与清理批次
操作位置： 设备→运行配置中心
先评估记录表数据量，再修改 记录查询默认窗口 和 记录清理批次；查询窗口过大影响查询速度，清理批次过大可能短时占用数据库。
图：真实页面操作入口；本步骤只说明操作方法和预期结果，未执行写操作。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| 记录查询默认窗口 | 查询未指定时间范围时默认读取最近天数。；全局；立即生效必填 · 推荐：先保持当前值 7；按现场容量评估后调整 · 示例：7 |
| 记录清理批次 | 单次历史记录清理的最大行数。；全局；立即生效必填 · 推荐：先保持当前值 1000；按现场容量评估后调整 · 示例：1000 |
| 保存后立即应用 | 决定监听器相关变更是否立即重绑；普通立即生效字段默认勾选。；决定监听器相关变更是否立即重绑；普通立即生效字段默认勾选。选填 · 推荐：保持当前值，变更前先核对影响范围 · 示例：以现场规划值为准 |
操作边界
预期结果（未执行）：预期（未执行）：保存后新查询采用新的默认窗口，清理任务按新的批次数量执行。 风险与恢复：查询变慢或清理占库时恢复旧值，检查查询耗时、锁等待和连接池。
22. 配置 FastBee WEB 地址
操作位置： 设备→运行配置中心
填写可访问的 FastBee WEB 地址 后点击 保存；这里只维护基础地址，不填写或展示 Token。
图：真实页面操作入口；本步骤只说明操作方法和预期结果，未执行写操作。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| FastBee WEB 地址 | FMQ 调用 FastBee WEB 协议助手接口的基础地址；Token 不在此页填写。；全局；立即生效必填 · 推荐：先保持当前值 空；按现场容量评估后调整 · 示例：空 |
| 保存后立即应用 | 决定监听器相关变更是否立即重绑；普通立即生效字段默认勾选。；决定监听器相关变更是否立即重绑；普通立即生效字段默认勾选。选填 · 推荐：保持当前值，变更前先核对影响范围 · 示例：以现场规划值为准 |
操作边界
预期结果（未执行）：预期（未执行）：地址保存后立即进入运行配置缓存；是否授权可用仍需在协议管理中单独测试连接。 风险与恢复：地址错误时恢复旧值或清空，检查 WEB 根地址、网络和 WEB 侧 Token。
23. 识别数据库与事件总线只读项
操作位置： 设备→运行配置中心
数据库连接地址和 RingBuffer 只用于核对；页面没有输入框和保存按钮，需由部署侧在 yml、环境变量或部署平台维护。
图：真实页面操作入口；本步骤只说明操作方法和预期结果，未执行写操作。
操作边界
预期结果（未执行）：预期：页面保持只读；实际修改必须在部署配置中完成并重启应用。 风险与恢复：不要尝试绕过页面直接写运行配置表；配置错误时由部署侧恢复原值。
24. 识别 HTTP 管理端口只读项
操作位置： 设备→运行配置中心
核对 HTTP 管理端口 与访问入口一致；本页不可修改，部署侧调整后必须同步反向代理、健康探针和防火墙。
图：真实页面操作入口；本步骤只说明操作方法和预期结果，未执行写操作。
操作边界
预期结果（未执行）：预期：HTTP 端口显示只读和应用重启；不会出现保存按钮。 风险与恢复：端口变更后无法访问时恢复原端口，并检查代理、探针和防火墙。
25. 区分重新读取与缓存刷新
操作位置： 设备→运行配置中心
重新读取 只重新请求页面数据；刷新当前节点缓存 会让后端当前节点重新装载配置表，只有明确需要刷新缓存时才使用。
图：真实页面操作入口；本步骤只说明操作方法和预期结果，未执行写操作。
操作边界
预期结果（未执行）：预期（未执行）：重新读取更新页面和审计；缓存刷新成功后显示新缓存时间并再次读取页面。 风险与恢复：刷新失败时不要连续点击，先检查数据库连接和接口错误；其他节点仍按周期刷新。
页面字段说明
完整参考
| 字段 / 单位 | 通俗含义 | 数据方向 / 来源 | 正常判断 | 异常信号与第一检查点 |
|---|---|---|---|---|
| 页面范围与配置统计 | ||||
| 当前节点节点 | 说明本页正在读取哪个 FMQ 节点的节点级配置。 | 运行配置分组接口 → 当前页面概览 | 显示明确节点地址。 | 节点为空或与目标环境不一致。第一检查点：先确认登录环境和节点路由。 |
| 整体健康状态（本页不提供）边界 | 运行配置中心只展示配置和值，不计算监听器或业务链路的整体健康状态。 | 运行配置分组接口 → 当前页面概览 | 页面配置可正常加载；健康结论另到监控总览或服务管理判断。 | 把字段数量、默认值或审计成功直接当成系统健康。第一检查点：转到监控总览和服务管理核对实时运行状态。 |
| 缓存刷新时间时间 | 显示页面最近一次读取配置后的时间。 | 运行配置分组接口 → 当前页面概览 | 时间与本次打开页面接近。 | 时间长期不更新或读取报错。第一检查点：先用重新读取；仍异常再检查接口。 |
| 其他节点感知延迟秒 | 提示全局配置由其他节点最多约 5 秒后通过周期刷新感知。 | 运行配置分组接口 → 当前页面概览 | 短时间内各节点逐步读取同一全局版本。 | 超过周期仍长期不一致。第一检查点：按节点检查缓存刷新和配置版本。 |
| 功能模块个 | 当前页面按服务聚合出的模块数量。 | 运行配置分组接口 → 当前页面概览 | 本次页面显示 8。 | 模块数量与白名单或部署预期不符。第一检查点：清空筛选并核对字段白名单。 |
| 纳入字段项 | 运行配置白名单中在页面展示的字段总数。 | 运行配置分组接口 → 当前页面概览 | 本次页面显示 28。 | 字段缺失或重复。第一检查点：核对分组接口和字段注册表。 |
| 可前端修改项 | 允许在运行配置中心提交的字段数量。 | 运行配置分组接口 → 当前页面概览 | 本次页面显示 25。 | 只读项可编辑或应编辑项被锁定。第一检查点：核对字段 readOnly 元数据。 |
| 节点级字段项 | 只作用于指定 FMQ 节点的监听器字段数量。 | 运行配置分组接口 → 当前页面概览 | 本次页面显示 16。 | 节点级字段被误认为全局配置。第一检查点：先看字段范围标签和当前节点。 |
| 需重绑字段项 | 变更后需要立即重绑或等待监听器下次重启的字段数量。 | 运行配置分组接口 → 当前页面概览 | 本次页面显示 10。 | 未评估重绑影响就准备保存。第一检查点：到服务管理确认连接与维护窗口。 |
| MQTT TCP 基础配置 | ||||
| MQTT TCP 启用状态开关 | 决定 MQTT TCP 监听器是否允许启动；切换会直接保存。 当前页面值为“true”，默认值为“true”，生效方式为“立即生效”。 | 当前节点运行配置 → 监听器或新连接 | 需要 MQTT TCP 设备接入时保持开启。 | 关闭后新 MQTT TCP 连接无法接入。第一检查点：先到服务管理确认监听器状态和现有连接。 |
| MQTT TCP 端口端口 | MQTT TCP 对外监听端口，设备连接地址必须与它一致。 当前页面值为“1884”，默认值为“1884”，生效方式为“需重绑监听器”。 | 当前节点运行配置 → 监听器或新连接 | 端口未冲突且与客户端配置一致。 | 端口被占用或客户端仍连接旧端口。第一检查点：检查端口占用、服务管理状态和客户端地址。 |
| MQTT 默认心跳秒 | 客户端未声明心跳时使用的默认保活时间。 当前页面值为“60”，默认值为“60”，生效方式为“立即生效”。 | 当前节点运行配置 → 监听器或新连接 | 结合网络质量和终端上报周期设置，当前为 60 秒。 | 过小导致弱网设备频繁断开；过大延迟发现失联。第一检查点：核对客户端 Keep Alive、网络质量和断线时间。 |
| MQTT 连接等待队列连接 | TCP 握手完成后等待应用接收的连接队列长度。 当前页面值为“1024”，默认值为“1024”，生效方式为“需重绑监听器”。 | 当前节点运行配置 → 监听器或新连接 | 高并发峰值下没有持续拒绝连接。 | 队列过小导致连接高峰被拒绝。第一检查点：检查连接峰值、监听器拒绝数和系统资源。 |
| MQTT Socket KeepAlive开关 | 开启操作系统 TCP keepalive，仅影响重新绑定后的监听器。 当前页面值为“true”，默认值为“true”，生效方式为“需重绑监听器”。 | 当前节点运行配置 → 监听器或新连接 | 网络设备可能清理空闲连接时保持开启。 | 关闭后长空闲连接更依赖应用层心跳。第一检查点：先核对网络空闲超时和 MQTT 心跳策略。 |
| MQTT 载荷与 WebSocket 配置 | ||||
| MQTT 最大载荷B | 限制单个 MQTT 报文允许的最大字节数。 当前页面值为“8092”，默认值为“8092”，生效方式为“立即生效”。 | 当前节点运行配置 → 监听器或新连接 | 覆盖实际报文且不过度放大内存占用。 | 过小拒绝合法报文；过大增加内存压力。第一检查点：对照真实报文大小和并发连接量。 |
| MQTT WebSocket 启用状态开关 | 决定浏览器或 WebSocket MQTT 客户端是否可接入。 当前页面值为“false”，默认值为“false”，生效方式为“立即生效”。 | 当前节点运行配置 → 监听器或新连接 | 仅在确有 WebSocket 客户端时开启。 | 关闭时 WebSocket 客户端无法连接。第一检查点：确认客户端传输方式，不要与普通 MQTT TCP 混用。 |
| MQTT WebSocket 端口端口 | WebSocket MQTT 握手使用的监听端口。 当前页面值为“8084”，默认值为“8084”，生效方式为“需重绑监听器”。 | 当前节点运行配置 → 监听器或新连接 | 端口未冲突并与反向代理、客户端一致。 | 端口冲突或代理仍转发旧端口。第一检查点：检查端口占用、代理转发和服务管理状态。 |
| MQTT WebSocket 路径路径 | WebSocket 握手路径；后端会自动补齐开头的斜杠。 当前页面值为“/mqtt”，默认值为“/mqtt”，生效方式为“下次重绑生效”。 | 当前节点运行配置 → 监听器或新连接 | 路径与客户端和反向代理配置一致。 | 客户端仍使用旧路径导致握手失败。第一检查点：同步修改客户端或代理路径，再检查握手响应。 |
| TCP 接入配置 | ||||
| TCP 监听启用状态开关 | 决定通用 TCP 监听器是否允许启动；切换会直接保存。 当前页面值为“true”，默认值为“true”，生效方式为“立即生效”。 | 当前节点运行配置 → 监听器或新连接 | 存在 TCP 设备接入时保持开启。 | 关闭后新 TCP 设备无法接入。第一检查点：先确认当前会话和维护窗口。 |
| TCP 监听端口端口 | 通用 TCP 设备连接的监听端口。 当前页面值为“8888”，默认值为“8888”，生效方式为“需重绑监听器”。 | 当前节点运行配置 → 监听器或新连接 | 端口与设备配置一致且无占用。 | 端口冲突或设备仍连接旧端口。第一检查点：检查端口占用、客户端地址和监听器状态。 |
| TCP 默认心跳秒 | 通用 TCP 连接空闲保活时间。 当前页面值为“60”，默认值为“60”，生效方式为“需重绑监听器”。 | 当前节点运行配置 → 监听器或新连接 | 与设备发送周期和网络稳定性相匹配。 | 过小可能误断慢速或弱网设备。第一检查点：核对设备心跳、空闲时间和断开原因。 |
| TCP 连接等待队列连接 | TCP 监听器等待应用接受的连接队列长度。 当前页面值为“1024”，默认值为“1024”，生效方式为“需重绑监听器”。 | 当前节点运行配置 → 监听器或新连接 | 连接高峰没有持续拒绝。 | 过小导致并发连接被拒绝。第一检查点：检查连接峰值、系统资源和拒绝计数。 |
| UDP 接入配置 | ||||
| UDP 监听启用状态开关 | 决定 UDP 监听器是否允许接收报文；切换会直接保存。 当前页面值为“true”，默认值为“true”，生效方式为“立即生效”。 | 当前节点运行配置 → 监听器或新连接 | 存在 UDP 设备上报时保持开启。 | 关闭后 UDP 报文不再进入平台。第一检查点：先确认业务是否仍有 UDP 设备。 |
| UDP 监听端口端口 | UDP 设备发送报文的目标端口。 当前页面值为“8889”，默认值为“8889”，生效方式为“需重绑监听器”。 | 当前节点运行配置 → 监听器或新连接 | 端口与设备目标一致且无占用。 | 端口错误会导致报文完全收不到。第一检查点：检查设备目标地址、防火墙和服务管理状态。 |
| UDP 接收缓冲区B | 操作系统 UDP socket 的接收缓冲区大小。 当前页面值为“1048576”，默认值为“1048576”，生效方式为“需重绑监听器”。 | 当前节点运行配置 → 监听器或新连接 | 能覆盖短时突发流量且内存占用可控。 | 过小可能在突发时丢包。第一检查点：对照报文峰值、丢包指标和系统内存。 |
| 观测默认策略 | ||||
| 会话监控默认开启开关 | 决定新会话是否默认采集收发和活动计数。 当前页面值为“false”，默认值为“false”，生效方式为“立即生效”。 | 全局运行配置 → 运行策略或控制面 | 生产环境按排障需要开启，避免无目的全量观测。 | 全量开启会增加少量内存和计数开销。第一检查点：先确定需观测的会话范围。 |
| 最近消息默认开启开关 | 决定新会话是否默认保留最近报文摘要。 当前页面值为“false”，默认值为“false”，生效方式为“立即生效”。 | 全局运行配置 → 运行策略或控制面 | 仅在需要快速排障时按需开启。 | 全量开启会增加摘要保留开销。第一检查点：确认排障目标和数据敏感性。 |
| 设备追踪目标上限个 | 限制集群内同时追踪的设备数量。 当前页面值为“10”，默认值为“10”，生效方式为“立即生效”。 | 全局运行配置 → 运行策略或控制面 | 上限覆盖日常排障目标且不会无限增长。 | 过大增加事件记录和内存压力。第一检查点：先清理不再需要的追踪目标。 |
| 设备追踪保留天数天 | 设备追踪历史的默认保留周期。 当前页面值为“30”，默认值为“30”，生效方式为“立即生效”。 | 全局运行配置 → 运行策略或控制面 | 满足审计需要且记录表增长可控。 | 过大增加记录表体积。第一检查点：检查表增长、查询频率和清理任务。 |
| 记录保留与清理策略 | ||||
| 规则执行日志保留天数天 | 规则执行日志的默认保留周期。 当前页面值为“15”，默认值为“15”，生效方式为“立即生效”。 | 全局运行配置 → 运行策略或控制面 | 覆盖日常排障周期且表体积可控。 | 过大使记录表持续膨胀。第一检查点：检查清理结果和查询窗口。 |
| 规则重放审计保留天数天 | 规则重放审计的默认保留周期。 当前页面值为“30”，默认值为“30”，生效方式为“立即生效”。 | 全局运行配置 → 运行策略或控制面 | 满足审计要求且存储可控。 | 过短缺少审计，过长增加表体积。第一检查点：结合审计周期和表增长调整。 |
| 记录查询默认窗口天 | 查询未指定时间范围时默认读取最近天数。 当前页面值为“7”，默认值为“7”，生效方式为“立即生效”。 | 全局运行配置 → 运行策略或控制面 | 常用查询能快速返回，当前为 7 天。 | 窗口过大会让列表查询变慢。第一检查点：先缩小时间范围并检查索引与数据量。 |
| 记录清理批次条 | 单次历史记录清理的最大行数。 当前页面值为“1000”，默认值为“1000”，生效方式为“立即生效”。 | 全局运行配置 → 运行策略或控制面 | 清理能持续推进且不会长时间占库。 | 过大可能产生数据库资源峰值。第一检查点：检查清理耗时、锁等待和连接池。 |
| 数据库连接启动项 | ||||
| 数据库连接地址地址 | MySQL 主配置库连接地址，只在本页展示，不可运行期修改。 当前页面值为“当前 JDBC 地址”，默认值为“当前 JDBC 地址”，生效方式为“应用重启”。 | 全局运行配置 → 运行策略或控制面 | 由部署侧维护且当前服务可正常启动。 | 地址错误会导致配置库不可用。第一检查点：到部署配置核对 JDBC 地址、网络和凭据，不在本页修改。 |
| 事件总线启动项 | ||||
| 事件总线 RingBuffer槽 | 设备事件总线的环形缓冲区容量，只能由部署侧调整。 当前页面值为“8192”，默认值为“8192”，生效方式为“应用重启”。 | 全局运行配置 → 运行策略或控制面 | 容量能覆盖吞吐峰值且内存稳定。 | 过小可能积压，过大会放大内存占用。第一检查点：结合峰值吞吐、积压和堆内存评估后重启。 |
| FastBee WEB 地址 | ||||
| FastBee WEB 地址地址 | FMQ 调用 FastBee WEB 协议助手接口的基础地址；Token 不在此页填写。 当前页面值为“空”，默认值为“空”，生效方式为“立即生效”。 | 全局运行配置 → 运行策略或控制面 | 配置为可访问的 WEB 根地址后再单独验证授权。 | 为空或地址错误会让 AI 协议解析不可用。第一检查点：核对 WEB 根地址、网络和 WEB 侧 Token 配置。 |
| HTTP 控制面启动项 | ||||
| HTTP 管理端口端口 | 控制台与 API 服务使用的 HTTP 端口，只读展示。 当前页面值为“18083”，默认值为“18083”，生效方式为“应用重启”。 | 全局运行配置 → 运行策略或控制面 | 端口与部署入口、反向代理和防火墙一致。 | 端口冲突或入口仍指向旧端口。第一检查点：在部署配置修改并重启，再检查代理与健康探针。 |
| 最近变更与运行边界 | ||||
| 配置 key标识 | 标识发生变更的具体运行配置项。 | 配置变更与运行边界 → 当前页面 | 与刚维护的字段一致。 | 审计出现未预期 key。第一检查点：停止后续操作并核对操作者和时间。 |
| 范围范围 | 显示变更是全局还是指定节点。 | 配置变更与运行边界 → 当前页面 | 范围与字段元数据一致。 | 节点级变更写成全局或节点不符。第一检查点：核对当前节点和请求 nodeId。 |
| 新值值 | 记录保存后的新配置值。 | 配置变更与运行边界 → 当前页面 | 与预期填写值一致。 | 值被规范化后与预期不符。第一检查点：重新读取字段并比较旧值。 |
| 操作者账号 | 记录本次变更来源或操作账号。 | 配置变更与运行边界 → 当前页面 | 来源可识别。 | 出现未知操作者。第一检查点：检查账号使用和审计上下文。 |
| 结果状态 | 显示本次变更是否成功。 | 配置变更与运行边界 → 当前页面 | 成功或有明确失败原因。 | 失败或长期无对应记录。第一检查点：检查接口提示、服务管理状态和后端审计。 |
| 时间时间 | 记录变更发生时间。 | 配置变更与运行边界 → 当前页面 | 与维护窗口一致。 | 时间不符或审计长期不更新。第一检查点：确认系统时间并重新读取审计。 |
| 不做通用 yml 编辑器边界 | 数据库、线程池、HTTP 端口等基础设施字段只读。 | 配置变更与运行边界 → 当前页面 | 只读项没有保存按钮。 | 只读项可直接提交。第一检查点：停止操作并回到部署配置。 |
| 热路径不查库边界 | 运行组件优先读取本地缓存，其他节点按周期感知全局变化。 | 配置变更与运行边界 → 当前页面 | 配置版本能在预期周期内同步。 | 节点版本长期不一致。第一检查点：检查节点缓存刷新与数据库连接。 |
| 监听器重绑边界 | 端口、path、backlog、buffer 等字段可能影响设备入口。 | 配置变更与运行边界 → 当前页面 | 变更前已确认维护窗口和回退。 | 连接未评估就立即重绑。第一检查点：取消保存，先到服务管理检查连接。 |
运行配置中心
完整参考
| 字段/控件 | 用途与原始键 | 默认/推荐/示例 | 选项说明 | 作用与影响 | 生效条件 |
|---|---|---|---|---|---|
| 搜索配置名、key、风险提示field | 按中文名称、原始 key、生效方式或风险提示缩小字段范围。runtime-search | 默认：以当前页面为准推荐：保持当前值，变更前先核对影响范围示例：以现场规划值为准 | 不适用 | 按中文名称、原始 key、生效方式或风险提示缩小字段范围。 | 范围：以字段显示的节点级或全局范围为准发布：不需要 · 重启：不需要 · 重连：不需要 |
| 模块分组tab | 在全部模块、MQTT、TCP、UDP、观测、数据库、线程池、安全与认证、HTTP 控制面之间切换。module-filter | 默认：以当前页面为准推荐：保持当前值，变更前先核对影响范围示例：以现场规划值为准 | 不适用 | 在全部模块、MQTT、TCP、UDP、观测、数据库、线程池、安全与认证、HTTP 控制面之间切换。 | 范围：以字段显示的节点级或全局范围为准发布：不需要 · 重启：不需要 · 重连：不需要 |
| 重新读取button | 重新请求配置分组和最近审计，不主动刷新后端本地缓存。reread | 默认：以当前页面为准推荐：保持当前值，变更前先核对影响范围示例：以现场规划值为准 | 不适用 | 重新请求配置分组和最近审计，不主动刷新后端本地缓存。 | 范围：以字段显示的节点级或全局范围为准发布：不需要 · 重启：不需要 · 重连：不需要 |
| 刷新当前节点缓存button | 触发当前节点从配置表重新装载运行配置缓存。refresh-cache | 默认：以当前页面为准推荐：保持当前值，变更前先核对影响范围示例：以现场规划值为准 | 不适用 | 触发当前节点从配置表重新装载运行配置缓存。 | 范围：仅当前节点立即刷新；其他节点仍按周期感知全局配置发布：不需要 · 重启：不需要 · 重连：不需要 |
| 保存button | 保存当前字段；数值和文本字段需显式点击，开关切换后会立即保存。save-item | 默认：以当前页面为准推荐：保持当前值，变更前先核对影响范围示例：以现场规划值为准 | 不适用 | 保存当前字段；数值和文本字段需显式点击，开关切换后会立即保存。 | 范围：以字段显示的节点级或全局范围为准发布：不需要 · 重启：不需要 · 重连：不需要 |
| 保存后立即应用checkbox | 决定监听器相关变更是否立即重绑；普通立即生效字段默认勾选。apply-now | 默认：以当前页面为准推荐：保持当前值，变更前先核对影响范围示例：以现场规划值为准 | 不适用 | 决定监听器相关变更是否立即重绑；普通立即生效字段默认勾选。 | 范围：以字段显示的节点级或全局范围为准发布：不需要 · 重启：不需要 · 重连：需要 |
| 最近变更审计display | 显示配置 key、范围、新值、操作者、结果和时间。audit-table | 默认：以当前页面为准推荐：保持当前值，变更前先核对影响范围示例：以现场规划值为准 | 不适用 | 显示配置 key、范围、新值、操作者、结果和时间。 | 范围：以字段显示的节点级或全局范围为准发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 MQTT TCP 启用状态switch | 决定 MQTT TCP 监听器是否允许启动；切换会直接保存。fmq.mqtt.tcp-enabled | 默认：true推荐：先保持当前值 true；按现场容量评估后调整示例：true | 开启（true）：允许对应能力按配置运行。；会影响新连接、新会话或对应运行策略。关闭（false）：停止默认启用对应能力。；可能阻止新连接、停止默认采集或减少运行开销。 | 当前节点；立即生效 | 范围：当前节点发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 MQTT TCP 端口field | MQTT TCP 对外监听端口，设备连接地址必须与它一致。fmq.mqtt.port | 默认：1884推荐：先保持当前值 1884；按现场容量评估后调整示例：1884 | 不适用 | 当前节点；需重绑监听器 | 范围：当前节点发布：不需要 · 重启：不需要 · 重连：需要 |
| 必填 MQTT 默认心跳field | 客户端未声明心跳时使用的默认保活时间。fmq.mqtt.keep-alive | 默认：60推荐：先保持当前值 60；按现场容量评估后调整示例：60 | 不适用 | 当前节点；立即生效 | 范围：当前节点发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 MQTT 连接等待队列field | TCP 握手完成后等待应用接收的连接队列长度。fmq.mqtt.so-backlog | 默认：1024推荐：先保持当前值 1024；按现场容量评估后调整示例：1024 | 不适用 | 当前节点；需重绑监听器 | 范围：当前节点发布：不需要 · 重启：不需要 · 重连：需要 |
| 必填 MQTT Socket KeepAliveswitch | 开启操作系统 TCP keepalive，仅影响重新绑定后的监听器。fmq.mqtt.so-keep-alive | 默认：true推荐：先保持当前值 true；按现场容量评估后调整示例：true | 开启（true）：允许对应能力按配置运行。；会影响新连接、新会话或对应运行策略。关闭（false）：停止默认启用对应能力。；可能阻止新连接、停止默认采集或减少运行开销。 | 当前节点；需重绑监听器 | 范围：当前节点发布：不需要 · 重启：不需要 · 重连：需要 |
| 必填 MQTT 最大载荷field | 限制单个 MQTT 报文允许的最大字节数。fmq.mqtt.max-payload-size | 默认：8092推荐：先保持当前值 8092；按现场容量评估后调整示例：8092 | 不适用 | 当前节点；立即生效 | 范围：当前节点发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 MQTT WebSocket 启用状态switch | 决定浏览器或 WebSocket MQTT 客户端是否可接入。fmq.mqtt.websocket-enabled | 默认：false推荐：先保持当前值 false；按现场容量评估后调整示例：false | 开启（true）：允许对应能力按配置运行。；会影响新连接、新会话或对应运行策略。关闭（false）：停止默认启用对应能力。；可能阻止新连接、停止默认采集或减少运行开销。 | 当前节点；立即生效 | 范围：当前节点发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 MQTT WebSocket 端口field | WebSocket MQTT 握手使用的监听端口。fmq.mqtt.websocket-port | 默认：8084推荐：先保持当前值 8084；按现场容量评估后调整示例：8084 | 不适用 | 当前节点；需重绑监听器 | 范围：当前节点发布：不需要 · 重启：不需要 · 重连：需要 |
| 必填 MQTT WebSocket 路径field | WebSocket 握手路径；后端会自动补齐开头的斜杠。fmq.mqtt.websocket-path | 默认：/mqtt推荐：先保持当前值 /mqtt；按现场容量评估后调整示例：/mqtt | 不适用 | 当前节点；下次重绑生效 | 范围：当前节点发布：不需要 · 重启：不需要 · 重连：需要 |
| 必填 TCP 监听启用状态switch | 决定通用 TCP 监听器是否允许启动；切换会直接保存。fmq.tcp.enable | 默认：true推荐：先保持当前值 true；按现场容量评估后调整示例：true | 开启（true）：允许对应能力按配置运行。；会影响新连接、新会话或对应运行策略。关闭（false）：停止默认启用对应能力。；可能阻止新连接、停止默认采集或减少运行开销。 | 当前节点；立即生效 | 范围：当前节点发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 TCP 监听端口field | 通用 TCP 设备连接的监听端口。fmq.tcp.port | 默认：8888推荐：先保持当前值 8888；按现场容量评估后调整示例：8888 | 不适用 | 当前节点；需重绑监听器 | 范围：当前节点发布：不需要 · 重启：不需要 · 重连：需要 |
| 必填 TCP 默认心跳field | 通用 TCP 连接空闲保活时间。fmq.tcp.keep-alive | 默认：60推荐：先保持当前值 60；按现场容量评估后调整示例：60 | 不适用 | 当前节点；需重绑监听器 | 范围：当前节点发布：不需要 · 重启：不需要 · 重连：需要 |
| 必填 TCP 连接等待队列field | TCP 监听器等待应用接受的连接队列长度。fmq.tcp.so-backlog | 默认：1024推荐：先保持当前值 1024；按现场容量评估后调整示例：1024 | 不适用 | 当前节点；需重绑监听器 | 范围：当前节点发布：不需要 · 重启：不需要 · 重连：需要 |
| 必填 UDP 监听启用状态switch | 决定 UDP 监听器是否允许接收报文；切换会直接保存。fmq.udp.enable | 默认：true推荐：先保持当前值 true；按现场容量评估后调整示例：true | 开启（true）：允许对应能力按配置运行。；会影响新连接、新会话或对应运行策略。关闭（false）：停止默认启用对应能力。；可能阻止新连接、停止默认采集或减少运行开销。 | 当前节点；立即生效 | 范围：当前节点发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 UDP 监听端口field | UDP 设备发送报文的目标端口。fmq.udp.port | 默认：8889推荐：先保持当前值 8889；按现场容量评估后调整示例：8889 | 不适用 | 当前节点；需重绑监听器 | 范围：当前节点发布：不需要 · 重启：不需要 · 重连：需要 |
| 必填 UDP 接收缓冲区field | 操作系统 UDP socket 的接收缓冲区大小。fmq.udp.so-rcvbuf | 默认：1048576推荐：先保持当前值 1048576；按现场容量评估后调整示例：1048576 | 不适用 | 当前节点；需重绑监听器 | 范围：当前节点发布：不需要 · 重启：不需要 · 重连：需要 |
| 必填 会话监控默认开启switch | 决定新会话是否默认采集收发和活动计数。fmq.runtime.session-monitoring-default-enabled | 默认：false推荐：先保持当前值 false；按现场容量评估后调整示例：false | 开启（true）：允许对应能力按配置运行。；会影响新连接、新会话或对应运行策略。关闭（false）：停止默认启用对应能力。；可能阻止新连接、停止默认采集或减少运行开销。 | 全局；立即生效 | 范围：全局发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 最近消息默认开启switch | 决定新会话是否默认保留最近报文摘要。fmq.runtime.session-recent-messages-enabled | 默认：false推荐：先保持当前值 false；按现场容量评估后调整示例：false | 开启（true）：允许对应能力按配置运行。；会影响新连接、新会话或对应运行策略。关闭（false）：停止默认启用对应能力。；可能阻止新连接、停止默认采集或减少运行开销。 | 全局；立即生效 | 范围：全局发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 设备追踪目标上限field | 限制集群内同时追踪的设备数量。fmq.runtime.device-trace.max-active-targets | 默认：10推荐：先保持当前值 10；按现场容量评估后调整示例：10 | 不适用 | 全局；立即生效 | 范围：全局发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 设备追踪保留天数field | 设备追踪历史的默认保留周期。fmq.record.retention.device-trace-history-days | 默认：30推荐：先保持当前值 30；按现场容量评估后调整示例：30 | 不适用 | 全局；立即生效 | 范围：全局发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 规则执行日志保留天数field | 规则执行日志的默认保留周期。fmq.record.retention.rule-execution-log-days | 默认：15推荐：先保持当前值 15；按现场容量评估后调整示例：15 | 不适用 | 全局；立即生效 | 范围：全局发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 规则重放审计保留天数field | 规则重放审计的默认保留周期。fmq.record.retention.rule-replay-audit-days | 默认：30推荐：先保持当前值 30；按现场容量评估后调整示例：30 | 不适用 | 全局；立即生效 | 范围：全局发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 记录查询默认窗口field | 查询未指定时间范围时默认读取最近天数。fmq.record.query-default-window-days | 默认：7推荐：先保持当前值 7；按现场容量评估后调整示例：7 | 不适用 | 全局；立即生效 | 范围：全局发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 记录清理批次field | 单次历史记录清理的最大行数。fmq.record.cleanup.batch-size | 默认：1000推荐：先保持当前值 1000；按现场容量评估后调整示例：1000 | 不适用 | 全局；立即生效 | 范围：全局发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 FastBee WEB 地址field | FMQ 调用 FastBee WEB 协议助手接口的基础地址；Token 不在此页填写。fmq.protocol.ai.web-base-url | 默认：空推荐：先保持当前值 空；按现场容量评估后调整示例：空 | 不适用 | 全局；立即生效 | 范围：全局发布：不需要 · 重启：不需要 · 重连：不需要 |
完整参考 2
| 字段/控件 | 用途与原始键 | 默认/推荐/示例 | 选项说明 | 作用与影响 | 生效条件 |
|---|---|---|---|---|---|
| 必填 数据库连接地址display | MySQL 主配置库连接地址，只在本页展示，不可运行期修改。spring.datasource.hikari.jdbc-url | 默认：当前 JDBC 地址推荐：由部署侧按容量与环境统一维护示例：当前 JDBC 地址 | 不适用 | 全局；应用重启 | 范围：全局发布：不需要 · 重启：需要 · 重连：不需要 |
| 必填 事件总线 RingBufferdisplay | 设备事件总线的环形缓冲区容量，只能由部署侧调整。fmq.disruptor.buffer-size | 默认：8192推荐：由部署侧按容量与环境统一维护示例：8192 | 不适用 | 全局；应用重启 | 范围：全局发布：不需要 · 重启：需要 · 重连：不需要 |
| 必填 HTTP 管理端口display | 控制台与 API 服务使用的 HTTP 端口，只读展示。server.port | 默认：18083推荐：由部署侧按容量与环境统一维护示例：18083 | 不适用 | 全局；应用重启 | 范围：全局发布：不需要 · 重启：需要 · 重连：不需要 |
生产操作提示
截图和示例用于说明操作位置与判断方法，不代表当前生产状态。涉及发布、启停、重绑、重试或删除时，应先确认目标环境、影响范围和恢复方案，并由授权人员执行。
蜂信物联（FastBee） · FMQ 操作手册