danielwinkler/rtsp2yolo

rtsp2yolo

镜像概述

rtsp2yolo 是一个用于实时视频流分析的 Docker 镜像。它的核心功能是从指定的 RTSP 视频流中持续拉取图像帧，将其发送至 YOLO 目标检测服务进行推理，并将最终的检测结果推送到 RabbitMQ 消息代理的指定交换机中，实现视频数据的结构化与事件分发。

核心功能与特性

• RTSP 流处理：自动连接并稳定拉取 RTSP 视频流中的图像帧。
• YOLO 目标检测集成：与外部 YOLO 服务无缝对接，实现高效的图像目标识别。
• 消息队列分发：将检测到的目标事件推送到 RabbitMQ 交换机，便于下游系统异步订阅和处理。
• 灵活配置：完全通过环境变量进行参数配置，易于在不同环境和编排工具中部署。

使用场景和适用范围

• 智能安防监控与异常事件实时报警。
• 工业流水线产品缺陷检测与数据上报。
• 智慧交通中的车辆/行人流量统计与事件分发。
• 任何需要将视频流 AI 分析结果接入消息中间件的物联网（IoT）或边缘计算场景。

前置依赖

本镜像强依赖于外部的 YOLO 目标检测服务。在运行此镜像前，请确保已部署并可访问 https://github.com/johannestang/yolo_service%E3%80%82%E5%90%8C%E6%97%B6%EF%BC%8C%E9%9C%80%E8%A6%81%E4%B8%80%E4%B8%AA%E8%BF%90%E8%A1%8C%E4%B8%AD%E7%9A%84 RabbitMQ 实例作为消息代理。

环境变量配置说明

本服务通过环境变量进行配置，详细参数说明如下：

部署示例

使用 Docker Compose 部署（推荐）

以下是使用 docker-compose.yml 部署的示例配置：

yaml
version: '3.8'

services:
  rtsp2yolo:
    image: rtsp2yolo:latest
    container_name: rtsp2yolo
    environment:
      - RTSP_ENDPOINT=rtsp://admin:password@192.168.1.100:554/stream1
      - YOLO_HOST=yolo_service_host
      - YOLO_PORT=8080
      - MESSAGE_BROKER_HOST=rabbitmq_host
      - MESSAGE_BROKER_EXCHANGE_NAME=observed_cam_events
    restart: unless-stopped
    # 确保该容器能够访问 YOLO 服务和 RabbitMQ 的网络

使用 Docker Run 部署

如果您倾向于使用命令行直接运行，可以使用以下 docker run 命令：

bash
docker run -d \
  --name rtsp2yolo \
  -e RTSP_ENDPOINT="rtsp://admin:password@192.168.1.100:554/stream1" \
  -e YOLO_HOST="yolo_service_host" \
  -e YOLO_PORT="8080" \
  -e MESSAGE_BROKER_HOST="rabbitmq_host" \
  -e MESSAGE_BROKER_EXCHANGE_NAME="observed_cam_events" \
  --restart unless-stopped \
  rtsp2yolo:latest