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.1SDP_IP:写进 SDP 的 IP,NAT 后面同样填公网 IPSIP_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),仅供参考