网络诊断
功能简介
网络诊断是一项故障排查工具。当出现设备离线、指令失败、直播不通、媒体上传失败、操控卡顿等问题时,运维人员可手动对指定机场发起网络探测,从网络层快速定位「哪一段网络断开」或「哪个端口被拦截」。
- 人工触发:仅在排查故障时手动发起,不做定时巡检。
- 按场景探测:根据遇到的问题选择对应场景,系统只执行相关探测项,更快定位根因。
- 机场端执行:探测动作由机场执行,探测方向为「机场 → 平台」,结果回报至平台统一展示。
使用前提
发起诊断前请确认以下条件,任一不满足时系统会提示对应原因并终止:
| 前提 | 说明 |
|---|---|
| 已创建组织 | 需先在司空管理后台创建组织,否则无法发起诊断。 |
| 设备在线 | 探测指令通过 MQTT 下发至机场,设备离线时无法触发。 |
| 机型支持 | 部分机型暂不支持网络诊断,设备列表中对应操作不可用。 |
| 固件版本满足要求 | 设备固件低于要求版本时无法诊断,需先升级固件。设备列表的「固件版本」列可查看当前版本。 |
| 无正在进行的诊断 | 同一设备同时只能执行一个诊断任务,需等待当前任务结束。 |
执行诊断
1. 选择设备
登录 AIO 管理后台(参见《进入 AIO 管理后台》),在左侧导航进入「网络诊断」。设备列表展示各机场的名称、SN、状态、固件版本与最后上线时间,支持按设备名称或 SN 搜索。在目标设备所在行点击「网络诊断」。

2. 选择诊断场景
根据遇到的问题选择对应场景,选中后会显示本次预计耗时,再点击「开始诊断」。未选择场景时「开始诊断」不可点击。

| 场景 | 适用症状 |
|---|---|
| 设备离线 | 设备无法上线 / 频繁掉线 |
| 指令失败 | 指令下发超时 / 无响应 |
| 直播不通 | 直播看不到画面 / 卡顿 |
| 媒体回传 | 照片 / 视频上传失败 |
| 操控延迟 | 实时操控卡顿 / 失效 |
| 全部场景 | 完整探测所有链路 |
系统只执行与所选场景相关的探测项,各场景的探测项与耗时详见下文「探测项说明」。
3. 查看探测进度
诊断开始后,弹窗实时显示整体进度(「已完成 N / 总数」)与每个探测项的状态。

探测项状态取值:
| 状态 | 说明 |
|---|---|
| 等待中 | 尚未开始探测 |
| 探测中 | 正在执行该探测项 |
| 正常 | 探测通过 |
| 异常 | 探测未通过 |
| 状态未知 | 未获取到探测结果 |
说明:若页面提示「进度获取已中断,探测可能仍在设备侧执行」,表示平台与前端之间的进度推送中断,但设备侧探测可能仍在继续,可点击「重新获取」恢复进度显示。
查看诊断结果
探测完成后,所有结果在同一页面展示,无需跳转。

结果页从上到下依次为:
- 结论横幅:显示「发现 N 个问题」或「网络诊断通过」。
- 异常项卡片:每张卡片对应一个异常的探测项,展示错误码与该异常影响的场景。一个探测项异常可能影响多个场景,例如 ICMP Ping 异常会同时影响全部场景。部分异常由服务未启用导致,此时不显示错误码,直接说明原因(例如「GB28181 未启用」)。
- 探测明细:列出全部探测项的目标、结果、延迟与备注。探测正常时备注显示探测数据(如「端口可达」「3ms / 0% 丢包」);探测异常时备注显示错误码与含义(如
1208 kPingPartialLoss · 部分丢包(通但有丢失))。 - Traceroute 路径:展示机场至平台的逐跳路径。未响应的跳显示为
* * *,目标节点所在跳会特别标注。
问题修复后,点击「重新诊断」验证修复效果。
若诊断通过但业务仍异常,问题可能出在应用层(如证书过期、认证失败),请结合服务日志进一步排查。
探测项说明
网络诊断共有 12 个探测项,均为「机场 → 平台」方向。选择「全部场景」时全部执行,选择具体场景时只执行与该场景相关的探测项。
| 探测项 | 探测内容 | 相关业务 |
|---|---|---|
| 机场 → 平台 ICMP Ping | 基础连通性、延迟与丢包 | 全部业务的基础 |
| 机场 → 平台 MQTT 端口(HTTP) | MQTT 明文端口可达性 | 设备上线、指令下发 |
| 机场 → 平台 MQTT 端口(HTTPS) | MQTT 加密端口可达性 | 设备上线、指令下发 |
| 机场 → 平台 EMQX WS 端口 | 设备操控 WebSocket 端口可达性 | 实时操控 |
| 机场 → 平台 直播服务 HTTP 端口 | 直播信令端口可达性 | 直播 |
| 机场 → 平台 直播服务 GB28181 SIP 端口 | GB28181 信令端口可达性 | 直播(GB28181 接入) |
| 机场 → 平台 直播服务 RTMP 端口 | RTMP 推流端口可达性 | 直播 |
| 机场 → 平台 直播服务 RTSP 端口 | RTSP 拉流端口可达性 | 直播 |
| 机场 → 平台 直播服务 质量上报端口 | 直播质量上报端口可达性 | 直播质量监控 |
| 机场 → 平台 MinIO 对象存储端口 | 对象存储端口可达性 | 媒体回传 |
| 网络测速 | 上下行速率 | 直播、媒体回传、操控 |
| Traceroute | 机场至平台的网络路径与逐跳延迟 | 定位链路问题位置 |
探测目标为平台地址与对应服务端口,端口清单参见《网络要求》。若部署时修改过默认端口,探测目标会使用实际配置的端口。
各场景执行的探测项如下:
| 探测项 | 设备离线 | 指令失败 | 直播不通 | 媒体回传 | 操控延迟 |
|---|---|---|---|---|---|
| 机场 → 平台 ICMP Ping | ● | ● | ● | ● | ● |
| 机场 → 平台 MQTT 端口(HTTP) | ● | ● | — | — | — |
| 机场 → 平台 MQTT 端口(HTTPS) | ● | ● | — | — | — |
| 机场 → 平台 EMQX WS 端口 | — | — | — | — | ● |
| 机场 → 平台 直播服务 HTTP 端口 | — | — | ● | — | — |
| 机场 → 平台 直播服务 GB28181 SIP 端口 | — | — | ● | — | — |
| 机场 → 平台 直播服务 RTMP 端口 | — | — | ● | — | — |
| 机场 → 平台 直播服务 RTSP 端口 | — | — | ● | — | — |
| 机场 → 平台 直播服务 质量上报端口 | — | — | ● | — | — |
| 机场 → 平台 MinIO 对象存储端口 | — | — | — | ● | — |
| 网络测速 | — | — | ● | ● | ● |
| Traceroute | ● | ● | ● | — | — |
| 探测项数量 | 4 | 4 | 8 | 3 | 3 |
「全部场景」执行全部 12 个探测项。各场景的预计耗时:设备离线与指令失败约 30 秒,直播不通、媒体回传、操控延迟约 90 秒,全部场景约 120 秒。
说明:包含网络测速的场景(直播不通、媒体回传、操控延迟、全部场景)耗时明显更长,且会占用带宽,建议在业务低峰期执行。
结果解读时请注意:
- ICMP Ping 不通不代表网络不通。部分网络环境仅拦截 ICMP,此时端口探测仍可正常通过,业务不受影响。
- 端口可达不代表上层协议可用。端口探测只验证 TCP 连接能否建立,无法发现证书过期、认证失败等应用层问题。
- Traceroute 中间跳显示
* * *属正常现象。多数路由器禁用或限速 ICMP 回包,只要目标节点可达即说明链路连通。 - 网络测速会占用带宽,建议在业务低峰期执行。
错误码说明
探测失败时,结果页的异常卡片与探测明细中会显示错误码及其含义,格式为「错误码 常量名 · 含义」,例如 1208 kPingPartialLoss · 部分丢包(通但有丢失)。
ICMP Ping 错误码
| 错误码 | 界面含义 | 处理建议 |
|---|---|---|
| 1201 | socket 创建失败 | 机场端探测程序异常,请重新诊断;持续出现请联系售后 |
| 1202 | 发送 ICMP Echo 失败 | 检查机场网络接口状态后重新诊断 |
| 1203 | 接收 ICMP Echo Reply 失败 | 重新诊断;持续出现请联系售后 |
| 1204 | 全程未收到任何回包 | 平台不可达或 ICMP 被防火墙拦截。请结合端口探测结果判断:若端口探测正常,通常是 ICMP 被拦截,业务不受影响 |
| 1205 | 目标不可达(收到 ICMP Destination Unreachable) | 检查机场至平台的路由与网关配置,并结合 Traceroute 路径定位问题位置 |
| 1206 | host 非法(空/格式错误) | 检查平台访问地址配置是否正确 |
| 1207 | 域名解析失败 | 使用域名访问平台时,检查机场侧 DNS 配置 |
| 1208 | 部分丢包(通但有丢失) | 链路质量不稳定,检查网络拥塞、无线或 4G 信号质量 |
端口探测错误码
| 错误码 | 界面含义 | 处理建议 |
|---|---|---|
| 1401 | host 非法(空/格式错误) | 检查平台访问地址配置是否正确 |
| 1402 | 域名解析失败 | 使用域名访问平台时,检查机场侧 DNS 配置 |
| 1403 | socket 创建失败 | 机场端探测程序异常,请重新诊断;持续出现请联系售后 |
| 1404 | 连接失败(端口拒绝/不可达) | 平台可达,但该端口无服务监听。通常为平台服务未启动或端口配置错误,请联系平台运维检查服务状态 |
| 1405 | 连接超时(无 SYN-ACK) | 连接请求被丢弃,通常为防火墙或安全策略拦截。请联系网络运维放行对应端口 |
| 1406 | 部分握手失败(通但有丢失) | 链路不稳定,检查网络拥塞或丢包情况 |
| 1407 | 端口非法 | 检查端口配置是否正确 |
1404 与 1405 的区分是定位端口问题的关键:1404 表示平台主动拒绝连接,问题在平台服务侧;1405 表示请求无响应,问题通常在网络链路的防火墙或安全策略上。
无法发起诊断的提示
点击「网络诊断」后若无法发起,页面会提示具体原因:
| 提示 | 处理方式 |
|---|---|
| 司空尚未创建组织,请先在司空管理后台创建组织后重试 | 先在司空管理后台创建组织 |
| 设备已离线,无法执行网络诊断 | 待设备恢复在线后重试 |
| 该设备机型不支持网络诊断 | 该机型暂不支持,无需处理 |
| 设备固件版本不满足网络诊断要求,请升级至指定版本及以上版本后重试 | 先升级设备固件 |
| 该设备正在诊断中,请等待当前诊断结束后重试 | 等待当前诊断结束 |
| 网络诊断服务未就绪,请稍后重试 | 稍后重试;持续出现请联系售后 |
| 网络诊断执行失败,请稍后重试 | 稍后重试;持续出现请联系售后 |
| 环境异常,获取设备列表失败 | 检查平台服务状态;持续出现请联系售后 |
设备离线时
设备离线时,诊断弹窗仅显示离线提示,不提供探测入口。

请按以下方向排查:
- 机场供电是否正常。
- 机场网络是否接入(网线 / 4G 信号)。
- 防火墙策略是否变更。
- VPN / 专线是否中断。
设备恢复在线后,可再次执行网络诊断。
使用限制
- 仅探测「机场 → 平台」方向:平台至终端(如浏览器、遥控器)的网络段不在探测范围内。
- 仅覆盖网络层:端口探测只能确认端口可达,无法识别「端口可达但协议不可用」的情况(如证书过期、认证失败),此类问题需结合服务日志排查。
- 不支持 MTU 探测:VPN 等场景下「ping 正常但大文件传输失败」的问题无法通过本功能诊断。
- 不支持独立的 DNS 探测:使用域名访问平台时,DNS 故障会体现为域名解析失败错误(1207、1402)。
- 网络测速会占用带宽:在业务高峰期执行可能对正在进行的直播或作业造成短暂影响,建议在业务低峰期执行。