Spring Boot + Vue + ZLMediaKit 实现 RTSP 拉流播放的完整方案
以下是基于 Spring Boot + Vue + ZLMediaKit 实现 RTSP 拉流播放的完整方案，包含架构设计、关键代码和注意事项：
一、系统架构设计
scss
复制代码
graph TD
A[摄像头/RTSP源] -->|RTSP协议| B(Spring Boot 后端)
B -->|RTMP/HTTP-FLV协议| C(ZLMediaKit流媒体服务器)
C -->|HLS/HTTP-FLV协议| D(Vue前端播放器)
后端层：Spring Boot 负责接收 RTSP 流并推送到 ZLMediaKit
流媒体层：ZLMediaKit 完成协议转换和流分发
前端层：Vue 通过播放器库渲染视频流
二、环境准备
ZLMediaKit 部署
bash
复制代码
# Docker 部署（推荐）
docker run -d --name zlmediakit \
-p 1935:1935 \ # RTMP
-p 8080:80 \ # HTTP
-p 554:554 \ # RTSP
-v /opt/media:/opt/media \
zlmediakit/zlmediakit:master
Spring Boot 项目依赖
xml
复制代码
三、核心实现步骤
1. 后端流媒体服务配置（Spring Boot）
yaml
复制代码
# application.yml
zlm:
api:
url: http://localhost:9092 # ZLMediaKit管理地址
secret: your_secret_key # 流媒体鉴权密钥
media:
ip: 0.0.0.0 # 监听所有IP
rtsp-port: 554 # RTSP服务端口
rtmp-port: 1935 # RTMP服务端口
2. RTSP 流推送服务
less
复制代码
@RestController
public class StreamController {
@Autowired
private ZLMediaKitService zlmService;
// 添加流代理
@PostMapping("/addStreamProxy")
public ResponseEntity
String url = String.format("http://%s:%d/index/api/addStreamProxy?"
+ "vhost=%s&app=live&stream=%s&url=%s&secret=%s",
zlmService.getZlmIp(), zlmService.getZlmPort(),
request.getVhost(), request.getApp(), request.getStreamId(),
URLEncoder.encode(request.getRtspUrl(), StandardCharsets.UTF_8),
zlmService.getZlmSecret());
// 调用 ZLMediaKit API
String response = zlmService.executeCommand(url);
return ResponseEntity.ok(response);
}
}
3. 数据库设计（MySQL）
sql
复制代码
CREATE TABLE stream_config (
id BIGINT PRIMARY KEY AUTO_INCREMENT,
camera_name VARCHAR(255) COMMENT '摄像头名称',
rtsp_url VARCHAR(512) NOT NULL COMMENT 'RTSP地址',
stream_id VARCHAR(64) UNIQUE COMMENT '流ID',
status TINYINT DEFAULT 0 COMMENT '流状态'
);
四、前端播放实现（Vue）
1. 播放器组件
xml
复制代码
2. 流地址获取接口
ini
复制代码
// 获取流地址接口示例
axios.get('/api/stream/info', { params: { cameraId: 1 } })
.then(response => {
const flvUrl = `http://${response.data.ip}:${response.data.port}/${response.data.app}/${response.data.stream}.flv`;
this.playStream(flvUrl);
});
五、关键配置说明
ZLMediaKit 转码配置
ini
复制代码
# config.ini
[ffmpeg]
cmd=ffmpeg -re -i %s -c:v libx264 -preset ultrafast -tune zerolatency -f flv %s
Spring Boot 控制台日志
ini
复制代码
logging.level.com.lunasaw.zlm=DEBUG
六、常见问题解决方案
问题现象
解决方案
流无法推送
检查 ZLMediaKit 控制台是否开启 RTSP 服务，确认防火墙端口开放
播放卡顿
调整 FFmpeg 转码参数，增加 -b:v 2000k 提升码率
音视频不同步
添加 -vsync 1 -async 1 参数优化同步
多路流管理
使用 ZLMediaKit 的流组功能进行批量管理
七、性能优化建议
硬件加速：启用 GPU 编码（如 NVIDIA NVENC）
集群部署：通过 ZLMediaKit 的集群模式实现负载均衡
缓存策略：使用 Redis 缓存流元数据，减少数据库查询
CDN 分发：对 HLS 流启用 CDN 加速
八、扩展功能实现
流状态监控
kotlin
复制代码
@ZlmHook
public class StreamMonitor {
@Override
public Response streamStarted(StreamInfo info) {
// 记录流启动日志
return super.streamStarted(info);
}
}
动态码率切换
javascript
复制代码
// 前端切换码率示例
const hls = new Hls();
hls.loadSource('http://example.com/stream.m3u8');
hls.on(Hls.Events.LEVEL_SWITCHED, (event, data) => {
console.log('当前码率:', data.level);
});
通过上述方案，可以实现完整的 RTSP 拉流播放系统。建议先通过 Docker 快速部署 ZLMediaKit，再逐步集成 Spring Boot 业务逻辑。实际开发中需注意网络传输优化和异常处理机制。
亲身经历告诉你跟谁学英语sam老师网课怎么样?真实体验爆料！新三国杀必升武将说明 五阶武将推荐