GB28181协议接入
简介
GB28181（GB/T 28181）是中国国标《公共安全视频监控联网系统信息传输、交换、控制技术要求》定义的标准协议，用于视频监控设备的联网注册与信令控制。
联犀平台以 GB28181 国标视频接入（协议代码 gb28181）的方式对接各类符合国标的摄像头、NVR（网络硬盘录像机）等视频前端设备：
- 设备主动注册：平台内置 SIP 服务，作为国标注册中心等待设备/NVR 主动发起 SIP 注册，无需在设备端配置平台侧 IP 之外的信息；
- 目录上报：注册成功后设备向平台上报通道（摄像机）目录，平台可查询设备状态与通道列表；
- 统一接入：设备在平台「设备接入」页绑定通道后，即可通过统一的 WS-FLV / HTTP-FLV 实时预览查看画面，并支持 PTZ 云台控制（方向/变倍/预置位）与 历史回放（录像日历 → 录像列表 → 播放）。
核心能力：视频设备无需开发联调，只要支持国标 SIP 注册即可快速接入平台，一个产品对应一类国标设备，设备维度绑定具体通道后即可预览、控制与回放。
应用场景
- 存量视频监控利旧接入：现有符合 GB28181 国标的摄像头、NVR、视频平台直接注册接入，无需改造设备
- 设备主动注册：设备/NVR 配置平台 SIP 服务器参数后自动注册上线，支持大数量设备接入
- 统一实时预览：绑定通道后统一使用 WS-FLV / HTTP-FLV 实时预览，浏览器直接观看，无需安装插件
- 云台控制：支持八方向控制、变倍缩放、云台速度调节与预置位设置/调用/删除
- 历史回放：支持按录像日历查询有录像的日期，选择录像文件在线播放
前置条件
- 平台音视频服务已启用：
avsvr（音视频服务）随 allinone 部署，且部署级开关已开启完整音视频功能（SIP 服务、媒体服务器） - 设备可达：GB28181 设备的 SIP 注册地址可访问平台 SIP 服务（UDP
5060，以平台实际配置为准） - 产品已创建：创建产品时主协议选择「音视频」分组下的
GB28181 国标视频接入
产品配置
1. 创建产品
创建产品时，主协议下拉选择「音视频」分组下的 GB28181 国标视频接入（传输协议为音视频媒体）：
创建成功后，产品详情页会展示产品信息（产品 ID 等），并出现「设备接入」Tab：
2. 产品「设备接入」：查看 SIP 接入参数
进入产品详情「设备接入」Tab，平台按协议自动渲染 GB28181 接入说明页——配置页以内嵌 iframe 形式展示在 Tab 内（如下图所示），内容包括平台侧 SIP 服务器参数（只读，可一键复制）与设备侧注册指引：
SIP 服务器参数：
| 字段 | 说明 |
|---|---|
服务器 IP（serverIP） | 平台 SIP 服务器地址，设备/NVR 注册时填写的服务器地址 |
SIP 端口（port） | SIP 信令端口，默认 5060（UDP） |
国标域（domain） | 国标域编码，如 3402000000 |
SIP ID（sipID） | 平台 SIP 服务器 ID，如 34020000002000000001 |
接入密码（password） | 注册接入密码，为空时表示不校验密码 |
收流模式（streamMode） | 媒体流接收模式：UDP / TCP 被动 / TCP 主动，需与设备端传输协议一致 |
注册鉴权（registerAuth） | 注册模式：开放注册（任意设备可注册） / 预登记（仅已建档设备可注册） |
设备侧注册指引（以配置页实际展示为准）：
- 在摄像机/NVR 的 GB28181 配置中填写：服务器地址、端口、国标域、设备 SIP ID（唯一）、注册有效期等；
- 接入密码与服务器 SIP ID 一致时，设备密码填入平台 SIP ID（部分设备需勾选「密码校验」后填写）；
- 收流模式需与设备端传输协议保持一致；注册鉴权为「预登记」时，需先在平台登记设备 SIP ID 才能注册成功；
- 注册成功后，在「音视频 - 设备管理」中可看到设备上线，再到设备接入页绑定通道即可预览。
产品「设备接入」页仅展示平台侧接入参数与指引，实际绑定操作在设备详情的「设备接入」页完成。
设备接入
1. 创建设备
在产品下创建设备，进入设备详情「设备接入」Tab，平台按产品协议渲染 GB28181 设备接入配置页：
2. 绑定已有音视频设备通道
配置页会自动读取当前设备绑定状态；未绑定时，页面提供「绑定已有音视频设备」入口：
- 选择音视频设备：从「音视频 - 设备管理」中已注册上线的 GB28181 设备列表中选择（按当前协议过滤）；
- 选择通道：选定设备后加载其通道（摄像机）列表，选择要绑定到本 IoT 设备的通道；
- 确认绑定：点击「确认绑定」，绑定关系即保存（写入设备协议配置）。
绑定关系为一对一：一个音视频设备通道绑定到一个 IoT 设备。解绑后可在设备接入页重新绑定其他设备/通道。
3. 绑定后：实时预览 / PTZ / 回放
绑定成功后，设备接入页展示绑定信息（音视频设备、通道、传输协议、通道 ID），并提供实时预览、云台控制、历史回放三类能力：
绑定信息下方按「实时预览」「历史回放」两个页签组织：「实时预览」页签为左右分栏布局——左侧为视频画面，右侧为「云台控制（PTZ）」面板；「历史回放」为独立页签（录像日历 → 录像列表 → 播放）。
在设备详情「设备接入」Tab 内同样以内嵌配置页渲染，点击「开始预览」后实时画面在左侧视频区播放：
实时预览（WS-FLV / HTTP-FLV）
点击「开始预览」通过 WS-FLV / HTTP-FLV 播放设备实时画面，支持全屏、暂停等浏览器原生控制，可随时停止预览。默认优先使用 WS-FLV（低延迟），环境不支持 WebSocket 时自动回退到 HTTP-FLV；浏览器不支持 MSE 或播放器组件不可用时，自动降级为 HLS 兜底播放。
播放协议说明：
| 对比项 | WS-FLV / HTTP-FLV（默认） | WebRTC（可选） |
|---|---|---|
| 延迟 | 约 1~3 秒 | 约 200~500 毫秒 |
| 浏览器兼容性 | 高（需 MSE，主流浏览器均支持） | 中（需 WebRTC 支持，部分企业环境受限） |
| 网络要求 | HTTP / WebSocket 端口，内网通常可通 | 需放行 UDP 媒体端口及 ICE 候选端口 |
| 适用场景 | 监控预览、录像回放 | 对延迟极敏感的实时控制 |
切换方式：默认由播放器自动选择 WS-FLV；若播放器或页面提供手动切换入口，可按需选择 WS-FLV / HTTP-FLV / WebRTC。
云台控制（PTZ）
GB28181 设备额外支持云台控制：
- 八方向控制：上/下/左/右及四个斜方向，按下即转动、按「停止」即停（方向按钮对应
continuous动作） - 变倍缩放：「放大」「缩小」按钮长按触发连续变倍，松开停止
- 云台速度：滑动条调节 0~1 云台转动速度（默认
0.5） - 预置位：输入预置位编号（与可选名称），支持设置、调用、删除
历史回放
设备绑定后切换到「历史回放」页签，按以下路径回放历史录像：
- 选择月份：选择要查询的月份；
- 查询日历：点击「查询日历」获取该月有录像的日期列表；
- 选择日期：点击有录像的日期，加载该日录像列表（开始时间/结束时间/时长/类型）；
- 播放：点击对应录像的播放操作，在回放播放器中在线播放。
录像需配置后才会产生：平台侧录像需先为通道配置录像计划（或开启录制）后才会录制；未配置录像计划的通道不会自动录像，日历中也不会出现有录像的日期。
技术方案
接入架构
GB28181 设备/NVR ──SIP 注册──> avsvr（allinone 内嵌） ──媒体流──> ZLMediaKit 流媒体
(摄像头/国标NVR) UDP 5060 - SIP 注册中心/目录管理 - 收流/转封装/RTP
│ │
│ 设备/通道状态、播放信令、PTZ/回放
└────────────┬───────────────┘
▼
WS-FLV / HTTP-FLV 实时预览（浏览器）与普通协议网关的区别：GB28181 / ONVIF / RTSP-RTMP 三个音视频协议不新建独立协议容器，而是内嵌在 avsvr（音视频服务，随 allinone 镜像发布）中实现：
- 协议注册：
avsvr启动时幂等注册三条dm_protocol_info（Type=media），产品创建时的「音视频」协议分组即来自此处； - 配置页自托管：
avsvr内置协议配置页静态服务（随机端口，心跳上报web_port），平台「设备接入」Tab 以 iframe 渲染，经 apisvr 反代访问； - SIP 服务：GB28181 设备通过 UDP
5060端口向平台 SIP 服务注册，注册成功后可上报通道目录； - 媒体流：设备媒体流由 ZLMediaKit 流媒体服务器接收（RTP/UDP、TCP 收流），统一转封装后供 WS-FLV / HTTP-FLV / HLS / WebRTC 等协议播放；
- FLV 播放：实时预览与历史回放统一使用 ZLMediaKit 的 WS-FLV / HTTP-FLV 能力（HTTP/WebSocket 请求经平台反向代理转发，媒体流由 ZLMediaKit 直接输出）；如需更低延迟，可在支持的环境中切换 WebRTC（信令经反向代理转发，媒体走 WebRTC 候选端口）。
绑定关系存储
- 音视频设备表记录绑定到哪个 IoT 设备（产品 ID + 设备名称），未绑定则为空；
- IoT 设备侧将所选音视频设备与通道存入协议配置（
avDeviceID/avChannelID）； - RTSP/RTMP「填流地址自动接入」建档的音视频设备以
iot_前缀标记，解绑且无其他引用时自动回收。
数据流
- 上行（注册/状态）：设备 SIP 注册 → 平台校验/登记 → 设备上线、通道目录上报
- 上行（媒体）：设备推流（RTP）→ ZLMediaKit 收流转封装 → WS-FLV / HTTP-FLV / HLS / WebRTC 拉流播放
- 下行（控制）：平台下发 PTZ/预置位/回放指令 → avsvr 信令转发 → 设备执行
部署说明
GB28181 音视频能力由 avsvr（音视频服务）提供，内嵌于 allinone 镜像（docker.unitedrhino.com/saas/allinone），无独立协议容器；流媒体由 ZLMediaKit 容器（如 saas-zlmediakit）提供。
SIP 注册与流媒体服务的端口因部署环境而异，实际以部署环境配置为准；公网环境需确保 SIP 注册端口与 WebRTC 媒体端口在安全组放行。
注意事项
- 收流模式一致性：平台配置的收流模式（UDP/TCP）必须与设备端传输协议一致，否则注册成功但无法收流
- 注册鉴权模式：预登记模式下需先在平台登记设备 SIP ID 才能注册成功；开放注册模式下任意设备可注册，生产环境建议按需开启鉴权
- 接入密码：接入密码与平台 SIP ID 一致时，设备密码直接填平台 SIP ID；部分设备需勾选「密码校验」后才填写
- FLV 播放要求：实时预览基于 HTTP / WebSocket 传输 FLV 流，浏览器需支持 MSE；企业内网通常可直接访问，无需放行 WebRTC 的 UDP 媒体端口；若需要更低延迟，可在支持的环境中切换 WebRTC，但需确保浏览器能直连流媒体服务器的 WebRTC 信令与媒体端口（TCP/UDP）
- 预览效果：预览画面的实际渲染效果与设备、网络环境相关（FLV 预览需能访问流媒体服务器的 HTTP/WebSocket 入口；WebRTC 预览需直连媒体服务器的 WebRTC 端口），以实际部署环境为准
- 设备与通道：一个通道（摄像机）只能绑定到一个 IoT 设备；绑定前确认设备已在「音视频 - 设备管理」中上线
- 录像来源：历史回放依赖录像文件（设备录像或平台侧录制）；平台侧录制需配置录像计划后才会产生录像，未配置不会自动录制，无录像的日期日历中不会显示
参考链接
更新日志
2026/8/31 14:31
查看所有更新日志
2fc1c-于eb33f-于70dbb-于b72ca-于