第 09 章
⚙️系统管理
运维
平台自己的「体检报告」。出问题时先看这里。
左侧点击「系统管理」。
本页操作说明:体检页只读——所有状态由平台自动探测,无需点击;按下面的「故障排查表」对照处理即可。

页面分区(对照上图)
| 图上位置 | 区块 | 出问题时先看它 |
|---|---|---|
| 第一排 | 平台状态卡(6 张) | 网页服务、坏通道标注数 |
| 第二块 | 接口健康表 | 哪个上游接口异常 |
| 第三块 | 坏通道明细 | 具体哪几路、什么原因 |
平台状态卡逐张详解
| 卡片 | 含义 | 正常值 | 异常时怎么办 |
|---|---|---|---|
| 页面服务 | 网页服务是否活着 | 5090 正常 | 找技术人员重启服务 |
| 中转流路数 | 当前有几路在转码 | 看你正在看几路 | 与「正在输出」对不上 = 自愈中 |
| 正在输出 | 已出画面的路数 | 同上 | 差值大说明建流慢,等 20-30 秒 |
| 坏通道标注 | 平台实测不可用的路数 | 0 最理想 | 现场查对应通道接线 |
| 已标注名称 | 起过名字的通道数 | 16 | 少了说明还没标完,不影响使用 |
| 快照时间 | 数据最近更新时间 | 看时钟 | 长期不动 = 采集线程卡住 |
接口健康表
列出中控台对接的 10 个上游工地会线接口(经开发与优化协议兼容客户端——原平台只有网页没有开放接口,这些对接是逐个抓包逆向生产站通信协议实现的,前端从不接触上游令牌),每个标注:
- 来源——对应哪个数据接口
- 状态——正常 / 空数据 / 异常
- 数据量——拿到了多少条
看到「空数据」不用慌——那是该模块数据施工方未提供(比如配电箱、BIM)。 只有红色「异常」才需要找技术人员。
十个接口速查(哪个数据来自哪)
| 接口 | 供哪个模块用 | 典型状态 |
|---|---|---|
| 视频通道列表 | 项目管理 / 视频监控 | 正常,16 条 |
| 设备心跳状态 | 看板「通道在线」 | 正常 |
| 项目档案 | 项目管理概况卡 | 正常 |
| 班组列表 | 项目管理班组表 | 正常,10 组 |
| 平台账号 | 通讯录账号表 | 正常,4 条 |
| 工人库分页 | 通讯录工人库 | 正常,162 万条 |
| 扬尘实时值 | 安全质量 / 环境监测 | 正常 |
| 排放记录 | 安全质量「排放记录条数」 | 空数据(尚无记录) |
| 配电箱数据 | 项目管理配电箱 | 空数据(施工方未提供) |
| 9908 号模块 | —— | 空数据(如实留白,不造数) |
为什么要分「空数据」和「异常」两种状态? 空数据 = 接口调通了但上游没有内容;异常 = 接口本身调不通(网络、令牌、协议变更)。 只有异常需要修,空数据是项目侧事实。
坏通道明细
列出每一路被判为不可用的通道,以及具体原因。
当前实测不可用(8 路,平台服务端每 25 分钟探测一次):
| 通道 | 原因 |
|---|---|
| CH1 / CH5 / CH7 / CH8 / CH10 / CH13 / CH14 / CH16 | 设备返回错误码4:该通道/NVR 当前不可用 |
这是摄像头侧的问题,不是平台的问题。 需要现场检查这几路的摄像头和 NVR 接线。
这份名单会随摄像头状态变动,以平台「系统管理」页实时显示为准。 最近一次变化(2026-10-15 复核):CH5 / CH8 / CH10 / CH13 由可用转为不可用。
探测机制怎么跑
- 服务端每 25 分钟起一轮探测,对 16 路逐路真实建流试播(不是查心跳表)。
- 设备侧返回的错误码归一化后分类:「错误码4」= 通道/NVR 不可用。
- 判定的结果直接写进通道标注,不依赖网页端,所以没人打开平台时也在探。
- 摄像头修好后,下一轮探测自动消掉红色标记,无需人工点击「刷新」。
本页可点元素一览
体检页全是自动探测结果,没有需要点击的按钮;能点的只有导航与跳转:
| 可点元素 | 位置 | 作用 | 注意 |
|---|---|---|---|
| 左侧模块菜单「系统管理」 | 控制台左侧 | 打开体检页 | 只读,页面不会自动刷新,按需重进 |
| 6 张平台状态卡 | 第一排 | 逐张判断哪一项异常 | 「坏通道标注」不为 0 需现场查线路 |
| 接口健康表「状态」列 | 第二块 | 分辨「空数据」与「异常」 | 空数据不用修,红色「异常」才要修 |
| 坏通道明细表 | 第三块 | 看具体哪几路、错误码是什么 | 名单随 25 分钟一轮探测更新 |
| 故障排查表「重新连接」 | 排查表第 2 行 | 视频卡住时去视频页重试 | 见《视频监控》一章的按钮速查 |
| 页尾跳转卡 | 页尾 | 跳到快速开始 / 视频 / 现场 / 历史 | 出问题时按这张卡逐层排查 |
故障排查表
| 现象 | 原因 | 怎么办 |
|---|---|---|
| 网页打不开 | 服务没启动 | 找技术人员重启服务 |
| 视频一直转圈 | 首次建流需 20-30 秒 | 等 1 分钟,超时点击「重新连接」 |
| 「并发数达到上限」 | 有人其他位置正在播放视频 | 关掉原平台视频页和其他标签页 |
| 顶部红字「分发异常」 | 转码器自愈中 | 等十几秒自动恢复 |
| 某通道一直不可用 | 摄像头或线路故障 | 现场查那一路的摄像头接线 |
| 环境数据很久没变 | 上游没推送 | 该设备「数据推送」显示「未开通」,属项目侧配置 |
| 看板数字不刷新 | 采集线程卡住 | 看「快照时间」,不前进就找技术人员 |
| 进不去、提示登录 | OA 会话失效 | 重新登录 OA,再进中控台 |
给技术人员的四条硬约束
这部分不用记,出事时技术人员照着做就行。
- 上游只许 1 路流,但观众侧靠中转共享——中转服务独占那 1 路并向所有观众 1→N 分发,同一路多人同看互不踢;一个观众都不剩立即断流、归还并发名额(额度自动回收,不会白占)。
- 「直连」是独占模式——会把唯一名额吃在你这里,其他用户(含中转服务)均无法访问;切换前有弹窗警告,看完记得切回中转。
- 摄像头不可用由平台自动判定——探测引擎每 25 分钟对 16 路逐路真实试播,错误码归一后标注坏通道,不依赖网页端;分发异常另有十几秒级自愈,自愈不好的才需要人工介入。
- 登录态随 OA 失效——身份每次回问 OA 复核(媒体高频路径只做本地签名验证以保流畅),OA 一注销中控台立即失守,不缓存身份。