设备离线或发现不到

先区分“平台没有发现候选设备”“设备记录存在但认证失败”“设备注册过后离线”“通道离线”。四种现象的检查层不同。

flowchart LR
    A[设备不在线] --> B{平台是否有设备记录?}
    B -->|没有| C[发现、注册和网络]
    B -->|有| D{认证是否成功?}
    D -->|没有| E[账号、时间和鉴权]
    D -->|有| F[心跳、目录、拉流和通道状态]

所有协议共用检查

1. 记录设备、通道、节点和故障时间。
2. 从实际 AKStream.Next/MediaServer 节点到设备测试路由，不用操作者电脑代替。
3. 确认 IP、网关、VLAN、VPN、防火墙与时钟。
4. 查最近是否修改设备密码、地址、固件、平台端口或 NAT。
5. 判断单台、单网段、单协议还是全部设备受影响。

ONVIF 发现不到

• 服务器选择了正确网卡。
• WS-Discovery 组播没有被 VLAN、VPN 或防火墙阻断。
• 设备已启用 ONVIF 服务。
• 跨网发现不可靠时直接使用 XAddr/IP。

发现到但认证失败时检查凭据、账号锁定、设备时间、WS-Security 和 HTTP/HTTPS。Profile 能读取但通道无流时转到 没有画面。

GB28181 无法注册或掉线

检查设备配置的平台 IP、SIP 端口、域、设备 ID 和密码；查看 REGISTER、401 挑战、鉴权与心跳。NAT 环境要区分监听端口与公告端口，公告值不会自动开放防火墙。

注册稳定但没有通道时检查 Catalog 请求、SN、分包、编码和设备响应；有通道但点播失败则检查 INVITE、SDP 和 RTP。

RTSP 来源离线

从负责拉流的 MediaServer 节点直接验证 URL。检查凭据、设备并发连接数、RTSP TCP/UDP、源地址变化和设备是否被其他客户端占满。

不要立即删除重建

删除重建可能让设备“看起来恢复”，同时切断稳定通道 ID、录像历史与外部映射。优先修复地址或凭据、重新同步和重试；只有确认资产已永久移除时才按 通道生命周期 清理。

恢复判据

• 设备在预期心跳窗口内保持在线。
• 重连后通道身份不重复、不丢失。
• 至少一条真实流可以建立并播放。
• 协议日志不再持续认证失败或超时。
• 故障原因与变更被记录，而不是仅写“重启恢复”。