如何用一个界面管好四种品牌的摄像头:免费GB28181开源监控平台五步接入指南
【免费下载链接】wvp-GB28181-pro基于GB28181-2016、部标808、部标1078标准实现的开箱即用的网络视频平台。自带管理页面,支持NAT穿透,支持海康、大华、宇视等品牌的IPC、NVR接入。支持国标级联,支持将普通摄像机/直播流/直播推流转国标共享到国标平台。项目地址: https://gitcode.com/GitHub_Trending/wv/wvp-GB28181-pro
wvp-GB28181-pro 是一个免费的 GB28181 开源视频监控平台,基于 GB/T 28181-2016 国标协议实现,自带 Web 管理页面,负责设备信令与录像管理,流媒体部分由 ZLMediaKit 承担。它把海康、大华、宇视等不同品牌的摄像头统一接入同一个系统,也支持把普通 RTSP 流"伪装"成国标通道共享给上级平台。
卡壳的从来不是摄像头,是它们说的不是一种语言
先讲一个我碰到的场景。一个物流园区里混着四家厂商的设备:大门口是海康的球机,仓库四周是大华的枪机,宿舍区换了宇视,另外角落里还有两台早年采购、只能输出 RTSP 流的"无牌"老枪。园区管理员手机里装着三个品牌各自的 App,客户现场要看某一路画面,他得先花十秒钟想"这路摄像头归哪个 App 管"。更麻烦的是上级主管部门要求把 30 路视频汇聚到区县平台,四家品牌的私有协议没法对接,最后只能人工截图汇报。
这类问题的根源其实很清晰:每个品牌一套私有协议,等于每装一个品牌就多装一套"翻译系统"。而 GB28181 国标协议相当于摄像头之间的普通话——只要设备支持国标,就能被同一个平台统一注册、统一预览、统一录像。wvp-GB28181-pro 扮演的就是普通话调度台的角色:设备把平台的 SIP 域、端口、密码填进自己的"上级平台"配置里,注册成功后,预览、云台、录像、回放全部在一个 Web 页面里完成,不再需要按品牌切换工具。
花两分钟判断:这套方案适不适合你
上手之前先泼点冷水,把边界说清楚,比什么都值。
- ✅适用人群:手里有支持 GB28181 的 IPC/NVR(海康、大华、宇视主流型号都带这个协议),或者只有 RTSP/RTMP 流地址需要统一分发的团队;想给门店、园区做低成本统一监控的集成商。
- ✅成本:代码为 MIT 协议,无授权费;硬件成本自备,Docker 部署建议 4 核 CPU、8GB 内存起步,硬盘按录像保留天数预留。
- ⚠️部署门槛:需要会 Docker 和基本网络知识(开端口、配 IP)。不会命令行也不是死局,但排查问题时会吃力。
- ⚠️边界:开源版本走的是国标协议 + RTSP/RTMP 拉流/推流路线;海康 ISUP、大华 SDK、ONVIF 这类私有协议对接属于项目的闭源内容,开源版不包含。
- ⚠️性能:能接多少路取决于服务器性能,官方宣称局域网压测可接入数万设备,但生产环境请以自己的硬件和网络带宽为准,别拿宣传数字当 SLA。
如果你的摄像头全是"纯 SDK 品牌、既没国标也没 RTSP 输出",这套方案帮不上忙,先去看设备手册。
五步看到第一路画面:免费开源视频监控方案的最小部署路径
整个部署只需要一条命令拉起服务,真正花时间的地方在"把摄像头接进来"。
第 1 步:准备机器。一台 Linux 服务器即可,4 核 8G 起步,测试阶段建议关闭防火墙,排除网络变量。
第 2 步:克隆仓库并配置环境变量。
git clone https://gitcode.com/GitHub_Trending/wv/wvp-GB28181-pro cd wvp-GB28181-pro/docker按 docker 目录说明,用.env文件配置环境变量后各服务会自动联动,其中必填的是Stream_IP(设备回流的 IP)和SDP_IP(信令里下发的 IP,公网部署填公网 IP),以及SIP_Domain、SIP_Id、SIP_Password三个国标参数。
第 3 步:一条命令拉起全套服务。MySQL、Redis、ZLMediaKit 流媒体、wvp 本体、Nginx 都在 docker-compose.yml 里编排好了:
docker compose up -d第 4 步:登录后台。浏览器打开http://服务器IP:8080,默认账号密码均为admin,登录后第一件事是改密码。
第 5 步:接设备。在后台"国标设备 → 接入信息"里能看到平台分配的 SIP 参数,把它们填到摄像头的平台接入配置中:
| 参数 | 含义 | 注意事项 |
|---|---|---|
| SIP 服务器 IP | 平台所在服务器的地址 | 设备能访问到的地址,公网部署填公网 IP |
| SIP 服务器端口 | 信令端口 | Docker 部署默认 8116,可在.env中修改 |
| SIP 域 | 国标域编号 | 必须与平台完全一致,错一位就注册不上 |
| 设备国标编号 | 20 位设备 ID | 前 10 位通常与 SIP 域对应,逐位核对 |
| 注册密码 | 鉴权密码 | 两端一致;海康部分型号需先勾选"鉴权"才能输入 |
设备上线后点开通道即可预览。需要重点放行的端口如下(详见 部署文档):
| 端口 | 协议 | 用途 |
|---|---|---|
| 8080 | TCP | Web 管理页面与接口 |
| 8116 | UDP/TCP | SIP 信令(Docker 默认,可改) |
| 10000 | UDP/TCP | 国标流收流(RTP) |
| 5540 / 10935 | TCP/UDP | RTSP / RTMP 拉流推流 |
💡 生产环境建议改掉默认端口(尤其是 SIP 端口),官方文档也明确提示 5060 这类默认端口易受扫描攻击。
别只把它当播放器:三类人各自能拿到什么
接上设备之后,它的价值才展开。我按"谁在用"来拆,比罗列功能清单更实在。
一线运维:离在线、报警、录像都在一个页面
设备列表里能看到每台设备的在线状态、最近心跳时间和通道数量,哪台掉线一眼可见,不用再逐台 SSH 上去 ping。设备上报的报警事件可以订阅并推送到前端页面;录像回放直接查设备端 SD 卡录像,支持按时间段播放和下载。
项目交付:多品牌接入与向上汇聚
交付场景最头疼的两件事它都覆盖了。一是多品牌混接:无论设备是哪个厂商,接入操作都是"填一张表",接入设备文档里连海康、大华、宇视的具体配置截图都给了。二是国标级联:本平台可以作为下级平台注册到区县/市州上级平台,完成注册、心跳保活、目录订阅、通道点播、云台透传一整套流程,也支持同时级联到多个上级;配置入口见 国标级联文档。
另一个容易被忽略的交付利器是"利旧":不支持国标的老摄像机,只要能给 RTSP 地址,就能通过拉流代理接进来;OBS、无人机等推流设备给一个推流地址也能接入。接入后的流可以分发成 RTSP、RTMP、HTTP-FLV、HLS 等多种格式给第三方系统调用,等于把老资产盘活成统一的视频源。
长期维护:按区域组织、按计划录像
设备多了之后,平铺列表没法看。平台支持按行政区划和业务分组把设备组织成树,省市区县逐级展开,权限跟着树走,哪个片区掉线按区域圈出来排查。
还可以配置录制计划让平台按时间表自动录制指定通道(注意:录制的录像暂不支持转发给国标上级),云端录像也支持预览和下载。
客观评价:它的边界在哪里
把话说全,这套免费开源视频监控方案适合与不适合的边界大致是这样:
| 维度 | 适合 | 不适合 |
|---|---|---|
| 设备类型 | 支持国标的 IPC/NVR,RTSP/RTMP 流的旧设备 | 只有私有 SDK 通道、无国标无 RTSP 的设备(需闭源版或另找方案) |
| 网络环境 | 局域网、有公网或端口映射的跨网部署 | 无任何外网通道且无法穿透的纯隔离网(可考虑网闸互联场景单独评估) |
| 规模 | 几百到几千路,取决于硬件 | 官方压测数字仅作参考,万路级请自行实测 |
| 播放格式 | H.264/H.265(浏览器无需插件,H.265 走 wasm 解码) | 对浏览器兼容性要求极苛刻的老旧终端 |
| 录像 | 云端计划录像、回放、下载 | 把录像直接回传给国标上级平台的场景暂不支持 |
另外两条实操经验:wvp 和 ZLMediaKit 之间是高频通信,官方明确不建议把两者拆到两个网络(比如 wvp 在内网、ZLM 在公网);流媒体参数要调优时,重点看 媒体服务配置 里的media段(收流端口、RTP 多端口模式等),改完重启容器再验证。
高频问题 FAQ:注册失败、黑屏、跨公网、级联
Q1:设备一直显示离线,注册不上来怎么办?
先现象后原因:注册失败只有两类原因——信息不一致,或网络不通。第一步逐位核对 SIP 域、设备编号、密码(海康等品牌要先勾选鉴权选项才能输入密码);第二步确认设备到平台 8116 端口的 UDP/TCP 双向可达。详细排查思路见 注册失败文档。
Q2:设备显示在线,点播放却黑屏或提示超时?
分两种:信令超时(平台发出点播请求后长时间无响应)多为 NAT 映射过期或网络不通,公网部署时心跳周期设置过大会加剧这个问题;收流超时(信令成功但流没到)多是 SDP 里的回流出错,比如把 IP 配成了 127.0.0.1 或把内网 IP 发给了公网设备。排查顺序:关闭 SSRC 校验 → 看 ZLM 日志有没有流注册 → 抓包看流是否发出,点播错误文档里有完整流程图解。
Q3:平台在公网、设备在运营商 NAT 后面,能通吗?
能。这正是"支持 NAT 穿透"的含义:设备主动向公网平台注册,信令下行复用注册时建立的通道。注意选对传输模式——跨公网建议信令用 TCP 更稳,内网低延迟场景用 UDP;RTP 流的收发端口(默认 10000)也要在公网侧放行。
Q4:区县、市、省多级汇聚怎么搭?
每一级部署一套 wvp 实例,下级通过"平台 → 添加上级"完成国标级联,开启目录订阅后通道自动上报,上级平台即可点播。同一个平台可以同时级联到多个上级,且支持为不同上级使用不同的通道编号,避免编码冲突。
Q5:没有国标的老 RTSP 摄像头怎么纳入统一管理?
用拉流代理:在后台添加代理并填入设备的 RTSP 地址,平台会像播放器一样把流拉过来缓存再分发。这类通道支持实时播放和转发给上级国标平台,但只有直播能力,没有云台和录像查询——那是国标通道才有的待遇。
一个下午的行动清单
如果决定试用,照着这张清单走,一个下午足够跑通:
- 上午:克隆仓库,在
docker/目录写.env(Stream_IP、SDP_IP、SIP 三项参数),执行docker compose up -d,看到 5 个容器全部 running - 上午:浏览器打开
:8080,admin/admin 登录,改掉默认密码 - 下午:挑一台支持国标的摄像头,按"接入信息"填参,确认列表里状态变为在线
- 下午:点开一路通道预览,试一次云台控制,再查一次设备端录像回放
- 收尾:把 SIP 端口、收流端口在防火墙放行清单里登记,媒体服务密钥(ZLM secret)改成自己的值
做完这四件事,你就有了自己的第一套 GB28181 开源视频监控平台:多品牌摄像头统一管理、免费、可二次开发。剩下的按业务需要展开——要利旧老设备就加拉流代理,要上报上级就开级联,要省流量就确认"无人观看自动断流"处于开启状态。
【免费下载链接】wvp-GB28181-pro基于GB28181-2016、部标808、部标1078标准实现的开箱即用的网络视频平台。自带管理页面,支持NAT穿透,支持海康、大华、宇视等品牌的IPC、NVR接入。支持国标级联,支持将普通摄像机/直播流/直播推流转国标共享到国标平台。项目地址: https://gitcode.com/GitHub_Trending/wv/wvp-GB28181-pro
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考