GB28181 视频平台快速上手指南：Docker 一键部署-平芜编程栈

GB28181 视频平台快速上手指南：Docker 一键部署

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

wvp-GB28181-pro 是一个基于 GB28181-2016 国标协议实现的网络视频平台，自带管理页面，支持海康、大华、宇视等品牌 IPC、NVR 接入，支持国标级联，还能把普通直播流共享到国标平台。需要快速搭建国标设备接入平台的话，Docker 一条命令就能跑起来。

快速上手：把它跑起来

环境要求只有一条：一台装好 Docker 的机器。它会把 redis、mysql、ZLMediaKit（媒体服务）、WVP 核心服务、nginx 五个容器一起拉起来：

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

关键参数在 docker 目录的 .env 里，SIP 部分和流地址 IP 是最需要改的：

SIP_Domain=3502000000 # 10位域，取国标编码前10位 SIP_Id=35020000002000000001 # 20位平台编号 SIP_Password=wvp_sip_password # 设备注册密码 SIP_Port=8160 Stream_IP=127.0.0.1 # 改成对外IP，设备按它发流

跑起来之后，浏览器访问http://服务器IP:8080，默认账号密码都是 admin。WVP 日志里看到 ZLM 已连接的提示，说明平台就绪，可以开始接设备了。

启动后打开的管理页面，登录后进入设备管理即可

它能帮你做什么

📹 摄像头上线，网页直接点播

在设备侧填好平台的 SIP_ID、域和密码，设备自动注册上来。设备列表页能看到在线状态，通道自动同步。点通道即可点播，浏览器基于 WebRTC/FLV 播放，不用装插件，页面里可以直接操作云台方向、变焦。

设备列表、在线状态、通道同步都在这一个页面

🔗 向上级平台级联

你可以把级联理解成"本平台装成一台设备，注册到上级平台去"：页面上点"添加"，填上级平台的 SIP 参数，再编辑设备开启目录订阅，给目录添加通道，上级平台就能按普通点播流程看本平台的流。

"添加"弹窗里填上级平台的 ID、域和密码

🗂 用行政区划、分组整理通道

设备一多，先建省-市-县行政区划树或业务分组，把通道挂到节点下，后面查设备、做权限、批量操作都靠这棵树。

左侧行政区划树用来组织设备和通道

📼 录像与云媒

点播可以录制（配置项 record-sip 控制），录像之后在云媒录像页面做检索、播放、下载，不用再去设备端翻录像。

云媒录像页面，支持检索、在线播放、下载

另外，手里没有国标的流也不怕：普通摄像机 RTSP 流、直播流可以通过流代理转成国标流共享上去，不需要把摄像机换成国标设备。

核心概念 3 分钟讲明白

SIP 信令：把它理解成"打电话"。点播放时 WVP 先给设备发一个 Invite（拨号），设备回话里的 SDP 就是告诉它"视频流发到哪个 IP 和端口"。点播失败绝大多数发生在这一步——要么电话没接通，要么流送不到。

国标编号：SIP_Id 是 20 位平台编号，SIP_Domain 是它的前 10 位；设备侧要填的"平台地址"是服务器 IP 加 SIP 端口，别漏。

级联：本平台当作一台设备注册到上级，上级用正常点播流程看你的流，内部实现互不感知。

多端口/单端口 RTP：媒体流的收法。多端口用端口区分每一路流（port-range 配一个范围，如 30000-35000），兼容性更好，点播超时的话建议切到多端口试。

从单机到多节点

单个 ZLM 节点能扛的并发路数受带宽和性能限制。WVP 支持一个 WVP 挂多个 ZLM：默认节点写在 WVP 配置文件里，额外的节点在页面"添加节点"（填 ZLM 的 IP、http 端口、SECRET，docker 部署时注意容器端口与宿主机不一致的情况）。WVP 把节点负载记在 Redis 里，新请求分给负载最低的节点。

两个容易踩的点：WVP 和 ZLM 之间是高频率通信，别把它们放进两个网络（比如一个内网一个公网）；ZLM 用 docker 部署时端口映射要与容器内保持一致。

踩坑提示 / 常见问题

1. 设备注册不上来现象：设备在页面一直离线。原因：信息填错（密码、IP、端口）或网络不通。处理：核对两边 SIP 参数；海康设备需要勾选鉴权后才允许输密码。

2. 点播回 400 错误现象：点播放很快报错。原因：设备认为 WVP 发的消息不完整或不规范。处理：抓包分析是否缺失内容；部分实现不规范的设备兼容困难，可找社区协助对接。

3. 点播超时 / 收流超时现象：等了很久没有流。原因：Invite 的 SDP 里带了错的 IP（配成 127.0.0.1，或公网部署却给了内网 IP）；ZLM 的 hook 连不回 WVP；开了 SSRC 校验但流不规范被丢弃。处理：先关 SSRC 校验，确认 ZLM 的 hook 能连到 WVP，再查 ZLM 日志是否有流注册。

4. 设备返回 500现象：点播流程中设备回 500。原因：一般是设备自身内部问题。处理：联系设备厂商；如果有别的平台能对接该设备，可把两边的抓包发出来对比。