保姆级教程：用Docker Compose一键部署WVP-PRO和ZLMediaKit（2025最新镜像）
2025容器化部署指南：Docker Compose整合WVP-PRO与ZLMediaKit全栈方案
在视频监控与流媒体服务领域，WVP-PRO和ZLMediaKit的组合已成为GB28181协议落地的黄金搭档。传统部署方式需要逐个安装依赖、配置环境，耗时且容易产生版本冲突。本文将展示如何通过Docker Compose实现一键部署全栈服务，包含MySQL 8.0、Redis、ZLMediaKit（WebRTC支持）和WVP-PRO应用，整个过程仅需10分钟。
1. 环境准备与架构设计
1.1 容器化方案优势
相比传统部署，容器化方案具有三大核心优势：
- 环境隔离：每个服务运行在独立容器中，避免依赖冲突
- 快速部署：镜像已包含所有编译好的组件，无需手动编译
- 版本控制：通过镜像tag锁定版本，升级/回滚更安全
架构拓扑如下图所示：
[公网访问] ←→ [Nginx] ←→ [WVP-PRO] ←→ [ZLMediaKit] ↑ ↑ [Redis] [MySQL]1.2 硬件需求建议
| 组件 | 最低配置 | 生产环境推荐 |
|---|---|---|
| CPU | 4核 | 8核+ |
| 内存 | 8GB | 16GB+ |
| 存储 | 50GB | 500GB+ |
| 网络带宽 | 10Mbps | 100Mbps+ |
提示：媒体流存储建议挂载SSD硬盘，IOPS要求≥3000
2. 容器部署实战
2.1 编写docker-compose.yml
创建部署目录并编写编排文件：
mkdir wvp-pro-docker && cd wvp-pro-docker vim docker-compose.yml完整配置示例：
version: '3.8' services: mysql: image: mysql:8.0 container_name: wvp-mysql environment: MYSQL_ROOT_PASSWORD: ${DB_ROOT_PWD} MYSQL_DATABASE: wvp_pro volumes: - mysql_data:/var/lib/mysql - ./config/mysql/my.cnf:/etc/mysql/conf.d/my.cnf ports: - "3306:3306" restart: unless-stopped redis: image: redis:6-alpine container_name: wvp-redis command: redis-server --requirepass ${REDIS_PWD} volumes: - redis_data:/data ports: - "6379:6379" restart: unless-stopped zlmediakit: image: zlmediakit/zlmediakit:webrtc-2025 container_name: zlmediakit volumes: - ./media:/media - ./config/zlm/config.ini:/etc/zlm/config.ini ports: - "1935:1935" # RTMP - "554:554" # RTSP - "10000-10050:10000-10050/udp" # RTP - "30000-30050:30000-30050/udp" # WebRTC environment: TZ: Asia/Shanghai restart: unless-stopped wvp-pro: image: wvp-pro/wvp-pro:2025 container_name: wvp-pro depends_on: - mysql - redis - zlmediakit volumes: - ./config/wvp/application.yml:/app/config/application.yml ports: - "18080:18080" restart: unless-stopped volumes: mysql_data: redis_data:2.2 关键配置说明
环境变量文件(.env)：
DB_ROOT_PWD=YourStrong@Password123 REDIS_PWD=Redis@789ZLMediaKit配置：
[http] port=80 [rtsp] port=554 [rtmp] port=1935 [webrtc] port=30000WVP-PRO数据库配置：
spring: datasource: url: jdbc:mysql://mysql:3306/wvp_pro?useSSL=false username: root password: ${DB_ROOT_PWD}
3. 服务启停与管理
3.1 一键启动所有服务
docker-compose up -d启动后验证服务状态：
docker-compose ps预期输出：
NAME COMMAND SERVICE STATUS PORTS wvp-mysql "docker-entrypoint.s…" mysql running 0.0.0.0:3306->3306/tcp wvp-redis "docker-entrypoint.s…" redis running 0.0.0.0:6379->6379/tcp zlmediakit "/usr/local/bin/Medi…" zlmediakit running 0.0.0.0:554->554/tcp, 0.0.0.0:1935->1935/tcp wvp-pro "java -jar /app/wvp-…" wvp-pro running 0.0.0.0:18080->18080/tcp3.2 常用运维命令
查看实时日志：
docker-compose logs -f zlmediakit重启单个服务：
docker-compose restart wvp-pro停止所有服务：
docker-compose down备份数据库：
docker exec wvp-mysql mysqldump -uroot -p${DB_ROOT_PWD} wvp_pro > backup.sql
4. 高级配置与优化
4.1 性能调优参数
在docker-compose.yml中添加资源限制：
zlmediakit: deploy: resources: limits: cpus: '4' memory: 8G reservations: cpus: '1' memory: 2G4.2 媒体存储方案
推荐使用独立卷存储媒体文件：
volumes: media_volume: driver_opts: type: none device: /mnt/ssd/media o: bind4.3 安全加固措施
修改默认端口：
wvp-pro: ports: - "28080:18080"启用HTTPS：
server { listen 443 ssl; ssl_certificate /etc/nginx/ssl/wvp.crt; ssl_certificate_key /etc/nginx/ssl/wvp.key; location / { proxy_pass http://wvp-pro:18080; } }防火墙规则：
ufw allow 28080/tcp ufw allow 1935/tcp
5. 故障排查与升级
5.1 常见问题解决
容器启动失败：
docker inspect --format='{{.State.Error}}' zlmediakit数据库连接问题：
docker exec -it wvp-mysql mysql -uroot -p > SHOW GRANTS FOR 'root'@'%';媒体流无法播放：
docker exec zlmediakit tail -f /var/log/zlm.log
5.2 版本升级流程
拉取新版本镜像：
docker-compose pull滚动重启服务：
docker-compose up -d --no-deps zlmediakit验证兼容性：
curl http://localhost:18080/api/v1/version
实际部署中发现，2025版镜像对H.265编码的支持更加完善，WebRTC延迟从800ms降低到300ms以内。通过容器化部署，整个系统迁移到新服务器只需复制docker-compose.yml和卷数据，真正实现了"一次配置，随处运行"。