GB28181 视频平台 5 分钟部署指南
2026/8/24 15:54:57 网站建设 项目流程

GB28181 视频平台 5 分钟部署指南

【免费下载链接】wvp-GB28181-pro基于GB28181-2016、部标808、部标1078标准实现的开箱即用的网络视频平台。自带管理页面,支持NAT穿透,支持海康、大华、宇视等品牌的IPC、NVR接入。支持国标级联,支持将普通摄像机/直播流/直播推流转国标共享到国标平台。项目地址: https://gitcode.com/GitHub_Trending/wv/wvp-GB28181-pro

200 路海康、大华的摄像头,一半锁在海康私有客户端里,一半躺在一台台 NVR 上,运维每天要登好几个后台,账号密码各一套。其实只要让设备走 GB28181 协议(GB/T 28181,IP 视频监控联网的国标信令标准),一个平台就能把它们全部管起来。wvp-GB28181-pro 就是干这件事的:一个开箱即用的 GB28181-2016 视频平台,自带管理页面,不用自己写 SIP 服务器。

一句话定位:wvp-GB28181-pro 是基于 GB28181-2016、部标 808/1078 的网络视频平台,支持海康、大华、宇视等品牌 IPC/NVR 的接入、点播、回放与国标级联,还能把普通 RTSP/RTMP 直播流转成国标流共享出去。仓库地址见下方 clone 命令。

快速部署步骤:Docker 三条命令跑通

拉代码,进 docker 目录:

git clone https://gitcode.com/GitHub_Trending/wv/wvp-GB28181-pro cd wvp-GB28181-pro/docker

所有部署相关配置都集中在docker/.env,需要动的就这几项:

  • Stream_IP:浏览器和播放端取流用的 IP,填服务器真实出口 IP,别留 127.0.0.1
  • SDP_IP:写进 SDP 的 IP,NAT 后面同样填公网 IP
  • SIP_Id/SIP_Domain:平台 20 位国标编号及其前 10 位
  • SIP_Port/SIP_Password:SIP 信令端口(默认 8160)和设备注册密码
  • WebHttp:管理页面端口,默认 8080

启动全部服务,包含 MySQL、Redis、ZLMediaKit 媒体服务、WVP 本体和 Nginx:

docker compose up -d docker compose ps # 确认 5 个容器都是 Up

浏览器打开http://服务器IP:8080,默认账号密码均为admin,进入「国标设备」页添加设备即可。更多端口说明和独立部署方式见官方部署文档与docker 部署说明。

多品牌摄像头接入:改一次配置就上线

场景:设备来自不同厂商,部分在 NAT 后面,你希望它们统一注册到平台。

它做了什么:WVP 本身就是一个 GB28181 SIP 服务器。摄像头侧只填平台编号、域和注册密码,注册成功后平台自动同步通道目录,不需要逐台手动录入。NAT 后的设备把 SDP_IP 指到公网地址,媒体流就能穿过来,这就是它支持 NAT 穿透的方式。

你得到什么:设备列表里有在线状态、最近心跳、最近注册时间,点开设备还能一键查看 SIP 认证信息(编号、域、密码、IP),注册卡在哪一步不用翻日志猜。

国标级联配置要点:把通道挂给上级平台

场景:本级要向上级平台共享一部分摄像头,或者向下级拉流。

它做了什么:在「国标级联」页添加上级平台,填对方平台编号、SIP 地址和认证口令。WVP 会以下级平台身份主动向对方发起注册,认证通过后,你在页面上勾选要共享的通道即可。上级点播时,媒体流由媒体服务转发,告警也能按配置上送。

你得到什么:共享靠勾选完成,摄像头侧零改动,上级平台看到这些通道和本地设备没有区别。

平台还有「拉流代理」,可以把任意外部 RTSP/RTMP 直播流封装成一路国标设备推给国标平台,第三方直播源的接入不用另写协议转换。

行政区划与业务分组:把几百路通道管起来

场景:通道过了几百路,平铺的列表没人看得过来。

它做了什么:通道支持按省-市-县行政区划树组织,也支持按业务维度自定义分组;通道可以批量在两者之间迁移,迁移后归属关系自动跟随。

你得到什么:向上级共享资源时可以按行政区划批量圈选,前端预览直接按树点选,API 侧也能按区域拉取通道列表。

分场景配置建议:50 路到 500 路怎么配

场景规模配置要点
测试 / 试点≤50 路单机 Docker 即可,媒体端口用默认值,RTP 保持单端口模式
中小园区50–500 路开启多端口模式:media.rtp.enable: true,端口范围调大,Stream_IP改成真实出口 IP
多节点500 路以上加 ZLMediaKit 媒体节点,在「媒体节点」页注册多个服务,点播请求由 WVP 分发

相关配置项在 WVP 配置模板 的media.rtp段里,媒体服务自身参数在docker/media/config.ini

常见坑与解决思路

  • 设备注册失败,但能 ping 通服务器→ 九成是 UDP 端口没放通(SIP 端口 + 万段 RTP 端口),或者Stream_IP/SDP_IP还写着 127.0.0.1。先查防火墙,再查 IP。
  • 注册成功但画面出不来→ 摄像头回写不到平台的 RTP 端口,典型 NAT 场景。把SDP_IP设为公网 IP;媒体服务用 Docker 跑时,用 host 网络模式或端口同值映射(比如 10003 对 10003),错开映射会导致回包地址不对。
  • 并发点播偶发超时→ 单端口模式下所有流共用一个 RTP 端口,流多时容易撞。切到多端口模式,每路流从端口范围里单独分配,兼容性明显更好。

写在最后

wvp-GB28181-pro 把「多品牌设备散落多套系统」收敛成「一个国标编号、一个管理页面」,SIP 信令细节可以直接读 GB28181 核心模块源码。建议的第一步:找台测试机把 Docker 环境拉起来,接 5 路摄像头,把注册、点播、级联完整跑一遍,一天之内足够验证这套平台适不适合你的场景。

【免费下载链接】wvp-GB28181-pro基于GB28181-2016、部标808、部标1078标准实现的开箱即用的网络视频平台。自带管理页面,支持NAT穿透,支持海康、大华、宇视等品牌的IPC、NVR接入。支持国标级联,支持将普通摄像机/直播流/直播推流转国标共享到国标平台。项目地址: https://gitcode.com/GitHub_Trending/wv/wvp-GB28181-pro

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询