Docker部署wvp-GB28181-pro：国标视频监控平台搭建实践-代码聚汇网

Docker部署wvp-GB28181-pro：国标视频监控平台搭建实践

我行我素12334·2026-09-02·阅读 22 GEO检测（免费）

GB28181Dockerwvp-GB28181-pro

|难度：普通|阅读约 46 分钟

上个月给一个园区做视频监控平台对接，甲方要求所有摄像头必须走国标GB28181协议接入，原有的私有SDK方案直接作废。时间紧、任务重，我第一反应就是用wvp-GB28181-pro这套开源方案，配合Docker快速把环境搭起来。折腾了两三天，踩了不少坑，也积累了一些经验。今天就把整个从0到1的部署过程完整记录下来，给后面要搞国标接入的朋友做个参考。

先说清楚wvp-GB28181-pro是什么。它本质上是一套完整的GB28181信令服务加流媒体网关，后端用Java写的，主要负责SIP信令交互、设备目录管理、推拉流鉴权，前端是一套Vue的管理界面。配合ZLMediaKit作为流媒体服务器，可以实现摄像头国标接入、WebRTC播放、语音对讲、录像回放等一整套能力。这套东西你手动编译部署，环境依赖特别多，Java版本、Maven依赖、Node构建、ZLMediaKit编译，每一步都能把人逼疯。但用Docker的话，事情就简单很多，镜像拉下来直接跑，配置改改就能用。这篇文章不是纯教程复述，而是把我实际操作中遇到的问题、排查思路、配置细节全部摊开来讲，适合第一次接触GB28181和服务部署的读者，也适合那些已经被WVP折磨过想找一份完整参考的人。

1. 项目整体架构与部署思路拆解

1.1 wvp-GB28181-pro的技术组成

在动手部署之前，先把wvp-GB28181-pro这套系统的组成搞清楚，后面排错会省很多事。wvp-GB28181-pro不是一个单体应用，它由三个核心部分组成：

wvp后端服务：Java Spring Boot项目，负责GB28181协议中的SIP信令处理、设备注册认证、目录查询、云台控制、录像计划等业务逻辑。它是整个系统的“大脑”。
ZLMediaKit流媒体服务：C++编写的高性能流媒体服务器，负责接收摄像头推上来的RTP流，转封装成RTSP、RTMP、HLS、WebRTC等协议，供播放端拉流。它是系统的“血管”。
wvp前端管理界面：Vue编写，提供设备管理、实时预览、录像回放、平台级联等操作的图形化界面。它是系统的“脸面”。

这三个部分，wvp后端和前端是独立镜像，ZLMediaKit又分成了带WebRTC功能的版本和不带WebRTC的版本。我第一次部署时就是没搞清楚这几个组件的分工，导致出了问题不知道去查哪个服务，走了很多弯路。

1.2 为什么选择Docker方式部署

官方文档提供两种部署方式，源码编译和Docker部署。源码编译这条路我试过一次，说实话体验很差。后端需要JDK8以上、Maven 3.6以上，前端需要Node 14以上，ZLMediaKit还需要自己编译依赖。光是把这些环境在服务器上配齐，就得消耗半天时间。更坑的是，ZLMediaKit编译过程中经常因为依赖库版本问题报错，网上搜的解决方案五花八门，试了一大堆才能编译通过。

Docker方式就优雅多了。官方在Docker Hub上维护了wvp-pro和ZLMediaKit的镜像，拉下来就是完整的运行环境，不污染宿主机。升级也方便，旧容器删掉重新拉新镜像跑就行。对于生产环境部署来说，Docker的隔离性也更好，即使wvp被攻击了，宿主机受到的波及也有限。

我在实际部署中采用的方案是：Docker部署wvp后端 + Docker部署ZLMediaKit + Docker部署数据库和缓存 + 前端镜像或者Nginx托管静态文件。这个方案把每个组件拆成独立容器，互不干扰，排错时也能定位得更准确。

1.3 部署前的网络与端口规划

这一步很多人会忽略，但恰恰是最关键的。GB28181协议涉及到的端口非常多，而且承载不同职责，规划不好后面接入摄像头必出问题。我梳理了一下，wvp整套系统需要用到以下端口：

端口	服务	协议	用途
5060	wvp后端	UDP/TCP	SIP信令传输，摄像头注册、心跳、指令下发都走这里
8080	wvp后端	TCP	后端API接口，前端界面调用
8443	wvp后端	TCP	HTTPS接口，WebRTC播放信令交互
10000-20000	ZLMediaKit	UDP/TCP	RTP媒体流接收，摄像头推流占用
1935	ZLMediaKit	TCP	RTMP拉流（若需要）
9999	ZLMediaKit	TCP	HTTP-FLV拉流（若需要）
8000	ZLMediaKit	TCP	WebRTC拉流信令端口，新版是UDP 8000
30000-30500	ZLMediaKit	UDP	WebRTC媒体端口范围（新版配置）

如果你是部署在云服务器上，这些端口都要在安全组里放行。如果是内网部署，防火墙也要对应开通。我第一次就是在云服务器上只放行了8080和5060，结果摄像头注册上了但播放不了，排查了半天才发现是媒体端口没放行。

提示：如果摄像头和海康、大华等NVR对接，还要注意GB28181的SIP端口在摄像头侧是可以自定义的，要和wvp里配置的SIP端口保持一致，否则设备侧会显示注册失败。

需要模型API调用？免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。

2. Docker环境准备与镜像选型

2.1 Docker环境安装与加速配置

Docker环境是部署的前提，这一步要确保没有问题。我用的是Ubuntu 20.04服务器，安装命令很简单：

bash复制sudo apt update
sudo apt install -y apt-transport-https ca-certificates curl software-properties-common
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io
sudo systemctl enable docker
sudo systemctl start docker

安装完验证一下：docker --version，能输出版本号就说明装好了。另外推荐装一下docker-compose，后面管理多容器会方便很多：

bash复制sudo apt install -y docker-compose-plugin

有一点要特别提醒，Docker镜像拉取速度在国内经常慢到怀疑人生。wvp-pro镜像大概300多MB，ZLMediaKit镜像也有100多MB，如果直连官方仓库搞不好要一两个小时。建议配置镜像加速器。修改/etc/docker/daemon.json，填入加速地址：

json复制{
  "registry-mirrors": ["https://docker.m.daocloud.io"]
}

改完执行sudo systemctl restart docker。这一步能让你少等很久。

2.2 镜像选择与版本注意事项

wvp-GB28181-pro官方Docker Hub上的镜像有两个仓库，一个是648540858/wvp_pro，一个是648540858/wvp_pro_web。分别是后端和前端。ZLMediaKit的镜像是648540858/zlm。这里有个重要细节，ZLM镜像分带WebRTC和不带WebRTC两个tag。如果你不需要浏览器WebRTC低延迟播放，用普通tag就行，镜像体积小一些。如果要用WebRTC，必须拉带webrtc的版本。

我当时是需要WebRTC播放的，所以拉的是带webrtc的tag。命令如下：

bash复制docker pull 648540858/wvp_pro:latest
docker pull 648540858/wvp_pro_web:latest
docker pull 648540858/zlm:latest

还有一个思路，就是直接用官方提供的docker-compose.yml一键启动全套。官方仓库里的docker-compose.yml包含了mysql、redis、wvp后端、zlm、前端五个服务，理论上执行docker-compose up -d就能全部跑起来。但实际用下来，官方compose里的配置不够灵活，数据库密码、端口映射都需要调整，我最后还是选择了手动逐个部署，这样每个组件的情况都心里有数。

另外，我建议在部署wvp之前，单独把MySQL和Redis准备好。MySQL用来存设备信息、录像计划、平台配置这些结构化数据，Redis用来缓存目录树、在线状态等实时数据。wvp后端启动时强依赖这两个中间件，不通的话程序直接启动失败。MySQL我用的是5.7，Redis用的6.x，这两个版本是官方推荐且测试最充分的。

3. 数据库准备与核心配置详解

3.1 MySQL初始化与数据库创建

wvp后端启动前需要有一个空数据库，表结构不需要手动建，wvp第一次启动时会自动建表。我不建议用root账号直接连，规范一点，先创建专用数据库和账号。我用的MySQL是Docker方式启动的：

bash复制docker run -d \
  --name mysql-wvp \
  -p 3306:3306 \
  -e MYSQL_ROOT_PASSWORD=admin123 \
  -e MYSQL_DATABASE=wvp \
  -v /home/mysql/data:/var/lib/mysql \
  mysql:5.7 \
  --character-set-server=utf8mb4 \
  --collation-server=utf8mb4_unicode_ci

这里解释几个参数：MYSQL_DATABASE=wvp会创建名为wvp的库，character-set-server=utf8mb4指定字符集，避免中文设备名显示乱码。-v /home/mysql/data把数据目录挂载到宿主机，容器删了数据还在。启动完成后可以验证一下：

bash复制docker exec -it mysql-wvp mysql -uroot -padmin123 -e "show databases;"

能看到wvp库就说明初始化完成。这一步如果只想快速验证，可以稍微简化，直接复用wvp自带的mysql容器，但生产环境我还是建议独立部署数据库，方便备份和扩容。

3.2 Redis安装与配置要点

Redis在wvp中的作用主要是缓存设备目录树、状态信息和一些临时数据。配置比较简单，同样是Docker方式启动：

bash复制docker run -d \
  --name redis-wvp \
  -p 6379:6379 \
  -v /home/redis/data:/data \
  redis:6 \
  redis-server --appendonly yes \
  --requirepass 123456

这里我加了--appendonly yes开启持久化，避免重启丢数据。--requirepass 123456设置了密码，wvp配置文件里要对应填上。如果你图省事不想设密码，也可以去掉这个参数，但生产环境我强烈建议设置密码，避免Redis被扫描攻击。

Redis装好后，用docker exec -it redis-wvp redis-cli -a 123456 ping验证，返回PONG就说明正常。这里有个小细节，Redis的requirepass配置和wvp后端application.yml里的密码必须完全一致，否则启动时后端会报Unable to connect to Redis错误，这个我后面还会详细讲。

3.3 wvp后端application.yml配置深度解析

wvp后端的配置集中在application.yml文件里，Docker部署时通过挂载配置文件的方式传给容器。这个文件是整套部署的核心，里面的每一项配置都直接影响系统的正常运行。我是从官方仓库把配置文件下载下来，然后逐项修改的。

配置文件下载方式：

bash复制wget https://gitee.com/648540858/wvp-GB28181-pro/raw/master/src/main/resources/application.yml

拿到配置后，重点要改以下几个地方：

yaml复制server:
  port: 8080

spring:
  datasource:
    url: jdbc:mysql://127.0.0.1:3306/wvp?useUnicode=true&characterEncoding=UTF8&useSSL=false&serverTimezone=Asia/Shanghai
    username: root
    password: admin123
  redis:
    host: 127.0.0.1
    port: 6379
    password: 123456
    database: 0

sip:
  ip: 192.168.1.100
  port: 5060
  domain: 3402000000
  id: 34020000002000000001
  password: 12345678

media:
  ip: 192.168.1.100
  port: 10000
  secret: 035c73f7-bb6b-4889-a715-d9eb2d1925cc
  rtp:
    enable: true
    port-range: 10000,20000

一个个解释：

spring.datasource.url：数据库连接地址。Docker部署时，如果wvp容器和mysql容器在同一台机器，这里127.0.0.1是可以用的，因为设置了--network host模式。如果是docker-compose的网络模式，这里要填mysql容器名。
sip.ip：这里务必填服务器对外网卡的IP，不能填localhost或127.0.0.1。摄像头注册时连接的就是这个IP。
sip.port：SIP服务监听端口，默认5060，除非有冲突，否则不要改。
sip.domain和sip.id：GB28181中SIP服务器ID，默认是3402000000和34020000002000000001，这是国标规定的省级编码规则，摄像头侧的SIP服务器ID也要填这个。
sip.password：SIP服务器认证密码，摄像头注册时要用到。
media.ip：ZLMediaKit服务器的IP，和sip.ip一般是同一个服务器。
media.port：ZLMediaKit的HTTP端口，默认10000，这个要和ZLM的配置文件对应。
media.secret：wvp后端和ZLMediaKit之间的通信密钥，ZLM里也要配置成一样的。
media.rtp.port-range：接收RTP流使用的端口范围。这里要特别注意，后面ZLM配置里也要有对应的端口范围。

注意：sip.id默认是34020000002000000001，这在国标里代表省级平台SIP服务器编码，很多摄像头默认的SIP服务器ID也是这个，所以一般不用改。但如果你有多个平台级联，这里就需要改成符合规范的独立编码。

3.4 ZLMediaKit配置要点与secret对齐

ZLMediaKit的配置是一个config.ini文件。Docker方式部署时，可以先把镜像跑起来再拷贝配置文件出来改。我先创建配置目录：

bash复制mkdir -p /home/zlm/config
cp /home/config.ini /home/zlm/config/

实际上ZLM镜像里面自带一份默认配置，可以先创建容器，再用docker cp拷贝出来。直接改宿主机上的配置文件再挂载进去更可控。ZLM配置里要改的核心参数：

ini复制[api]
apiDebug=1
secret=035c73f7-bb6b-4889-a715-d9eb2d1925cc

[rtp_proxy]
port=10000
timeoutSec=15

[rtc]
port=8000
externIP=192.168.1.100
timeoutSec=15

这里secret必须和wvp后端application.yml里的media.secret一致。externIP填服务器公网IP或者能被设备访问到的内网IP，WebRTC播放时媒体协商会用到这个IP。port-range在ZLM里是通过[rtp_proxy]下port_range配置的，不过我用的版本是在wvp配置里控制的，ZLM配置文件里也有一份同样的端口范围配置，要看哪个版本而定的，不少老版本没这个选项。

有一个问题我印象很深，就是wvp和ZLM之间的交互端口默认监听在所有网卡上，如果服务器有多个IP，ZLM可能绑定错IP导致信令正常但媒体流不通。解决办法是在[rtp_proxy]里设置listen_ip=0.0.0.0，并确保externIP填正确的外网或局域网访问地址。

4. 容器启动顺序与完整部署实操

4.1 先启动MySQL和Redis

这一步其实是前面已经做过的，但我要强调一下顺序：必须先把MySQL和Redis跑起来，再启动wvp后端。wvp后端启动时会检查数据库和缓存连接，连不上就启动失败，而且不会自动重试。

启动完后，用docker ps查看容器状态，确保两个容器都在Up状态。如果mysql启动后一直在Restarting，大概率是字符集参数写错了或者数据目录权限不对，查看日志docker logs mysql-wvp能定位问题。

4.2 启动ZLMediaKit容器

ZLM镜像启动命令：

bash复制docker run -d \
  --name zlm \
  --network host \
  -v /home/zlm/config:/opt/media/conf \
  648540858/zlm:latest

这里我用了--network host模式，让ZLM直接使用宿主机网络，好处是端口不用一个个映射，UDP端口范围也能完整暴露给摄像头推流。如果不用host模式，要么手动映射10000-20000这一大段UDP端口，要么就用-p 10000-20000:10000-20000/udp这种批量映射，但性能和稳定性都不如host模式。

启动后验证一下ZLM的HTTP接口是否正常：

bash复制curl http://127.0.0.1:10000/index/api/getServerConfig

能返回一段JSON，说明ZLM已经正常启动，并且secret配置正确。

4.3 启动wvp后端容器

wvp后端启动命令：

bash复制docker run -d \
  --name wvp-pro \
  --network host \
  -v /home/wvp/application.yml:/root/application.yml \
  648540858/wvp_pro:latest

后端启动时有个特点，第一次启动会自动初始化数据库表结构，耗时可能在几十秒到几分钟不等。启动后要看日志：

bash复制docker logs -f wvp-pro

看到类似Started WvpApplication in 42.251 seconds这样的日志，说明启动成功。如果日志里出现Failed to configure a DataSource，说明数据库连不上；出现Unable to connect to Redis，说明Redis配置有问题。这些都可以提前在配置检查阶段规避掉。

4.4 启动前端镜像

前端是一个Nginx托管的静态页面，启动命令：

bash复制docker run -d \
  --name wvp-web \
  -p 8081:80 \
  648540858/wvp_pro_web:latest

前端默认通过8081端口访问。但要注意，默认前端页面里配置的后端接口地址是http://localhost:8080，如果你是通过IP访问的，需要修改前端配置。官方前端镜像的配置在/usr/share/nginx/html/static/config.js或类似位置，需要先把文件拷出来改完再挂载进去。

bash复制docker cp wvp-web:/usr/share/nginx/html/static/config.js /home/wvp/config.js

修改config.js里的VUE_APP_SERVER_ADDR为你的后端接口地址，然后重新挂载启动。

启动完成后，浏览器访问http://服务器IP:8081，能看到登录页面就说明前端没问题。默认账号密码是admin/admin，登录后第一件事就是改密码，这个不用多说了。

4.5 容器启动顺序总结

我整理了一个启动顺序表，后面部署直接照着来就行：

步骤	操作	验证方式
1	启动MySQL	`docker ps` 查看状态为Up
2	启动Redis	`docker exec -it redis-wvp redis-cli ping` 返回PONG
3	启动ZLMediaKit	`curl http://127.0.0.1:10000/index/api/getServerConfig`
4	启动wvp后端	`docker logs -f wvp-pro` 出现Started日志
5	启动wvp前端	浏览器访问登录页

这个顺序不是绝对的，但按这个来可以让问题暴露得最清晰。如果你用docker-compose，官方会通过depends_on来控制顺序，不过我实测下来还是手动一个个启动更可控，因为每个服务我都要检查日志确认正常了才进行下一步。

5. 摄像头接入与功能验证

5.1 国标摄像头侧配置

环境搭起来了，接下来就是接入真实摄像头。以海康威视摄像头为例，进入摄像头的Web管理界面，找到“网络管理-高级设置-平台接入”或类似菜单，选择协议类型为GB28181，填写以下参数：

SIP服务器ID：填sip.id，默认34020000002000000001
SIP服务器域名：填sip.domain，默认3402000000
SIP服务器地址：填服务器IP
SIP服务器端口：填5060
SIP用户认证ID：填摄像头的国标编码，比如34020000001320000001
SIP用户认证密码：填wvp里设置的用户密码，注意和注册密码不是一个概念，这里不是填sip.password，而是wvp后台添加设备时设置的密码
通道编码：每路摄像头有独立的通道编码，也是20位数字

这里有个坑我必须说一下，wvp后台添加设备时，需要在“设备管理-添加设备”里填设备国标编号和密码，这个密码是wvp后台自己设置的，和摄像头侧的SIP用户认证密码要一致，但不需要和sip.password一样。很多人在这里搞混，导致设备注册时认证失败。

5.2 注册状态查看与常见接入问题

摄像头配置保存后，正常情况下几秒内就能在wvp后台“设备管理”页面看到设备上线。如果状态一直显示“离线”，需要从几个角度排查：

首先检查wvp日志里有没有SIP注册请求过来，命令是docker logs wvp-pro | grep 340200。如果日志里能看到register相关的消息，说明信令通了，问题可能出在认证或编码上。如果日志里什么都看不到，说明SIP包根本没到达wvp，这时要看防火墙和安全组有没有放行UDP 5060端口，以及摄像头和服务器之间网络是否互通。

另一个常见问题是，设备注册成功了但拉流失败。这时看wvp日志，通常会提示onRtspRealm错误或者ZLM连接失败，多半是media.port和secret不匹配，ZLM那边收不到wvp下发的推流指令。

5.3 实时预览与WebRTC播放验证

设备在线后，在wvp后台点击“播放”按钮，如果一切正常，浏览器会通过WebRTC拉起实时画面，延迟大概在几百毫秒内。如果点击播放提示失败，可以先试试用VLC拉RTSP流：

code复制rtsp://192.168.1.100:554/rtp/34020000001320000001

RTSP能播放而WebRTC不能，说明媒体链路正常，问题出在WebRTC的媒体协商上。WebRTC播放时，ZLM会通过externIP和rtc.port向浏览器提供媒体地址，如果externIP填的不是浏览器能访问到的IP，媒体包就传不过去。这个排查思路我建议新手记下来，80%以上的拉流问题都能通过这个方式定位。

5.4 语音对讲功能测试

语音对讲是个高频需求，很多安防项目都会用到。wvp的语音对讲流程是：前端采集麦克风音频，通过WebRTC推给ZLM，ZLM再转成GB28181的音频流发给摄像头。测试步骤比较简单，在播放页面点击“对讲”按钮，然后对着麦克风说话，摄像头端应该能听到声音。

实际使用中我对接过几次，碰到最多的问题是摄像头对讲没有声音，原因大多是以下几种：

摄像头音频编码格式不匹配。GB28181对音频编码有规定，摄像头和海康等品牌一般支持G.711A或G.711U，如果wvp侧音频编码不是G.711，摄像头就解不了码。
摄像头需要开启“音频”开关。部分摄像头默认视频流不携带音频，需要在编码设置里把音频编码打开。
WebRTC对讲经过公网时，UDP的8000端口和30000-30500的媒体端口要放行，不然音频数据传不到ZLM。

我从实际项目中得到的经验是，语音对讲能否成功，和摄像头的实现对GB28181语音规范的支持程度关系很大。如果摄像头固件对讲支持不完整，wvp这边配置再对也白搭。这种情况可以先在wvp后台的“语音对讲”里换音频编码，或者升级摄像头固件。

6. 常见问题与排查技巧实录

6.1 设备注册不上、注册请求超时

这是GB28181对接中最常见的问题，没有之一。设备侧显示注册超时，wvp后台设备列表为空。我总结了排查顺序：

确认服务器防火墙是否放行UDP/TCP 5060端口。很多云服务器默认安全组只放行TCP，UDP端口没开。
确认wvp后端sip.port配置正确。可以用netstat -lunp | grep 5060看看端口是否在监听。
用抓包工具确认SIP报文是否到达服务器。没有图形界面的服务器可以用tcpdump -i any udp port 5060抓包，能看到摄像头IP发来的数据包就说明网络是通的。
确认摄像头侧SIP服务器ID和域名配置正确。这两项填错，wvp会直接拒绝注册。

提示：很多时候设备注册超时，问题不在wvp，而在摄像头侧配置。常见的就是SIP服务器ID和域名的概念搞混，或者摄像头通道编号超出20位导致注册消息不合法。

6.2 Docker映射端口导致媒体流不通

这个问题也很典型。我见过不少朋友用-p做端口映射的方式跑ZLM，结果信令通了，媒体流就是拉不起来。原因在于，GB28181推流使用UDP的时候，摄像头往wvp的媒体端口发RTP包，如果只映射了10000-20000的一部分端口，或者使用NAT后的不同端口，ZLM收到的RTP校验不通过，媒体链路就断了。

我的建议是：能host模式就host模式。Docker的host模式性能更好，也没有端口映射带来的地址转换问题。如果出于网络隔离考虑不能用host，那就必须把ZLM配置里的[rtp_proxy]和[rtc]的端口段完整映射出来，而且在wvp配置里填写的media.ip必须是摄像头能访问到的映射后地址。

6.3 WebRTC播放黑屏或无法建立连接

WebRTC现在很多项目都在用，因为延迟确实低，浏览器免插件。但部署中WebRTC问题最隐蔽，报错信息也不友好。常见症状是：点击播放后，画面一直转圈或直接黑屏，控制台报Load failed或者ICE failed。

排查时先确认ZLM是否带WebRTC功能，很多不带webrtc tag的ZLM镜像根本没有RTC模块，前端一拉流就会失败。确认镜像没问题后，再查externIP，这个必须填浏览器能访问到的IP，如果是云服务器就填公网IP，如果是内网就填内网IP。最后看UDP 8000端口和UDP 30000-30500端口段是否放行。WebRTC的媒体传输走的是UDP，防火墙卡住就一条流都拉不起来。

6.4 平台级联时的编码与域配置

如果项目涉及多个平台级联，比如市级平台对接省级平台，wvp的sip.id、sip.domain、device.id等配置必须按照国标要求设置。不同行政区域的编码前缀不同，千万别照抄默认值。平台级联时还要在wvp后台配置“国标级联”模块，输入上级平台的SIP服务器地址、端口和认证信息。

级联的调试难度比设备接入高一个量级，我建议先把单设备接入彻底调通，再来弄级联。否则设备和平台两个层面的问题叠加在一起，排错会非常痛苦。

7. 生产环境部署的几点补充建议

7.1 把数据卷挂载完整，防容器丢失

Docker容器是“一次性的”，容器删了数据就没了。我在第一次部署时吃了这个亏，数据库和配置没有挂载宿主机路径，容器升级时整个环境的数据全丢了，设备列表、录像计划全部初始化。后面的任何部署，我都会把mysql数据目录、redis数据目录、wvp配置文件、ZLM配置文件全部挂载到宿主机固定路径。这样即使容器没了，重建也很快。

7.2 配置自动启动与进程守护

传统Docker方式部署的服务，服务器重启后需要手动启动容器，很麻烦。生产环境建议在docker run时加上--restart=always参数，这样Docker守护进程会保证容器随宿主机启动而自动拉起。如果用了docker-compose，也可以在service配置里加restart: always。

我的部署经验是，--restart=always还有一层好处：如果某个服务因异常退出，Docker会自动尝试重启它，降低了人工介入的频率。不过要注意，有些服务频繁崩溃后Restarting状态会持续很久，还得靠日志定位问题。

7.3 定期备份MySQL数据库

wvp里最核心的数据就是设备列表、录像计划、平台配置，这些都在MySQL里。生产环境的数据备份是必须的，我习惯每天凌晨用crontab执行一次mysqldump，把备份文件存放到独立目录，保留最近7天。命令大概是：

bash复制0 2 * * * /usr/bin/docker exec mysql-wvp mysqldump -uroot -padmin123 wvp > /backup/wvp_$(date +%Y%m%d).sql

Redis里的缓存数据丢了影响不大，最多是设备在线状态重新上报，MySQL备份了基本就稳了。

8. 部署完成后的验证清单与后续扩展

8.1 全流程验证清单

部署完成后，建议按下面的清单完整走一遍，确认系统没有隐藏问题：

[ ] 设备能正常注册上线，状态保持在线
[ ] 实时预览能正常播放，画面流畅
[ ] WebRTC播放延迟在合理范围内
[ ] 云台控制指令能正常下发
[ ] 语音对讲双向通话正常
[ ] 录像回放能正常查询和播放
[ ] 服务器重启后所有容器自动恢复

这个清单看起来简单，但每一步背后都可能有一个或多个配置坑。我当时光是语音对讲就调了半天，最后发现是摄像头音频编码格式不支持G.711U，换成G.711A才搞定。

8.2 进一步扩展：接入AI分析或告警联动

wvp-GB28181-pro部署稳定之后，可以做的事情其实很多。比如把视频流接到AI分析平台做人脸识别、行为分析，或者通过wvp的告警回调接口对接自己的业务系统。wvp提供了相对完善的后端API，大致可以实现设备管理、录像查询、云台控制、告警上报等能力的二次开发，前面加一层业务网关就行。

我认识的一些朋友还把wvp和Node-RED或Home Assistant做了联动，把摄像头AI事件推送到了企业微信或钉钉群，园区安防场景下的实用价值挺高的。

这个项目整体部署下来，我的体会是：Docker方式确实大大降低了wvp-GB28181-pro的上手门槛，但GB28181协议本身的复杂性是绕不开的。信令流程、媒体协商、端口管理、编码规范，任何一个环节不熟悉，排查起来都会很耗时。建议新手务必要把官方Wiki通读一遍，然后再结合我这份实践经验动手部署。最后再分享一个小技巧，部署时如果某个环节卡住，第一时间去docker logs看日志，比在群里问别人快得多。日志里的报错信息其实已经告诉了你90%的答案，关键是愿不愿意逐行去看、去理解。