SRT协议实战：用FFmpeg+libsrt搭建低延迟直播推流（含错误码排查指南）

SRT协议实战：用FFmpeg+libsrt搭建低延迟直播推流（含错误码排查指南）

最近在折腾一个跨国线上音乐会的直播项目，团队对延迟的要求近乎苛刻——传统的RTMP推流在跨洋网络抖动面前，动辄两三秒的延迟实在让人头疼。试了一圈方案，最终把目光锁定在了SRT（Secure Reliable Transport）协议上。这玩意儿在流媒体圈子里火了好几年，但很多开发者上手时，总卡在握手失败、参数调不明白这些坑里。今天我就结合自己趟过的雷，聊聊怎么用FFmpeg配合libsrt库，从零搭建一套靠谱的低延迟推流系统，顺便把那些让人抓狂的错误码一个个拆解清楚。

SRT本质上是一个基于UDP的传输协议，但它通过前向纠错（FEC）和自动重传请求（ARQ）机制，在不可靠的网络上实现了可靠、安全的传输。它特别适合应对公共互联网中常见的丢包、抖动和带宽波动问题。如果你正在为实时互动直播、远程制作或任何对延迟敏感的音视频传输寻找解决方案，那么SRT值得你深入了解一下。本文面向的是有一定网络编程或流媒体开发经验的工程师，我们将绕过繁琐的理论，直接切入实战配置、代码集成和问题排查。

1. 环境准备与核心概念梳理

在动手写代码之前，得先把战场打扫干净。SRT的实现库libsrt和我们的老朋友FFmpeg，都需要正确编译和集成。这里面的门道不少，版本兼容性是第一个拦路虎。

1.1 编译集成libsrt与FFmpeg

我强烈建议从源码编译，这样可以确保使用最新的特性并拥有最大的灵活性。首先搞定libsrt。

# 1. 下载并编译libsrt
git clone https://github.com/Haivision/srt.git
cd srt
./configure --prefix=/usr/local --enable-shared
make -j$(nproc)
sudo make install

# 2. 确保动态库被系统找到
echo "/usr/local/lib" | sudo tee /etc/ld.so.conf.d/srt.conf
sudo ldconfig

接下来是FFmpeg。FFmpeg默认并不开启SRT支持，我们需要在编译时显式地启用它。

# 下载FFmpeg源码
git clone https://github.com/FFmpeg/FFmpeg.git
cd FFmpeg

# 配置编译选项，关键是要带上 --enable-libsrt
./configure \
  --prefix=/usr/local/ffmpeg \
  --enable-gpl \
  --enable-nonfree \
  --enable-libsrt \
  --extra-libs=-lsrt \
  --extra-cflags="-I/usr/local/include" \
  --extra-ldflags="-L/usr/local/lib"
make -j$(nproc)
sudo make install

编译完成后，验证一下是否成功：

/usr/local/ffmpeg/bin/ffmpeg -protocols | grep srt

如果输出中包含 srt，恭喜你，基础环境搭建成功。这里有个小坑：如果你的系统里存在多个版本的libsrt，可能会引发链接错误。确保编译FFmpeg时 pkg-config 能找到正确版本的库。

1.2 理解SRT的核心工作模式

SRT协议主要支持三种连接模式，理解它们对后续的推流和拉流配置至关重要：

• 呼叫方模式：主动发起连接的一方。在推流场景中，编码端（OBS、FFmpeg）通常作为呼叫方，主动连接接收服务器。
• 监听方模式：被动等待连接的一方。接收服务器（如SRS、Nginx-rtmp-module with SRT）运行在此模式，监听一个固定的UDP端口。
• 会合模式：一种P2P模式，双方同时扮演呼叫方和监听方，用于穿透某些复杂的NAT环境。在常规的客户端-服务器推流中较少使用。

对于互联网直播推流，最常用的就是 “呼叫方-监听方” 模式。此外，SRT协议握手分为两个阶段：诱导阶段和结论阶段。握手过程中双方会协商一系列关键参数，其中任何一个环节出问题，都会导致连接失败并返回特定的错误码。

提示：在开始调试前，建议先用 srt-live-transmit 这个官方测试工具验证网络连通性和基本参数。它是一个极佳的学习和排错工具。

2. FFmpeg推流实战：从命令到参数详解

环境就绪，我们来点真格的。用FFmpeg向一个支持SRT的服务器推流，命令看起来并不复杂，但每个参数背后都藏着学问。

2.1 基础推流命令与参数解析

假设你有一路视频（input.mp4）需要推送到地址为 srt://receiver.example.com:9000 的服务器。一个最基础的推流命令如下：

ffmpeg -re -i input.mp4 -c copy -f mpegts "srt://receiver.example.com:9000?mode=caller&latency=2000000"

我们来拆解一下这个命令和SRT特有的URL参数：