GoWVP常见故障终极排查清单：播放黑屏、设备离线、通道拿不到等FAQ详解

GoWVP常见故障终极排查清单播放黑屏、设备离线、通道拿不到等FAQ详解【免费下载链接】owlGB28181 - 2022 NVR | ONVIF/RTMP/RTSP | ZLMediaKit | 本地 YOLO 检测 | 私有部署 | Frigate 中文平替项目地址: https://gitcode.com/gh_mirrors/owl50/owlGoWVPowl是一个开箱即用的GB28181 视频监控平台同时支持 2022/2016/2011 版本国标协议以及 ONVIF、RTMP、RTSP 接入内置本地 YOLO 检测告警是 Frigate 的中文平替。本文整理新手部署时最常见的故障播放黑屏、设备离线、拿不到通道并提供一份可直接照做的排查清单。部署前 30 秒自检90% 的故障出在这 3 个地方在深挖具体症状之前先花 30 秒确认三处基础配置。绝大多数GB28181 平台黑屏、离线问题都源于此收流 IP 是否可达configs/config.toml中Media.SDPIP与Media.WebHookIP必须是局域网 IP不能填127.0.0.1Hook 回环地址是否正确ZLM 回调 GoWVP 的地址docker 合并部署填127.0.0..1即可分离部署必须填真实 IP端口是否放行GB28181 SIP 端口15060TCP/UDP与收流端口段20000-20100TCP/UDP需被摄像头/NVR 可访问。播放黑屏怎么排查️ 症状点击播放后一直转圈或直接黑屏日志提示 zlm 连接不上。场景一ZLM 流媒体服务没起来程序会自动识别容器环境并主动拉起 ZLM支持 docker/containerd/podman。如果确实没拉起来在 compose 文件中设置环境变量后重启容器试试environment: - NVR_STREAMZLM场景二IP 配置错误容器内 ZLM 与 owl 互访默认127.0.0.1即可收流 IPSDP IP必须填写局域网 IP填 127.0.0.1 是黑屏最高频原因。在 Web 端可检查「快捷桌面」→ ZLM 右上角设置 →国标收流默认地址该地址必须能被监控设备访问到和Hook IPZLM 能否访问到 GoWVP。场景三NVR 或老旧摄像头黑屏部分 NVR 和老设备对 TCP 收流兼容性不佳解决方法进入「监控」→「管理」找到对应设备选择「编辑」→「下一步」将收流模式修改为 UDP等待 1 分钟后重新点击通道播放。设备离线、通道拿不到怎么办 症状设备注册成功但通道列表为空或设备在线、通道却显示离线。拿不到通道核对 Server ID设备注册上了却没通道十有八九是 Server ID 不一致进入「监控」→「接入信息」页面记下平台侧的server id登录摄像机后台检查其中填写的 server id两者不一致就修改为一致重新注册即可。设备在线、通道离线核对 SIP ID 与域这属于 IPC后端摄像头自身配置问题请检查 IPC 后台注册的平台 sip_id 和域是否与 GoWVP 配置一致。GoWVP 侧的 20 位国标 ID 在configs/config.toml的Sip.ID中定义。设备频繁掉线理解心跳机制GoWVP 依据设备心跳判断在线状态见 pkg/gbs/keepalive.go 的sipMessageKeepalive收到心跳即标记在线。如果设备侧配置为超时 3 秒、次数 3 次则约9x 秒收不到心跳就判定离线x 为检测间隔周期。跨 NAT 部署时请确认心跳报文没有被防火墙丢弃。其他高频 FAQ 速查列表里只有部分通道实际有 n 个这是设计如此单设备超过 4 个通道时列表只展示部分请在「管理页」查看或点击右侧的查看更多。使用 nginx 反向代理后播放地址无法播放反向代理需透传以下头信息域名按实际填写否则 WebRTC 与快照地址会拼错proxy_set_header X-Forwarded-Host $host; proxy_set_header X-Forwarded-Prefix https://your-domain.com; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection upgrade;开启 AI 分析后没人观看流也不停属正常现象AI 分析会自行拉取一路流做检测程序视为有人观看。注意开启分析后每路流约占用200MB 内存 2 核 CPU如不需要可在configs/config.toml中设置Server.AI.Disabled true全局关闭。想换数据库修改configs/config.toml中Data.Database.DsnSQLite 填本地文件路径推荐默认./configs/data.dbPostgreSQL/MySQL 按db_type://user:pwdip:port/db_name?sslmodedisable格式填写。播放卡顿、快照加载失败检查播放页右上角的流地址协议是否与部署环境匹配HTTP 环境请用 http-flv/ws-flvHTTPS 环境需 wss。RTMP 推流规则可参考configs/config.toml中的RTMPSecret。故障排查速查表症状优先检查解决方案播放黑屏日志报 zlm 连不上ZLM 是否启动compose 加NVR_STREAMZLM重启播放黑屏无报错收流 IP / Hook IPSDPIP 填局域网 IPHook IP 填 GoWVP 可达地址NVR/老摄像头黑屏收流模式「管理」→ 编辑设备 → 收流模式改UDP注册成功但拿不到通道Server ID摄像机后台 server id 与「接入信息」页一致设备在线、通道离线SIP ID / 域IPC 后台的平台 sip_id、域与 GoWVP 一致通道列表不全无设计如此点「查看更多」或进管理页nginx 反代后无法播放代理头配置 X-Forwarded-Host / Upgrade 等头AI 开启后流不停无正常现象AI 自身拉流相关配置与源码位置排查时可对照以下文件快速定位全局配置configs/config.tomlSIP ID、收流 IP、Hook IP、数据库、AI 开关均在此国标信令与心跳实现pkg/gbs/register.go、pkg/gbs/keepalive.go通道目录查询逻辑pkg/gbs/catalog.go媒体服务ZLM驱动internal/core/sms/driver_zlm.go部署编排docker-compose.yml按照本文清单从上到下逐项核对播放黑屏、设备离线、通道拿不到这三类高频故障基本都能快速定位。祝部署顺利早日看到画面【免费下载链接】owlGB28181 - 2022 NVR | ONVIF/RTMP/RTSP | ZLMediaKit | 本地 YOLO 检测 | 私有部署 | Frigate 中文平替项目地址: https://gitcode.com/gh_mirrors/owl50/owl创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考