运维与 Web 指令面
验证状态：本页为接入视角新写（19 号票）。事实取材自清单层生成页（provenance 见各链接目标）、机构手册已核验场景正本与运行时生成页，本页自身不做二次核验、未联调。
用途与场景
采集服务器的运维三件事：内网 IP 自报与 DMS 推送链、固件同步、以及必须实现的 Web 指令面 data/v1。这是接入动线的最后一步——把前三步的身份、清单、消息链组装成可被机构 Web 管理与回放的完整服务。
内网 IP 自报与 DMS 推送链
PUT /device-service/main-api/device/data-acquisition-server/updateInternalIpByDataAcquisitionServerNo —— 按编号更新采集服务器内网 IP（本模块唯一的写端点）。契约见清单层 · data-acquisition-server与设备业务 · internal-ip-and-dms-sync。
自报后的中心侧行为链（引用，不复述）：内网 IP 更新触发采集服务器信息同步——中心按该服务器遍历关联采集设备、比对在线状态，并按需向设备推送 DMS 载荷（下行 topic device/{deviceNo}/iot/deliver/v1，动态下行表见MQTT 主题清单）。采集服务器无需订阅该链的任何 topic，但应知道 DMS 载荷会直达名下设备。
固件链
- 采集服务器自身固件：机构 Web 触发
server/{serverNo}/iot/retrieve/v1（items:["firmware"]），中心消费后把固件信息投递到采集服务器侧server/{serverNo}/iot/deliver/v1——场景正本见触发采集服务器固件信息下发（server retrieve）（含应答形态与已知缺口的已核验叙事）；谓词族契约见MQTT 主题清单 · 谓词族。采集服务器需订阅自身 deliver topic 并处理固件下载/升级（机构正本已标注该侧行为缺证）。 - 名下设备固件：设备变体
device/{deviceNo}/iot/retrieve/v1与固件包管理面（HTTP）见文件上报与检索与机构手册设备与资产域 · firmware-package；固件包多节点一致性由中心侧定时对账（分钟级周期）保障——定时任务全表见data-service 定时任务。 - 固件包条目查询（管理侧）：
POST /main-service/main-api/device/firmware-package/list—— 查询固件包列表（清单层 · 业务）。
Web 指令面：server/{serverNo}/data/v1/*（采集服务器必须实现）
机构 Web 对采集服务器的遥控与文件查询不经过中心后端：Web 把请求发布到 server/{serverNo}/data/v1/<command>，Broker 直达采集服务器，应答按请求信封 reply topic 回流。中心网关不消费这些 topic（订阅面无 server/+/data/#，见MQTT 主题清单 · 服务端订阅面）——实现责任完全在采集服务器侧。
机构手册已核验的命令全集（14 个 topic + 动态媒体 URL），逐命令正本是实现方的需求清单：
| 域 | 命令 | 机构正本 |
|---|---|---|
| 遥控·信息读取 | server/{serverNo}/data/v1/serverinfo（运行概要） |
读取采集服务器概要 |
| 遥控·信息读取 | …/data/v1/disk（磁盘列表） |
读取磁盘信息 |
| 遥控·信息读取 | …/data/v1/service（受管服务列表） |
读取服务列表 |
| 遥控·信息读取 | …/data/v1/sysconfig（系统配置） |
读取系统配置 |
| 遥控·写操作 | …/data/v1/partition（分区启停/排序） |
启用/禁用磁盘分区 |
| 遥控·写操作 | …/data/v1/sysconfig-update（更新系统配置） |
更新系统配置 |
| 遥控·写操作 | …/data/v1/refresh_service（应用磁盘变更并重启服务） |
触发磁盘服务刷新 |
| 遥控·写操作 | …/data/v1/service-restart（重启指定服务） |
重启服务 |
| 遥控·固件 | server/{serverNo}/iot/retrieve/v1 → …/iot/deliver/v1 |
触发固件信息下发 |
| 回放·文件链 | …/data/v1/list-file-existence / list-file-category-total / list-file-info / gps / decrypt |
回放与文件域 5 页 |
| 回放·媒体 | 动态媒体 URL（应答值 ip/port/playUrl 构造） |
回放媒体播放与下载地址 |
通道口径与请求形态（{id, reply, params} 信封、reply 回流、QoS 等 wire 约定）不复述：正本页与设备服务接口规范、MQTT 连接与消息边界是权威来源。
在线状态的对账口径
除命令驱动的在线刷新（见设备消息链（MQTT））外，中心每日凌晨另有在线状态对账兜底——定时任务全表见data-service 定时任务；相关服务端缓存见设备业务 · 运行时关联与data-service 缓存。
已知缺口
data/v1命令面没有清单层条目：这些 topic 中心不消费、不在 MQTT 主题清单页，上表的 14 个 topic 是从机构手册已核验场景页反推的全集——是否存在 Web 未现役的更多data/v1命令，无权威来源可证。- 遥控族与回放链的应答权威 schema 均以机构正本的「存在关键缺口」口径为准（采集服务器侧服务源码不在机构核验工作区），实现方应按正本「已知缺口」小节逐项确认。
- DMS 载荷内容无 schema 真源（清单层口径「源码归纳，无 schema 真源」）。