联犀

GB28181协议接入

约 3345 字大约 11 分钟

设备接入第三方协议GB28181国标视频

2026-08-21

简介

GB28181（GB/T 28181）是中国国标《公共安全视频监控联网系统信息传输、交换、控制技术要求》定义的标准协议，用于视频监控设备的联网注册与信令控制。

联犀平台以 GB28181 国标视频接入（协议代码 gb28181）的方式对接各类符合国标的摄像头、NVR（网络硬盘录像机）等视频前端设备：

  • 设备主动注册：平台内置 SIP 服务，作为国标注册中心等待设备/NVR 主动发起 SIP 注册，无需在设备端配置平台侧 IP 之外的信息；
  • 目录上报：注册成功后设备向平台上报通道（摄像机）目录，平台可查询设备状态与通道列表；
  • 统一接入：设备在平台「设备接入」页绑定通道后，即可通过统一的 WebRTC 实时预览查看画面，并支持 PTZ 云台控制（方向/变倍/预置位）与 历史回放（录像日历 → 录像列表 → 播放）。

核心能力：视频设备无需开发联调，只要支持国标 SIP 注册即可快速接入平台，一个产品对应一类国标设备，设备维度绑定具体通道后即可预览、控制与回放。

应用场景

  • 存量视频监控利旧接入：现有符合 GB28181 国标的摄像头、NVR、视频平台直接注册接入，无需改造设备
  • 设备主动注册：设备/NVR 配置平台 SIP 服务器参数后自动注册上线，支持大数量设备接入
  • 统一实时预览：绑定通道后统一使用 WebRTC 低延迟实时预览，浏览器直接观看，无需安装插件
  • 云台控制：支持八方向控制、变倍缩放、云台速度调节与预置位设置/调用/删除
  • 历史回放：支持按录像日历查询有录像的日期，选择录像文件在线播放

前置条件

  1. 平台音视频服务已启用：avsvr（音视频服务）随 allinone 部署，且部署级开关已开启完整音视频功能（SIP 服务、媒体服务器）
  2. 设备可达：GB28181 设备的 SIP 注册地址可访问平台 SIP 服务（UDP 5060，以平台实际配置为准）
  3. 产品已创建：创建产品时主协议选择「音视频」分组下的 GB28181 国标视频接入

产品配置

1. 创建产品

创建产品时，主协议下拉选择「音视频」分组下的 GB28181 国标视频接入（传输协议为音视频媒体）：

创建产品选择 GB28181 协议

创建成功后，产品详情页会展示产品信息（产品 ID 等），并出现「设备接入」Tab：

创建 GB28181 产品

2. 产品「设备接入」：查看 SIP 接入参数

进入产品详情「设备接入」Tab，平台按协议自动渲染 GB28181 接入说明页——配置页以内嵌 iframe 形式展示在 Tab 内（如下图所示），内容包括平台侧 SIP 服务器参数（只读，可一键复制）与设备侧注册指引：

产品详情页设备接入 Tab（内嵌配置页）

SIP 服务器参数：

字段说明
服务器 IP（serverIP）平台 SIP 服务器地址，设备/NVR 注册时填写的服务器地址
SIP 端口（port）SIP 信令端口，默认 5060（UDP）
国标域（domain）国标域编码，如 3402000000
SIP ID（sipID）平台 SIP 服务器 ID，如 34020000002000000001
接入密码（password）注册接入密码，为空时表示不校验密码
收流模式（streamMode）媒体流接收模式：UDP / TCP 被动 / TCP 主动，需与设备端传输协议一致
注册鉴权（registerAuth）注册模式：开放注册（任意设备可注册） / 预登记（仅已建档设备可注册）

设备侧注册指引（以配置页实际展示为准）：

  1. 在摄像机/NVR 的 GB28181 配置中填写：服务器地址、端口、国标域、设备 SIP ID（唯一）、注册有效期等；
  2. 接入密码与服务器 SIP ID 一致时，设备密码填入平台 SIP ID（部分设备需勾选「密码校验」后填写）；
  3. 收流模式需与设备端传输协议保持一致；注册鉴权为「预登记」时，需先在平台登记设备 SIP ID 才能注册成功；
  4. 注册成功后，在「音视频 - 设备管理」中可看到设备上线，再到设备接入页绑定通道即可预览。

产品「设备接入」页仅展示平台侧接入参数与指引，实际绑定操作在设备详情的「设备接入」页完成。

设备接入

1. 创建设备

在产品下创建设备，进入设备详情「设备接入」Tab，平台按产品协议渲染 GB28181 设备接入配置页：

设备详情设备接入页

2. 绑定已有音视频设备通道

配置页会自动读取当前设备绑定状态；未绑定时，页面提供「绑定已有音视频设备」入口：

  1. 选择音视频设备：从「音视频 - 设备管理」中已注册上线的 GB28181 设备列表中选择（按当前协议过滤）；
  2. 选择通道：选定设备后加载其通道（摄像机）列表，选择要绑定到本 IoT 设备的通道；
  3. 确认绑定：点击「确认绑定」，绑定关系即保存（写入设备协议配置）。

绑定关系为一对一：一个音视频设备通道绑定到一个 IoT 设备。解绑后可在设备接入页重新绑定其他设备/通道。

3. 绑定后：实时预览 / PTZ / 回放

绑定成功后，设备接入页展示绑定信息（音视频设备、通道、传输协议、通道 ID），并提供实时预览、云台控制、历史回放三类能力：

绑定后设备接入配置页

在设备详情「设备接入」Tab 内同样以内嵌配置页渲染，页面顶部为实时预览区域：

设备详情内实时预览

实时预览（WebRTC）

点击「开始预览」通过 WebRTC 低延迟播放设备实时画面，支持全屏、暂停等浏览器原生控制，可随时停止预览。

云台控制（PTZ）

GB28181 设备额外支持云台控制：

  • 八方向控制：上/下/左/右及四个斜方向，按下即转动、按「停止」即停（方向按钮对应 continuous 动作）
  • 变倍缩放：「放大」「缩小」按钮长按触发连续变倍，松开停止
  • 云台速度：滑动条调节 0~1 云台转动速度（默认 0.5）
  • 预置位：输入预置位编号（与可选名称），支持设置、调用、删除

历史回放

设备绑定后按以下路径回放历史录像：

  1. 选择月份：选择要查询的月份；
  2. 查询日历：点击「查询日历」获取该月有录像的日期列表；
  3. 选择日期：点击有录像的日期，加载该日录像列表（开始时间/结束时间/时长/类型）；
  4. 播放：点击对应录像的播放操作，在回放播放器中在线播放。

数据验证

真实链路验证结论

平台接入 gb28181 协议后，验证流程与结果如下：

  1. fake NVR 注册：使用 GB28181 模拟设备（fakeNVR）配置平台 SIP 参数，向平台 SIP 服务注册
  2. 设备上线：注册成功后在「音视频 - 设备管理」中设备显示在线
  3. 绑定通道：在 IoT 设备「设备接入」页绑定该设备与通道，绑定状态保存成功，刷新后绑定信息完整回显
  4. 实时预览：点击「开始预览」信令链路完整——平台下发 INVITE、设备应答并协商推流，页面获取到 WebRTC 等完整播放地址
  5. PTZ 与回放：绑定后页面展示云台控制（方向/变倍/预置位）与历史回放（录像日历 → 录像列表 → 播放）操作区，对应接口就绪
验证项状态详情
SIP 注册✅ 成功设备向平台 SIP 服务注册上线，重复注册/续订不影响既有绑定
绑定通道✅ 成功产品/设备接入页正常渲染，绑定关系保存并完整回显
实时预览✅ 信令链路通INVITE/ACK/推流协商全链路通过，返回完整播放地址
PTZ 云台控制✅ 就绪绑定后展示方向/变倍/预置位操作区，指令接口就绪
历史回放✅ 就绪录像日历/列表/播放操作区渲染正常，接口就绪

预览画面的实际渲染效果与设备、网络环境相关（浏览器需直连媒体服务器的 WebRTC 端口），以实际部署环境为准。

技术方案

接入架构

GB28181 设备/NVR ──SIP 注册──> avsvr（allinone 内嵌） ──媒体流──> ZLMediaKit 流媒体
 (摄像头/国标NVR)    UDP 5060      - SIP 注册中心/目录管理       - 收流/转封装/RTP
                                        │                            │
                                        │ 设备/通道状态、播放信令、PTZ/回放
                                        └────────────┬───────────────┘
                                                     ▼
                                          WebRTC 实时预览（浏览器）

与普通协议网关的区别：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 收流），统一转封装后供 WebRTC/HLS 等协议播放；
  • WebRTC 播放：实时预览与历史回放统一使用 ZLMediaKit 的 WebRTC 能力（信令走 80/8088 反代，媒体走 8000 及 30000-30050 候选端口）。

绑定关系存储

  • 音视频设备表记录绑定到哪个 IoT 设备（产品 ID + 设备名称），未绑定则为空；
  • IoT 设备侧将所选音视频设备与通道存入协议配置（avDeviceID / avChannelID）；
  • RTSP/RTMP「填流地址自动接入」建档的音视频设备以 iot_ 前缀标记，解绑且无其他引用时自动回收。

数据流

  • 上行（注册/状态）：设备 SIP 注册 → 平台校验/登记 → 设备上线、通道目录上报
  • 上行（媒体）：设备推流（RTP）→ ZLMediaKit 收流转封装 → WebRTC/HLS 拉流播放
  • 下行（控制）：平台下发 PTZ/预置位/回放指令 → avsvr 信令转发 → 设备执行

部署说明

GB28181 音视频能力由 avsvr（音视频服务）提供，内嵌于 allinone 镜像（docker.unitedrhino.com/saas/allinone），无独立协议容器；流媒体由 ZLMediaKit 容器（如 saas-zlmediakit）提供。

115 测试环境端口分工参考：

端口服务说明
5060SIP 服务GB28181 设备 SIP 注册（UDP，部署时映射为对外端口如 15061）
8088ZLMediaKit HTTP流媒体 HTTP 入口（HLS/FLV/HTTP API，内部经反代访问）
8000ZLMediaKit WebRTCWebRTC 信令与媒体端口（TCP/UDP）
30000-30050ZLMediaKit RTPWebRTC ICE / RTP 候选端口范围（TCP/UDP）
8554 / 1936ZLMediaKit RTSP / RTMP直接拉流/推流端口（可选）
10000ZLMediaKit RTPRTP 接收端口（可选）

部署参数因环境而异，实际以部署环境的端口分工为准；公网环境需确保 SIP 注册与 WebRTC 媒体端口在安全组放行。

注意事项

  • 收流模式一致性：平台配置的收流模式（UDP/TCP）必须与设备端传输协议一致，否则注册成功但无法收流
  • 注册鉴权模式：预登记模式下需先在平台登记设备 SIP ID 才能注册成功；开放注册模式下任意设备可注册，生产环境建议按需开启鉴权
  • 接入密码：接入密码与平台 SIP ID 一致时，设备密码直接填平台 SIP ID；部分设备需勾选「密码校验」后才填写
  • WebRTC 播放要求：浏览器需能直连流媒体服务器的 8000 与 30000-30050 端口（TCP/UDP）；企业网络阻断 UDP 时可能出现 ICE 连接超时，可切换 HLS 播放
  • 设备与通道：一个通道（摄像机）只能绑定到一个 IoT 设备；绑定前确认设备已在「音视频 - 设备管理」中上线
  • 录像来源：历史回放依赖录像文件（设备录像或平台侧录制），无录像的日期日历中不会显示

参考链接

更新日志

2026/8/22 01:02
查看所有更新日志
  • bdb19-docs(use): 新增 GB28181/ONVIF/RTSP-RTMP 音视频协议接入文档于

联犀 AIoT 平台持续进化中 🚀

📢 查看平台更新说明

微信扫码关注公众号，掌握最新进展；回复“加群”进群