flaviostutz/rtsp-relay

rtsp-relay

https://hub.docker.com/r/flaviostutz/rtsp-relay

镜像概述

RTSP流中继服务器，基于ffmpeg、rtsp-simple-server和rtsp-simple-proxy实现，支持codec透传（无编码操作），从而降低CPU使用率。可处理ffmpeg支持的任意输入URL，允许多客户端连接同一流。

核心功能

• Codec透传：无编码转换，CPU占用低
• 多客户端支持：同一流可被多个客户端同时访问
• 多输入源：支持网络流（如RTSP、HTTP）、本地文件等ffmpeg兼容的输入源
• 灵活配置：通过环境变量自定义源URL、流名称、FFmpeg参数等

使用场景

• 监控摄像头RTSP流转发，供多客户端查看
• 本地视频文件循环推流为RTSP流
• 跨网络中继RTSP流，解决直接访问限制问题

配置说明

暴露端口

• RTSP UDP/TCP监听：8554
• RTP UDP监听：8000
• RTCP UDP监听：8001

环境变量

• SOURCE_URL：输入媒体URL（必填，如RTSP流、本地文件路径）
• RTSP_PROXY_SOURCE_TCP：源RTSP流是否使用TCP（'yes'/'no'，默认no）
• STREAM_NAME：流路径名称（默认'stream'，访问地址为rtsp://[host]:[port]/[STREAM_NAME]）
• FORCE_FFMPEG_SOURCE：强制使用FFmpeg中继（true/false，默认false）
• FFMPEG_ARGS：FFmpeg额外参数（如错误检测配置）
• FFMPEG_INPUT_ARGS：FFmpeg输入相关参数（默认空）
• FFMPEG_OUTPUT_ARGS：FFmpeg输出相关参数（默认'-c copy'，透传编码）

部署示例

1. 转发网络流

创建docker-compose.yml：

yml
version: '3.7'
services:
  rtsp-relay:
    image: flaviostutz/rtsp-relay
    ports:
      - 8554:8554
    restart: always
    environment:
      - SOURCE_URL=http://ip-thomasmarina.greatlakescam.com/user/cgi-bin/getstream.cgi?10&&&&0&0&0&0&0

启动后，用VLC打开URL：rtsp://localhost:8554/stream查看流。

2. 本地视频文件循环推流

将视频文件放入samples目录，创建docker-compose.yml：

yml
version: '3.7'
services:
  rtsp-relay:
    image: flaviostutz/rtsp-relay
    ports:
      - 8554:8554
    environment:
      - SOURCE_URL=file:///samples/cars1.mp4
    volumes:
      - ./samples:/samples

启动后，客户端可通过rtsp://localhost:8554/stream访问循环播放的视频流。