wvp-GB28181-pro 部署实战：Docker 十分钟接入第一批 GB28181 摄像头

wvp-GB28181-pro 部署实战Docker 十分钟接入第一批 GB28181 摄像头【免费下载链接】wvp-GB28181-pro基于GB28181-2016、部标808、部标1078标准实现的开箱即用的网络视频平台。自带管理页面支持NAT穿透支持海康、大华、宇视等品牌的IPC、NVR接入。支持国标级联支持将普通摄像机/直播流/直播推流转国标共享到国标平台。项目地址: https://gitcode.com/GitHub_Trending/wv/wvp-GB28181-pro园区 80 路摄像头一半海康一半大华两周内置换为统一平台。这篇是笔者用 wvp-GB28181-pro 这套 GB28181 视频监控平台做的完整部署复盘从环境体检、配 .env、点火启动到第一台摄像头注册上线每一步都能照着做。30 秒认识 wvp-GB28181-pro先说清楚它是什么免得装完不知道东西在哪基于 GB28181-2016 国标协议兼容部标 808/1078海康、大华、宇视等品牌的 IPC/NVR 走统一 SIP 协议接入不用为每个品牌单独写对接。五个容器各管一摊polaris-redis 存缓存、polaris-mysql 存设备数据、polaris-mediaZLMediaKit收 RTP 流、polaris-wvp 跑 SIP 信令和后端、polaris-nginx 做 Web 代理。配置集中在 docker/ 目录一份 .env 决定 SIP 身份和网络出口其余联动doc/ 里有部署和排错的完整文档本文所有路径都出自仓库。平台默认账号密码均为 admin/admin登录 8080 端口后第一件事是改密码。 从零到一部署实录环境体检怎么做装之前花十分钟过一遍这张表后面 90% 的坑都在这一层检查项验证命令合格标准操作系统cat /etc/os-release64 位 CentOS 7 / Ubuntu 20.04Docker 版本docker --version docker compose version20.10compose v2 可用内存free -h8GB 起步4 核 8G 可跑约 200 路每多 1000 路再加 1GB 左右磁盘df -hdocker 所在分区 50GB 可用录像另算SIP 端口ss -lunp | grep 81608160/udptcp 未被占用也可改回 5060媒体端口ss -lnup | grep ^.*30030000-30500 段空闲防火墙同段放行.env 怎么配.env 是唯一必须改的文件下面这几行直接决定设备能不能注册、流能不能播SIP_Id35020000002000000001 SIP_Domain3502000000 SIP_Password换成自己的强密码 SIP_Port8160 Stream_IP服务器内网或公网IPSIP_Id 是平台自己的 20 位国标编号SIP_Domain 一般取它前 10 位两者要和上级平台报备的一致注册时设备就是拿它们对号。SIP_Port 没沿用 5060 是有意的——5060 是公网扫描的重灾区测试环境想省事改回 5060 也行。Stream_IP 写进前端播放地址的 IP保持 127.0.0.1 的话只有本机能放流。媒体收流端口范围在 docker/media/config.ini 的 [rtp_proxy] port_range 里默认 30000-30500。启动与冒烟验证怎么过代码和全部容器配置都在仓库的 docker 目录里克隆后直接进去git clone https://gitcode.com/GitHub_Trending/wv/wvp-GB28181-pro cd wvp-GB28181-pro/docker这一条命令拉起五个容器随后用 ps 和日志确认状态正常docker compose up -d docker compose ps docker compose logs -f polaris-wvp冒烟标准5 个容器全部 Upwvp 日志滚完没有 ERROR浏览器打开 http://服务器IP:8080admin/admin 能进设备列表页能打开。接入第一台摄像头设备端参数对照表拿一台海康或大华的枪机做试验在设备 Web 管理页找到平台接入海康在高级配置→平台接入大华在网络→GB28181 接入按下表填写后启用注册成功即出现在平台设备列表设备端字段填写内容来源SIP 服务器地址部署 wvp 的服务器 IP内网填内网 IP你的服务器SIP 服务器端口8160与 .env 的 SIP_Port 一致.env平台编号SIP 服务器 ID3502000000200000000120 位.env 的 SIP_IdSIP 域350200000010 位.env 的 SIP_Domain注册用户名 / 密码设备自身 20 位编号 / 平台统一密码.env 的 SIP_Password 四个高频能力实操设备列表与状态监控怎么看在国标设备页按在线状态筛选每台设备的最近心跳、最近注册、通道数一目了然。点右上系统信息可复制本平台的国标编号、域和注册密码直接粘贴到设备端别手抄。设备离线时先看最近心跳时间心跳断了查网络注册失败查密码和编号。新挂的 NVR 通道数不对进操作列触发通道刷新等目录同步完成再核对。多画面预览与云台控制怎么用进分屏监控切 1/4/9/16 分屏左侧通道树勾选后画面直接上墙。播放基于 WebRTC浏览器无插件H.265 走 WASM 解码老机器掉帧就换 Chrome 最新版。播放器工具条点云台按钮方向、变倍、预置位、巡航、雨刷全在面板里。多路同屏先切子码流保流畅单画面要看细节再回主码流。国标级联把下级平台挂上来级联→新增进入上级平台配置页。填写上级平台编号、域、地址与端口以及交换好的 SIP 认证用户名和密码。信令传输默认 UDP跨广域丢包或时延高就切 TCP。保存后状态变在线再用选择通道把本平台的通道批量共享给上级上级即可点播。录像检索与下载怎么做录像两个来源云端录像平台侧 ZLM 落盘和国标设备自带录像走国标协议查设备。云端录像列表按开始/结束时间过滤命中记录直接播放在线看下载拿 mp4。要下大批量文件优先整段下载后离线归档别逐条点。国标录像查不到时先核对设备时钟别急着怀疑平台。部署时最容易踩的 5 个坑现象设备注册 403 或无响应。原因SIP 端口只放通了 TCP而 GB28181 注册默认走 UDP。处理防火墙和安全组同时放行 8160 的 udptcp用nc -u 平台IP 8160验证。现象前几路正常路数一多就有通道黑屏。原因媒体收流端口段太小默认 30000-30500 仅约 500 个端口每路收流占一段。处理config.ini 的 port_range 拉大到 30000-40000防火墙同步放行重启 polaris-media。现象NAT 后面注册成功视频就是出不来。原因SDP 里给设备的是内网 IP媒体包回不去 NAT。处理Stream_IP/SDP_IP 改为公网或内网穿透IP或把设备端流传输切成 TCPwvp 对 NAT 场景有对应支持。现象某时间段录像怎么都查不到。原因设备时钟漂了几小时录像文件名时间戳整体错位。处理设备端开启 NTP 校时临时检索按设备自身时间换算一遍再查。现象页面能开播放器的流地址却是 127.0.0.1。原因Stream_IP 没改平台按本机回环生成地址。处理.env 里 Stream_IP 和 SDP_IP 都改成前端可达的服务器 IP重启 polaris-wvp 和 polaris-nginx。单机 / 集群 / 云原生怎么选部署模式适合谁关键动作代价单机五容器50-200 路试点、PoC一台 4 核 8G 直接docker compose up -d单点故障录像吃本地磁盘wvp 与 media 分机200-1000 路生产media 放带宽大的机器改 ZLM_HOOK_HOSTwvp 与 media 保持同内网网络配置多一层Stream_IP 要仔细核对多机多节点1000 路媒体节点页挂多个 ZLMMySQL/Redis 主从或托管实例运维复杂度明显上升需要容量规划云原生 K8s多地域、弹性伸缩容器配置迁 Deploymentmedia 节点固定大端口段和带宽学习成本高云上 UDP 端口段受限两周下来80 路混装设备在单台 4 核 8G 机器上跑稳真正费时间的反而是逐台改摄像头配置不是平台本身。开工前记住两件事先拿 1 台设备走通注册→预览→录像的完整 PoC再批量接入把 .env 全文和防火墙放行规则存档换机重装能省半天。【免费下载链接】wvp-GB28181-pro基于GB28181-2016、部标808、部标1078标准实现的开箱即用的网络视频平台。自带管理页面支持NAT穿透支持海康、大华、宇视等品牌的IPC、NVR接入。支持国标级联支持将普通摄像机/直播流/直播推流转国标共享到国标平台。项目地址: https://gitcode.com/GitHub_Trending/wv/wvp-GB28181-pro创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考