Gb28181 on Liangweidong's blog

WVP-Pro 国标视频流：GB28181 摄像头注册与 ZLMediaKit 流媒体对接

Thu, 15 Jun 2023 00:00:00 +0800

国内安防/视频监控场景离不开"国标"——GB28181 是公安部推的"安全防范视频监控联网系统信息传输、交换、控制技术要求"，海康/大华/宇视等主流厂商的 NVR、IPC 摄像头都支持 SIP 信令注册到平台。WVP-Pro（wvp_pro）是开源的 GB28181 视频平台，把 SIP 信令、流媒体（集成 ZLMediaKit）、Web 管理、API 对接打包到一容器里，最适合"快速把海康摄像头接到自己平台"。这篇文章讲清楚容器化部署、摄像头注册、SDP IP/流 IP 配置、流端口规划。

阅读对象：要给客户/公司搭视频监控平台、要把海康/大华摄像头统一管理的开发或集成商
覆盖范围：WVP-Pro 容器化部署、GB28181 摄像头注册、SDP IP/流 IP 配置、收流端口规划、ZLMediaKit 集成

一、为什么是 WVP-Pro

GB28181 平台选型，对比几个常见方案：

方案	特点	适用
WVP-Pro	Java + ZLMediaKit，开源，社区活跃	二次开发、对接业务系统
萤石云 / 阿里云视频监控	SaaS，按量付费	不想运维，但要付费
海康 iVMS / 大华 DSS	厂商私有平台	单品牌摄像头
GB28181Server	另一款开源	极简接入
LiveGBS	国标 GB28181 视频平台	商业 / 开源双版本

When to use：要给客户做 GB28181 视频接入、二次开发、API 集成到自有平台，WVP-Pro 是首选。它把"信令 + 流媒体 + Web 管理"全打包，单容器跑起来就能对接海康/大华摄像头。

二、容器化部署

2.1 拉镜像

1

docker pull 648540858/wvp_pro:latest

2.2 启动

WVP-Pro 涉及多个端口：

18080：Web 管理界面 + API
9980：HTTP 流媒体服务（拉流播放）
5060：SIP 信令端口（摄像头注册）
9554：RTSP 端口（部分流媒体场景）
33010-33020：媒体收流端口（每个摄像头分配一个）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


docker run --name wvp \
 --env WVP_IP="{{PUBLIC_IP}}" \
 -itd \
 --restart=always \
 -p 18080:18080 \
 -p 33010-33020:33010-33020/udp \
 -p 33010-33020:33010-33020/tcp \
 -p 9980:9980 \
 -p 5060:5060 \
 -p 5060:5060/udp \
 -p 9554:9554 \
 648540858/wvp_pro:latest

WVP_IP 必须设为公网 IP：摄像头要从公网注册进来，WVP 注册信令的 IP 必须是公网可达的。

2.3 配置文件位置

WVP-Pro 容器内：

/opt/wvp/config/application.yml：WVP 主配置（Spring Boot）
/opt/media/config.ini：ZLMediaKit 配置（流媒体）

启动后立即把配置 cp 出来，挂载进容器：

1
2
3


# 第一次启动后导出
docker cp wvp:/opt/media/config.ini /data/wvp/
docker cp wvp:/opt/wvp/config/application.yml /data/wvp/

必须挂出来：WVP 容器升级/重启后会清空容器内配置，不挂出来就回到默认 IP。

2.4 host 网络模式

--net=host 模式让所有端口直接用宿主机 IP，省去端口映射的麻烦：

1
2
3
4
5
6
7
8


docker run --name wvp \
 --env WVP_IP="{{PUBLIC_IP}}" \
 -itd \
 --restart=always \
 --net=host \
 -v /data/wvp/application.yml:/opt/wvp/config/application.yml \
 -v /data/wvp/config.ini:/opt/media/config.ini \
 648540858/wvp_pro:latest

三、核心配置

3.1 application.yml（关键段）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20


sip:
 ip: {{PUBLIC_IP}}
 port: 5060
 domain: 3402000000
 id: 34020000002000000001
 password: {{REDACTED}}

media:
 # 流 IP（公网 IP，摄像头推流回来用）
 ip: {{PUBLIC_IP}}
 # HTTP 流端口
 http-port: 9980
 # 收流端口范围
 port-range: 33010,33020
 send-port-range: 33010,33020
 sdp-ip: {{PUBLIC_IP}}
 stream-ip: {{PUBLIC_IP}}
 stream-on-demand: false
 record-push-live: false
 auto-apply-play: true

3.2 ZLMediaKit 配置（config.ini）

1
2
3
4
5
6


[http]
port=9980
allow_ip_range=0.0.0.0/0

[rtp]
port=30000-30100

流端口范围：每个摄像头推流回来占一个端口，N 个摄像头至少要 N 个端口。生产环境开 33010-33020 共 11 个端口是基础款。

3.3 修改配置后重启

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16


# 进入容器
docker exec -it wvp bash

# 修改 application.yml
sed -i 's/sdp-ip: .*/sdp-ip: {{PUBLIC_IP}}/' /opt/wvp/config/application.yml
sed -i 's/stream-ip: .*/stream-ip: {{PUBLIC_IP}}/' /opt/wvp/config/application.yml
sed -i 's/port: 5060/port: 5060/' /opt/wvp/config/application.yml

# 改 ZLMediaKit 端口
sed -i '69s/^.*$/port=9980/' /opt/media/config.ini
sed -i '111s/^.*$/port=9554/' /opt/media/config.ini

exit

# 重启 WVP
docker restart wvp

重启后 SDP IP 和流 IP 会还原成 WVP_IP（即启动参数 --env WVP_IP），必须改成公网 IP 后重启，否则摄像头注册后无法推流。

四、添加摄像头

4.1 登录 Web 管理

访问 http://{{PUBLIC_IP}}:18080/#/login：

默认账号：admin
默认密码：admin

生产环境：首次登录立即改密码。

4.2 摄像头接入流程

摄像头端配置（海康威视为例）：
- 平台接入 → 平台管理 → 添加平台
- 协议类型：GB28181
- 服务器 IP：{{PUBLIC_IP}}
- 端口：5060
- SIP 用户名：34020000001110000009（WVP 配置里的 SIP ID）
- 认证密码：与 application.yml 一致
WVP 端查看注册：
- 登录 Web → 控制台
- 信令服务器配置：填 SIP 信息
- 设备列表：刷新等待注册状态变为"在线"
通道管理：
- 设备列表 → 选中摄像头 → 通道
- 视频通道编码 ID：34020000001320000001（每个通道独立）
- 通道状态变"在线"后即可拉流

4.3 拉取 RTSP 流

在浏览器 F12 网络面板里：

进入设备列表 → 通道管理
点击"播放"
F12 切到 Network 标签
找到带 RTSP 的请求
复制 URL（格式：rtsp://{{CAM_USER}}:{{CAM_PASS}}@{{CAM_IP}}:554/Streaming/Channels/101）

rtsp:// 这个地址是摄像头直连的 RTSP 流，不是 WVP 转发的。要走 WVP 转发，用 WebRTC / HTTP-FLV / HLS（在 Web 管理界面"播放"按钮自动选协议）。

五、典型部署架构

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13


[海康/大华 NVR/摄像头] [WVP-Pro 服务]
 SIP 5060 ──注册信令──→ {{PUBLIC_IP}}:5060 (WVP 收 SIP)
 RTSP ──拉/推流──→ {{PUBLIC_IP}}:33010-20 (WVP 收流)
 │
 ▼
 [ZLMediaKit]
 │
 ▼
 [Web 管理 / API]
 http://{{PUBLIC_IP}}:18080

[客户端]
 Web 浏览器 ──HTTP-FLV/WebRTC──→ {{PUBLIC_IP}}:18080 / 9980

六、踩坑清单

SDP IP/流 IP 还原成内网 IP——重启 WVP 后必须重新 sed 改公网 IP
33010-33020 端口未开放——UDP/TCP 都要在公网防火墙开放
Nginx 反代 18080——不能用 Nginx 反代 WVP 的 18080 端口，WebRTC/WebSocket 走 18080，Nginx 反代会断流。要么直接暴露 18080，要么用 stream 段
SIP 注册不上——SIP ID 不在 20 位标准格式、密码不对、WVP 端信令配置和摄像头端不一致
拉流 404——通道未注册成功，或者流端口没开
状态变红不在线——摄像头到 WVP 的网络不通（防火墙、路由、NAT），抓 SIP 包定位

七、2024+ 视角补充

本文写于 2023-06，2024-2026 期间 WVP-Pro / ZLMediaKit 关键演进：

WVP-Pro 4.7+（2024-08）：GB/T 28181-2022 协议全面支持（vs 老 2016 协议）；国密 SM2/SM4 算法支持（政企合规刚需）；WebRTC 推流原生（不再依赖 webrtc-streamer）
WVP-Pro 5.x（2025-Q3）：K8s 部署模式（Spring Cloud 微服务拆分）、分布式集群（多实例注册中心共享）、AI 事件检测（接入 ONVIF + 移动侦测 / 入侵检测）
ZLMediaKit 2024+（持续迭代）：WebRTC WHIP / WHEP 标准协议；SRT over WebRTC 互通；AI 推理模块（内置 ONNX Runtime + 主流模型）
WVP 替代品（2024+ 视角）：
- 国标 GB28181 商业平台：海康 iVMS / 大华 DSS / 宇视 UNV 仍是政企采购首选
- 开源：LiveGBS 2024+ 社区活跃
- 云服务：腾讯云 / 阿里云 / 华为云国标网关（按量计费，无需自建）

实战建议（2025-2026 视角）：

纯 GB28181 + Web 播放 → WVP-Pro 4.7+ + ZLMediaKit 仍是开源首选
AI 集成（人脸 / 车辆 / 入侵）→ WVP 5.x + ONVIF + 边缘 AI 盒子
政企合规 → 商业平台 / 国密改造 / 等保测评一条龙
K8s 部署 → WVP 5.x 微服务模式（注意 Spring Cloud 复杂度）

八、参考资料

WVP-Pro 文档：https://doc.wvp-pro.cn/
GB28181 协议规范：GB/T 28181-2016 / GB/T 28181-2022
ZLMediaKit：https://github.com/ZLMediaKit/ZLMediaKit
LiveGBS：github.com/livegbs/GB28181-Server
海康威视 GB28181 配置手册：各型号 NVR/IPC 平台接入章节

下一步

想用 WebRTC 播放？→ 流媒体与 WebRTC 实时视频一文
想做企业 VPN？→ OpenVPN 自建 VPN 服务一文
想做流媒体服务器？→ 上面的流媒体与 WebRTC 实时视频一文里 ZLMediaKit / MediaMTX / go2rtc 都讲到了

站点与博客自托管：WordPress / WVP 视频监控 / Hoppscotch API 工具

Tue, 15 Nov 2022 00:00:00 +0800

除了主业务系统，企业里还有些"小而重要"的站点需要自托管：内部博客（WordPress）、视频监控平台（WVP）、API 调试工具（Hoppscotch）。这篇把这三个看似不相干但都属于"开箱即用工具"的部署方案整理到一起。

阅读对象：需要快速部署内部工具的运维 / 全栈工程师 覆盖范围：WordPress 博客完整部署 + WVP 视频监控 GB28181 协议对接 + Hoppscotch 替代 Postman 协作

一、WordPress：最经典的博客 / CMS 平台

WordPress 占据全球 CMS 市场 60%+ 份额——既是博客引擎，也是小型站点的建站工具。Docker 化部署只要 30 秒。

1.1 一键启动

1
2
3
4
5


docker run -d --restart=always \
 --name wordpress \
 -p 8864:80 \
 -v /home/project/wordpress/data:/var/www/html \
 wordpress

8864:80 把容器 80 映射到宿主机 8864
/home/project/wordpress/data 是数据卷，升级 / 重建容器不丢数据

1.2 访问

1
2


首页：http://<IP>:8864
后台：http://<IP>:8864/wp-admin

首次访问进入安装向导，5 分钟填完站点信息。默认管理员 admin + 启动时设置的密码。

1.3 生产配置建议

挂 MySQL 而非 SQLite：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13


docker run -d --name wordpress-db \
 -e MYSQL_ROOT_PASSWORD={{DB_ROOT_PASS}} \
 -e MYSQL_DATABASE=wordpress \
 -e MYSQL_USER=wpuser \
 -e MYSQL_PASSWORD={{DB_USER_PASS}} \
 -v /home/mysql/wordpress:/var/lib/mysql \
 mysql:8.0

docker run -d --name wordpress \
 --link wordpress-db:mysql \
 -p 80:80 \
 -v /home/project/wordpress/data:/var/www/html \
 wordpress

挂 PHP 上传目录到独立卷（避免容器重建时上传文件丢失）：

1

-v /home/wordpress/uploads:/var/www/html/wp-content/uploads

1.4 必备插件

Akismet Anti-Spam：垃圾评论过滤
Yoast SEO：SEO 优化（中文站用 Rank Math）
WP Super Cache：静态化提速
UpdraftPlus：自动备份到 OSS / S3
W3 Total Cache：对象缓存 + CDN 加速

1.5 主题选择

博客：Twenty Twenty-Four（官方默认）、Astra
企业站：Astra Pro、GeneratePress、Flavor
中文社区：Kratos（极简风）、Mirages（资讯类）

1.6 安全加固清单

不要用 admin 用户名：装完立刻建新管理员 → 删 admin
限制登录 IP：Nginx 反代时加 allow / deny
启用 2FA：插件 Two Factor Authentication
禁用文件编辑：wp-config.php 加 define('DISALLOW_FILE_EDIT', true);
隐藏 WordPress 版本：functions.php 加 remove_action('wp_head', 'wp_generator');

1.7 备份

1
2
3
4
5
6
7
8
9


# 1. 数据库备份
docker exec wordpress-db mysqldump -u root -p{{DB_ROOT_PASS}} wordpress > wp_backup_$(date +%Y%m%d).sql

# 2. 文件备份
tar czf wp_files_$(date +%Y%m%d).tar.gz /home/project/wordpress/data

# 3. 上传 OSS
ossutil cp wp_backup_*.sql oss://backup-bucket/wordpress/db/
ossutil cp wp_files_*.tar.gz oss://backup-bucket/wordpress/files/

自动化：UpdraftPlus 插件定时备份到 S3 / OSS。

二、WVP：国标 GB28181 视频监控平台

WVP（WEB VIDEO PLATFORM）是基于 Java + ZLM（ZLMediaKit）实现的 GB28181 视频平台——对接海康 / 大华等摄像头、做实时预览、云台控制、录像回放。

2.1 适用场景

工厂 / 园区 / 工地：把分散的 NVR / IPCamera 集中管理
应急 / 安防：实时调取监控画面到 Web 端
视频对讲：GB28181 标准 + SIP 信令

2.2 一键启动

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


docker run --name wvp \
 --env WVP_IP="203.0.113.10" \
 -itd --restart=always \
 -p 18080:18080 \
 -p 33010-33020:33010-33020/udp \
 -p 33010-33020:33010-33020/tcp \
 -p 9980:9980 \
 -p 5060:5060 \
 -p 5060:5060/udp \
 -p 9554:9554 \
 dockerhub.example.com/base/648540858/wvp_pro:latest

关键参数：

WVP_IP：必须是公网 IP 或能被摄像头访问到的 IP
18080：Web 管理界面
33010-33020：GB28181 信令 + 流媒体端口
9980：ZLM HTTP 端口
5060：SIP 信令端口（不能改，GB28181 协议规定）
9554：ZLM RTSP 推流端口

2.3 配置文件修改

1
2
3
4
5


# 进入容器
docker exec -it wvp bash

# 修改 WVP 配置
vim /opt/wvp/config/application.yml

常用配置项：

1
2
3
4
5
6
7
8
9


sip:
 ip: 203.0.113.10 # SIP 信令 IP
 port: 5060
media:
 sdp-ip: 203.0.113.10 # SDP 协商 IP
 stream-ip: 203.0.113.10 # 媒体流 IP
 http-port: 9980
 rtp:
 port-range: 33010,33020 # 一字对应启动端口

修改后必须重启：

1

docker restart wvp

注意：重启后 sdp-ip 和 stream-ip 会还原成启动时的 WVP_IP——生产要把 WVP_IP 设对。

2.4 挂载配置（推荐）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18


# 1. 先启动一次让容器生成配置
docker run --name wvp --env WVP_IP="203.0.113.10" -itd wvp_pro:latest

# 2. 拷贝配置出来
docker cp wvp:/opt/wvp/config/application.yml /data/wvp/
docker cp wvp:/opt/media/config.ini /data/wvp/

# 3. 停掉 + 删除
docker rm -f wvp

# 4. 重新启动，挂载配置
docker run --name wvp \
 --env WVP_IP="203.0.113.10" \
 -itd --restart=always \
 --net=host \
 -v /data/wvp/application.yml:/opt/wvp/config/application.yml \
 -v /data/wvp/config.ini:/opt/media/config.ini \
 dockerhub.example.com/base/648540858/wvp_pro:latest

2.5 接入海康摄像头

摄像头配置（Web 界面 http://<camera-ip>/doc/page/config.asp）：

1
2
3
4
5


SIP 服务器地址：203.0.113.10
SIP 服务器端口：5060
SIP 用户名：34020000001320000022
SIP 认证密码：（任意）
视频通道编码ID：34020000001320000001

WVP 端：

登录 http://203.0.113.10:18080（默认 admin/admin）
进入 控制台 → 信令服务器配置，填摄像头信息
摄像头注册成功后自动出现在设备列表
点击通道 → 播放即可预览

2.6 录像回放 / 云台

WVP 支持：

实时预览（Web 端 HTML5 播放）
云台控制（上下左右、镜头变倍变焦）
录像回放（基于 ZLM 自动录像）
报警联动（对接 IoT 平台）

注意：海康摄像头必须先在 WVP 注册才能控制云台——RTSP 直连不能控制。

2.7 反向代理 / 公网映射

不能用 Nginx 7 层代理——GB28181 用的是 UDP 协议，且 SIP 信令对延迟敏感。

正确做法：路由器 / 防火墙直接做 1:1 端口映射，把公网 IP 段 33010-33020 转到内网 WVP 服务器。

三、Hoppscotch：开源 Postman 替代

Hoppscotch（原 Postwoman）是开源的 API 调试工具——比 Postman 轻、比 curl 友好、团队协作强。

3.1 一键启动

1
2
3
4


docker run -d --name hoppscotch \
 --restart=always \
 -p 3000:3000 \
 hoppscotch/hoppscotch:latest

访问 http://<IP>:3000 即可使用——单容器版本不支持多人协作，要协作得部署完整版。

3.2 完整版（PostgreSQL + 后端 + 前端）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29


version: "3.8"
services:
 hoppscotch-backend:
 image: hoppscotch/hoppscotch-backend:latest
 restart: always
 environment:
 - DATABASE_URL=postgres://hopp:hopp@hoppscotch-db:5432/hopp
 depends_on:
 - hoppscotch-db
 ports:
 - "3100:3100"

 hoppscotch-frontend:
 image: hoppscotch/hoppscotch-frontend:latest
 restart: always
 depends_on:
 - hoppscotch-backend
 ports:
 - "3000:3000"

 hoppscotch-db:
 image: postgres:13
 restart: always
 environment:
 - POSTGRES_USER=hopp
 - POSTGRES_PASSWORD={{DB_PASS}}
 - POSTGRES_DB=hopp
 volumes:
 - /data/hoppscotch/pgdata:/var/lib/postgresql/data

3.3 核心功能

REST / GraphQL / WebSocket / SSE 全协议支持
环境变量（dev / staging / prod 切换）
协作空间（团队共享请求集合）
Postman 导入（一键迁移现有 .json）
OpenAPI / Swagger 导入
测试用例 + 自动化测试

3.4 与 Postman 对比

维度	Hoppscotch	Postman
体积	几十 MB	几百 MB
启动速度	< 1 秒	5-10 秒
团队协作	开源自托管	收费
客户端	Web（也可装 PWA）	独立客户端
协议支持	REST / GraphQL / WS / SSE	全部
Mock 服务器	✅	收费
自动化测试	✅	✅

企业内网推荐 Hoppscotch——避免 Postman 把 API 文档同步到 Postman 服务器（数据合规问题）。

四、典型坑位

4.1 WordPress 上传文件 413

症状：上传大于 2MB 的图片失败。

修复：三处都要调

Nginx：

1

client_max_body_size 100m;

PHP（在 wp-config.php 之前）：

1
2
3


@ini_set('upload_max_size', '100M');
@ini_set('post_max_size', '100M');
@ini_set('max_execution_time', '300');

WordPress 后台：设置 → 媒体 → 大小 改到合适。

4.2 WVP 摄像头显示离线

排查清单：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# 1. 摄像头能否 ping 通公网 IP
ping 203.0.113.10

# 2. 5060 端口是否开放
nc -zv 203.0.113.10 5060

# 3. 容器日志
docker logs -f wvp

# 4. ZLM 状态
curl http://localhost:9980/index/api/getServerConfig

4.3 Hoppscotch WebSocket 测试断连

修复：用 wss://（加密）而非 ws://；生产 WebSocket 都应该是 wss。

五、安全合规清单

工具	风险	加固建议
WordPress	暴力破解 / 0day 漏洞	强密码 + 2FA + WAF + 自动更新
WVP	默认弱口令 `admin/admin`	首次登录必改密码 + 限定内网访问
Hoppscotch	API 凭据泄露	强制登录 + 团队权限 + 凭据加密存储

六、备份策略

1
2
3
4
5
6
7
8


# 1. WordPress 全量备份（crontab 每天 3 点）
0 3 * * * /usr/local/bin/wp_backup.sh

# 2. WVP 配置备份
0 4 * * * tar czf /backup/wvp-$(date +\%Y\%m\%d).tar.gz /data/wvp/

# 3. Hoppscotch 数据库备份
0 5 * * * docker exec hoppscotch-db pg_dump -U hopp hopp > /backup/hopp-$(date +\%Y\%m\%d).sql

2024+ 视角补充

本文写于 2022-11，2024-2026 期间 WordPress / WVP / Hoppscotch 三个工具的演进：

WordPress 6.5+（2024-04）/ 6.6（2024-07）：全站编辑（Full Site Editing）成熟、字体 API、Block Theme 主流——传统 PHP 主题模式逐步被块主题取代
WVP 4.7+（2024-08）：GB/T 28181-2022 国标全面支持、国密算法、AI 事件检测
Hoppscotch 2024+：已从单仓库拆分为 hoppscotch / hoppscotch-backend / hoppscotch-k8s——企业版商业化（hoppscotch-enterprise），自托管社区版仍 100% 开源
Postman 2024+：**本地化协作（Postman Offline）**已 GA；AI 助手 Postman AI（生成测试用例）商业化
Insomnia 9.x（2024-2026）：开源 API 客户端，GraphQL / gRPC / WebSocket 全协议；插件市场完善
Bruno 1.x（2023-2025）：“Postman 杀手”——纯本地文件存储（.git 友好）、离线优先、开源免费
HTTPie 3.x：CLI API 客户端，2024 仍是命令行党首选

实战建议（2025-2026 视角）：

WordPress 6.6+ + PHP 8.3 + MariaDB 11 是 2025+ 稳态组合
WVP 4.7+ 是 2024+ GB28181 开源首选
API 工具选型：
- 团队协作 + 云同步 → Postman / Hoppscotch
- Git 友好 + 离线 → Bruno（新项目首选）
- CLI 党 → HTTPie
- GraphQL / gRPC 重度 → Insomnia

下一步

想看 VPN 与代理自托管（OpenVPN / V2Ray）→ VPN 与代理自托管
想看 Watchtower 容器自动更新（守护所有容器的升级）→ Watchtower 容器自动更新
想看 Vaultwarden 密码管理（Bitwarden 自托管）→ Vaultwarden 密码管理
想看 MinIO 对象存储实战（S3 兼容对象存储）→ MinIO 对象存储实战

GB28181 视频监控平台深度剖析：WVP-GB28181-pro 全链路源码分析

Tue, 15 Sep 2020 00:00:00 +0800

WVP-GB28181-pro 是国内基于 GB/T 28181 国标协议的视频监控管理平台，2020 年 GitHub 上 648540858/wvp-GB28181-pro 仓库 star 数已经超过 4k。它的核心是用 JAIN SIP 协议栈做信令服务，把 GB28181 设备（摄像头、NVR、平台）注册到平台，然后做实时视频流转发、云端录像、录像回放、级联、报警等。本文从源码层做一次完整剖析。

本文写于 2020 年 9 月——WVP-GB28181-pro 1.x 时代。该项目至今仍在持续迭代。

一、GB28181 协议基础

GB/T 28181-2016《安全防范视频监控联网系统信息传输、交换、控制技术要求》是中国公安部主导的国标协议，用于把不同厂商的摄像头/NVR 统一接入到一个平台上。

1.1 协议核心特征

信令协议：SIP（RFC 3261）+ SDP
传输层：UDP（默认）/ TCP
媒体流：RTP/RTCP（基于 RTSP 推流或 PS 封装的 RTP）
编解码：H.264 / H.265 / SVAC
核心交互：注册、目录查询、实时点播、回放、下载、报警、级联

1.2 GB28181 与 ONVIF 的区别

维度	GB28181	ONVIF
国别	中国国标	国际标准
协议	SIP	HTTP + RTSP
推送方式	主动注册 + 平台调度	设备发现 + RTSP 拉流
主要场景	平安城市、雪亮工程	企业园区、商业楼宇
厂商支持	海康/大华/宇视/科达	Axis/Bosch/Hanwha

二、WVP-GB28181-pro 项目架构

2.1 项目定位

WVP-GB28181-pro 是纯 Java 实现的 GB28181 国标信令网关 + 流媒体服务：

前端：Vue + Element UI（管理摄像头、用户、回放、录像）
后端：Spring Boot + JAIN SIP + ZLMediaKit（流媒体）
存储：MySQL（设备信息）+ Redis（信令缓存）+ MinIO/阿里 OSS（录像）

2.2 核心模块

1
2
3
4
5
6
7


com.<your-org>.stream.gb28181
├── SipLayer # SIP 服务端（监听 5060 端口）
├── config # 配置（信令端口、IP、上级平台）
├── media # 媒体流转发
├── session # 客户端会话管理
├── event # 事件订阅与通知
└── controller # REST API（前端调用）

2.3 关键依赖

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20


<dependencies>
 <!-- SIP 协议栈 -->
 <dependency>
 <groupId>javax.sip</groupId>
 <artifactId>jain-sip-ri</artifactId>
 <version>1.3.0-91</version>
 </dependency>

 <!-- Spring Boot Web -->
 <dependency>
 <groupId>org.springframework.boot</groupId>
 <artifactId>spring-boot-starter-web</artifactId>
 </dependency>

 <!-- ZLMediaKit Java SDK -->
 <dependency>
 <groupId>com.aizuda</groupId>
 <artifactId>zlmediakit-java-sdk</artifactId>
 </dependency>
</dependencies>

三、SIP 信令栈核心：JAIN SIP API

3.1 SipProvider 实现

WVP 使用的 JAIN SIP 协议栈在 gov.nist.javax.sip 包下：

1
2
3
4
5
6


public class SipProviderImpl implements
 SipProvider, // 公共 SIP 接口
 SipProviderExt, // 扩展接口
 SIPTransactionEventListener, // 事务事件
 SIPDialogEventListener { // 对话事件
}

三个核心能力：

发送 SIP 消息（REGISTER / INVITE / MESSAGE / BYE）
接收 SIP 消息（响应 + 异步事件）
管理 SIP 事务 + 对话（事务超时、重传）

3.2 SipListener 接口

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19


public interface SipListener extends EventListener {
 // 1. SIP 请求消息到达时 REGISTER/INVITE/BYE/MESSAGE
 void processRequest(RequestEvent event);

 // 2. SIP 响应消息到达时（200 OK / 401 / 403 等）
 void processResponse(ResponseEvent event);

 // 3. SIP 事务超时（INVITE 超时、OPTIONS 心跳超时等）
 void processTimeout(TimeoutEvent event);

 // 4. 网络 I/O 异常（连接断开、发送失败）
 void processIOException(IOExceptionEvent event);

 // 5. SIP 事务结束（ACK 收到后 INVITE 事务终结）
 void processTransactionTerminated(TransactionTerminatedEvent event);

 // 6. SIP 对话（Dialog）结束（双方会话完全终结）
 void processDialogTerminated(DialogTerminatedEvent event);
}

WVP 中所有 SIP 入口都通过 SipListener 接收，然后分发给具体的 ISIPProcessorObserver 处理。

四、SipLayer 服务端源码剖析

4.1 SipLayer 完整结构

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32


@Slf4j
@Component
@Order(value = 10)
public class SipLayer implements CommandLineRunner {
 @Autowired
 private SipConfig sipConfig;

 @Autowired
 private ISIPProcessorObserver sipProcessorObserver;

 @Autowired
 private UserSetting userSetting;

 // TCP 与 UDP 的 SIP Provider 映射
 private final Map<String, SipProviderImpl> tcpSipProviderMap = new ConcurrentHashMap<>();
 private final Map<String, SipProviderImpl> udpSipProviderMap = new ConcurrentHashMap<>();

 // 已监听过的 IP（防止重复 bind）
 private final List<String> monitorIps = new ArrayList<>();

 @Override
 public void run(String... args) {
 // 应用启动时初始化 SIP 监听
 initSipServer();
 }

 public SipProviderImpl getUdpSipProvider(String ip) { /* ... */ }
 public SipProviderImpl getUdpSipProvider() { /* ... */ }
 public SipProviderImpl getTcpSipProvider(String ip) { /* ... */ }
 public SipProviderImpl getTcpSipProvider() { /* ... */ }
 public String getLocalIp(String deviceLocalIp) { /* ... */ }
}

4.2 关键设计点

1. 双协议监听（TCP/UDP）：

GB28181 设备通常用 UDP 5060 端口
高级设备或跨网段用 TCP 5060 端口
同一进程需要同时维护两套 SipProvider

2. 多 IP 监听：

多网卡服务器需要监听所有 IP
tcpSipProviderMap / udpSipProviderMap 按 IP 维度维护
monitorIps 列表去重，防止重复 bind

3. 启动顺序 @Order(10)：

Spring Boot CommandLineRunner 启动后立即初始化
@Order(10) 保证在 Spring 主流程就绪后才启动 SIP
失败的 SIP 初始化不会阻断 Web 服务

五、完整调用链：设备注册到目录查询

5.1 时序图

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


 Device WVP Controller sipCommander 设备 CatalogResponseMessageHandler DeviceChannelMapper DB
 │ │ │ │ │ │ │
 │─注册成功─▶│ │ │ │ │ │
 │ │─sync(device)───▶│ │ │ │ │
 │ │ │─CatalogQuery─▶│ │ │ │
 │ │ │◀──Catalog XML─│ │ │ │
 │ │ │ │──handle()───────▶│ │ │
 │ │ │ │ │──batchAdd───────────▶│ │
 │ │ │ │ │──batchUpdate────────▶│ │
 │ │ │ │ │──batchDel───────────▶│ │

5.2 调用链详解

阶段 1：设备注册

1
2
3
4
5
6


设备 → REGISTER → SipLayer（UDP 5060）
 → SipListener.processRequest()
 → ISIPRequestObserver（注册处理器）
 → 校验设备 ID + 密码
 → 更新设备状态为"在线"
 → 200 OK

阶段 2：心跳保活

1
2
3
4
5


设备 → MESSAGE（Keepalive） → SipLayer
 → SipListener.processRequest()
 → 解析 XML 设备状态
 → 更新设备最后心跳时间
 → 200 OK

阶段 3：目录查询（Catalog Query）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


WVP Controller 触发"同步通道"
 → DeviceService.sync()
 → sipCommander.catalogQuery(device, deviceChannel)
 → SIP MESSAGE（带 Catalog 查询 XML）
 → 设备 → 200 OK
 → 设备 → SIP MESSAGE（异步返回 Catalog 列表）
 → SipLayer → CatalogResponseMessageHandler.handle()
 → 解析 XML 中的通道列表
 → DeviceChannelMapper.batchAdd(新增通道)
 → DeviceChannelMapper.batchUpdate(更新通道)
 → DeviceChannelMapper.batchDel(删除通道)
 → 写入 DB

六、请求处理统一入口：ISIPRequestProcessor

6.1 处理器接口

1
2
3
4
5
6
7


public interface ISIPRequestProcessor {
 // 处理方法名
 String getMethod();

 // 处理逻辑
 void process(RequestEvent event);
}

6.2 内置处理器

WVP 内部为每种 SIP 请求都实现了一个 ISIPRequestProcessor：

Method	处理器	用途
`REGISTER`	RegisterRequestProcessor	设备注册
`MESSAGE`	MessageRequestProcessor	消息分发（心跳/目录/报警）
`INVITE`	InviteRequestProcessor	实时点播
`BYE`	ByeRequestProcessor	结束点播
`SUBSCRIBE`	SubscribeRequestProcessor	事件订阅
`ACK`	AckRequestProcessor	INVITE 确认
`OPTIONS`	OptionsRequestProcessor	能力探测

6.3 派发器实现

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17


public class SIPRequestProcessorParent implements SipListener {
 @Autowired
 private List<ISIPRequestProcessor> processors; // Spring 自动注入

 @Override
 public void processRequest(RequestEvent event) {
 Request request = event.getRequest();
 String method = request.getMethod();

 for (ISIPRequestProcessor processor : processors) {
 if (method.equals(processor.getMethod())) {
 processor.process(event);
 break;
 }
 }
 }
}

设计模式：策略模式 + 依赖注入——新增请求类型只需要新增一个 ISIPRequestProcessor 实现，Spring 自动扫描注册。

七、流媒体集成：ZLMediaKit

WVP 本身不做媒体流转发，它把流媒体的工作交给 ZLMediaKit（一个基于 C++ 的高性能流媒体服务）：

1
2
3


GB28181 设备 → RTP/PS 流 → WVP 接收 → ZLMediaKit 拉流
 → 转 RTMP/HLS/WebRTC
 → 推到客户端

7.1 ZLMediaKit 角色

接收端：通过 RTP 接收 PS 流（来自 GB28181 设备）
转换端：把 PS 流转换为 RTMP/HLS/WebRTC
分发端：把转换后的流推给浏览器/移动端/录像

7.2 WVP 调用 ZLMediaKit 的方式

1
2
3
4
5
6
7
8


// WVP 通过 HTTP API 调用 ZLMediaKit
POST http://zlmediakit:9000/index/api/openRtpServer
Body:
{
 "port": 10000,
 "enable_tcp": true,
 "stream_id": "channel_001"
}

八、关键坑点与实战经验

8.1 SIP 端口冲突

1
2
3
4


# 错误：Address already in use
# 原因：5060 端口被系统 SIP 服务占用
lsof -i :5060
# 解决：修改 WVP 配置改用其他端口

8.2 设备注册失败

现象	原因	解决
401 Unauthorized	设备密码错误	检查 `UserSetting` 配置
408 Request Timeout	网络不通	检查防火墙 + 端口
480 Temporarily Unavailable	平台未就绪	检查 ZLMediaKit 状态

8.3 视频流拉不到

现象	原因	解决
ZLMediaKit 返回错误	流地址配置错误	检查 `stream_id`
客户端黑屏	编解码不兼容	强制转码
录像文件 0 字节	录制路径权限	`chown` 给 WVP 用户

九、写在最后

WVP-GB28181-pro 的成功在于：

选型准确——Java 做信令网关（生态成熟、Spring Boot 快速开发）
解耦清晰——SIP 信令 + 媒体流分离（ZLMediaKit 处理高吞吐）
实战性强——适配海康/大华/宇视主流厂商设备
社区活跃——issue 响应快，文档持续更新

个人建议：

想要自建视频监控平台：WVP + ZLMediaKit 是国内最成熟的组合

商业项目：考虑EasyCVR / TSINGSEE 等商业产品（带 UI 和运维）

国家级项目：需要支持GB28181-2022 新国标（WVP 已部分支持）

参考资料

GB/T 28181-2016 协议规范
WVP-GB28181-pro GitHub
ZLMediaKit 官方文档
[JAIN SIP API 文档](https://docs.oracle.com/cd/E13203_01/tuxedo/tux90/ sip_java/javax/sip/SipListener.html)

十、2024+ 视角：GB28181-2022、AI 视频分析与 WebRTC 播放

本文写于 2020 年 9 月，WVP-GB28181-pro 至今仍是最活跃的国标信令网关。下面补充 2024-2026 行业关键变化：GB28181-2022 新国标、AI 视频分析、WebRTC 浏览器播放、ZLMediaKit 演进。

10.1 GB28181-2022 新国标：协议升级到"互联网友好"

GB/T 28181-2022 在 2023 年正式实施，对开发影响最大的是 4 件事：

TCP 协议从可选升级到推荐——2020 时代用 UDP 5060 是默认，2024+ 因为防火墙/NAT，TCP 已成为企业内部部署首选
H.265/HEVC 强制支持——eladmin 之类的旧版本 WVP 客户端无法解码 H.265 流，2024+ WVP-GB28181-pro 默认带 H.265 解码
信令通道支持 HTTPS / WSS——2020 时代 SIP 走 UDP 明文，2024+ 公安部等保 2.0 三级要求信令加密
多级级联 + 跨域互联——上/下级平台鉴权从 IP 白名单升级到 OAuth 2.0

WVP-GB28181-pro 在 2024 年的 2.0+ 版本（社区称为 WVP-PRO v2）已经默认兼容 2016 + 2022 双协议。

10.2 WVP 项目的关键演进（2020 → 2026）

维度	2020（v1.x）	2024+（v2.x）
Spring Boot	2.4.x	3.2.x
JDK	8	17 / 21
SIP 协议栈	jain-sip-ri 1.3.0-91	mjSIP 或 RestComm 替代（社区维护）
流媒体	ZLMediaKit HTTP API	ZLMediaKit 25.x + SRS 5.x 双支持
前端	Vue 2 + Element UI	Vue 3 + TypeScript + Vben
协议支持	GB28181-2016	GB28181-2016 + 2022 双协议
AI 集成	无	内置 AI 视频分析插件（火焰/安全帽/人脸）

10.3 AI 视频分析：从"看到"到"看懂"

2020 年的 WVP 主要是"信令 + 流转"，2024-2026 的核心增量是 AI 视频分析：

海康/大华原生 AI 摄像头（内置 NPU）——边缘推理，云端只收告警
云端 AI 分析插件（基于 YOLOv8 / RT-DETR）——WVP 接入 RTSP 流后调用 AI 服务，实现"事后分析 + 实时告警"
多模态大模型（LLaVA、GPT-4V）——2025-2026 的 WVP 高级版本可以"上传一张图，问 AI 视频里发生了什么"

实战架构（2025 主流）：

1
2
3
4
5
6
7


GB28181 摄像头 → WVP（信令）→ ZLMediaKit（流媒体）
 ↓
 AI 分析服务（Python + YOLOv8）
 ↓
 告警 → Kafka → 业务系统
 ↓
 录像 → MinIO / 阿里 OSS

单纯做信令网关的 WVP 价值在 2025 年正在被压缩，“WVP + ZLMediaKit + AI 分析"的三件套才是完整方案。

10.4 WebRTC 浏览器播放：解决 H5 时代痛点

2020 年的痛点：浏览器只能看 HLS（延迟 3-5 秒）或 RTMP（需要 Flash）。2024+ 的方案：

ZLMediaKit 内置 WebRTC——浏览器直接 <video> 标签播放，延迟 <500ms
WVP 把 GB28181 PS 流推到 ZLMediaKit → 转 WebRTC——完整链路延迟 <1s
WHEP / WHIP 协议——2024 年成为 WebRTC 与 GB28181 互通的事实标准

实际项目里：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16


// 浏览器端 WebRTC 拉流（2024+ 主流）
const pc = new RTCPeerConnection();
pc.addTransceiver('video', { direction: 'sendrecv' });
pc.addTransceiver('audio', { direction: 'sendrecv' });

const offer = await pc.createOffer();
await pc.setLocalDescription(offer);

// 拉 ZLMediaKit 的 WebRTC 流
const resp = await fetch('http://zlmediakit:9000/index/api/webrtc?app=live&stream=cam001&type=play');
const answer = await resp.json();
await pc.setRemoteDescription(answer);

pc.ontrack = (event) => {
 document.getElementById('video').srcObject = event.streams[0];
};

10.5 实战补充（2024-2026）

K8s 部署：WVP + ZLMediaKit 全部跑在 K8s，VIP 改成 K8s Service（不再需要 Keepalived）
可观测性：WVP 接入 Prometheus + Grafana，SIP 注册成功率、在线设备数、流转发 QPS 全部可视化
安全加固：
- SIP 端口从 5060 改 5061（WSS 加密）
- Redis 加 TLS
- ZLMediaKit 的 HTTP API 加 JWT 鉴权
大规模部署：单 WVP 实例承载 5000+ 设备，集群方案需要 2024+ 的 WVP-PRO 商业版

10.6 个人总结：WVP 5 年的变化

2020 年做视频监控 = 信令网关 + 拉流分发
2024 年做视频监控 = 信令网关 + 流媒体 + AI 分析 + 浏览器低延迟
2026 年做视频监控 = 全套 + 多模态 AI + 边缘计算

WVP-GB28181-pro 这个项目 5 年来依然是国内 Java 视频监控的"事实标准”——只是从"信令网关"演变成了"AI 视频平台入口"。