EasyCVR实战：GB28181协议告警接收配置与排障指南

我接触视频融合类项目也不少时间了，EasyCVR算是经常用到的平台之一，尤其是在做GB28181设备接入、需要把摄像头的报警事件集中收上来的时候，告警接收这块真是绕不开的坎。很多朋友跟我反馈说，设备写上平台了，视频也看着了，结果一触发移动侦测，平台这边一点反应都没有，问题往往就出在告警接收的配置上。这篇文章就把我在EasyCVR上配置GB28181协议告警接收的完整流程和踩坑记录写出来，从原理到实操、从抓包到参数设置都说清楚，给正在做类似项目的人一个参考。

1. 告警接收是怎么一回事：先弄明白GB28181的事件上报链路

1.1 GB28181协议里“告警”的本质

GB28181全称是《公共安全视频监控联网系统信息传输、交换、控制技术要求》，它的底层通信是SIP协议，设备作为SIP UA主动向平台注册，注册成功之后，设备和平台之间所有的指令、状态、报警信息都通过SIP消息来回传递。我们平时说的“告警接收”，本质上就是设备侧在检测到报警事件时，通过SIP MESSAGE消息把一条XML格式的报警通知推到平台，平台收到后解析入库，再决定是弹窗、联动录像还是推送第三方。

这个链路里最容易忽略的一点是：视频流和报警流是两码事。视频流走的是RTP/RTSP，报警走的是SIP信令，哪怕视频看得很流畅，也不代表报警通道就通了。所以在排障的时候，我会把“视频在线”和“告警上报”完全分开看，这两个不互相保证。

1.2 一条告警从产生到落地的完整路径

拿常见的摄像机移动侦测报警举例，完整路径大概是这样的：

1. 摄像机本地配置了移动侦测区域并开启报警输出。
2. 设备检测到画面变化，触发报警。
3. 设备将报警信息打包成GB28181标准的Alarm通知，通过SIP MESSAGE发送给平台。
4. EasyCVR作为SIP服务器收到消息，校验设备ID、解析XML字段。
5. 平台根据本地配置，将告警写入事件记录，同时触发联动策略，比如启动录像、调用HTTP接口推给第三方的业务系统。

也就是说，告警要成功接收，需要设备侧配置正确、平台侧开启接收、网络链路畅通、XML解析兼容四个条件同时成立。任何一个环节断了，表面上都“收不到告警”。

1.3 EasyCVR平台在告警接收上的设计逻辑

EasyCVR本身的定位是视频融合网关，它把GB28181、RTSP、ONVIF等不同协议的设备统一接入，再向上层业务提供统一的API。告警接收这一块，它的设计思路是“先接入、再订阅、后分发”。

平台内部其实做了两层处理：底层是GB28181协议栈，负责接收和解析SIP消息；上层是事件引擎，把解析出来的告警转换成内部事件，然后通过平台的事件管理页展示，或者通过回调渠道推出去。所以配置的时候，不能只看“有没有接收开关”，还要看事件回调、告警联动这些上层配置是不是也一并设置了。很多人只开了设备接入，没开事件订阅，结果告警肯定进不来。

2. 配置前的准备工作：这些基础条件不满足，后面全白搭

2.1 确认平台版本和功能授权

先说一个很现实的问题：EasyCVR有不同版本，基础版可能只支持视频接入，告警事件模块需要完整版或者单独授权。我遇到过有人在试用版上折腾半天，最后发现广告模块根本没开放。所以第一步，先到平台后台看看“事件管理”或“告警管理”菜单是否存在，能不能正常打开。如果连菜单都没有，先去确认授权和版本。

另外GB28181接入是平台的基本能力，但不同版本支持的并发通道数不一样，在告警量大、设备多的场景下，性能和设备数量有关，这个在项目落地前就得评估清楚。

2.2 网络端口与防火墙准备

GB28181默认走UDP 506