Docker部署SRS:从零搭建实时音视频流媒体平台
做实时音视频项目的人应该都有同感:推流端和播放端其实都不复杂,真正麻烦的是中间那台流媒体服务器。你的视频流要从摄像头、OBS 或 App 端推进来,再被网页、小程序、播放器拉出去,中间还得考虑协议转换、延迟控制、录制回看、鉴权、并发承载——这套逻辑自己写根本不现实。SRS 就是专门解决这个问题的开源流媒体服务器,而用 Docker 部署 SRS,是当下最省心的落地方式。这篇文章我会从一个实际部署项目的角度,把实时音视频流媒体平台的搭建过程完整拆开讲清楚:为什么选 SRS+Docker、前期环境怎么准备、容器怎么起、推流拉流怎么验证、上生产前要调哪些参数。无论你是第一次接触流媒体开发,还是准备给现有业务加直播能力,这篇文章都能帮你少走不少弯路。
1. 为什么选 SRS,以及为什么用 Docker 部署
1.1 SRS 的价值:把流媒体协议的“翻译”工作变成配置
SRS(Simple Realtime Server)是国内开发者开源的一款流媒体服务器,开源社区活跃度非常高。它最核心的能力就是协议转换和流分发:客户端用 RTMP 推流进去,服务端可以对外输出 RTMP、HTTP-FLV、HLS、WebRTC 等不同的拉流协议。这就像是一个多语言的“翻译中转站”,视频流进来之后,想要给谁看、用什么方式看,都是配置项说了算,不需要自己从零实现底层传输逻辑。
SRS 能覆盖的场景也相当广。常见的直播间、在线教育、摄像头监控、IoT 设备画面回传,都可以用同一套服务承载。具体支持的能力大致包括:
- RTMP 直播推流与拉流,兼容 OBS、FFmpeg、各类直播软件
- HTTP-FLV 拉流,适合网页端低门槛播放
- HLS 切片输出,兼顾 PC 与移动端回看
- WebRTC 推拉流,实现毫秒级低延迟互动
- DVR 录制,把直播流落盘成回看文件
- HTTP 回调鉴权,接入业务侧的用户校验逻辑
我实际用下来的感受是,SRS 把流媒体服务器最复杂的部分做成了“开箱即用”,你只需要理解协议和配置的关系,就能在很短时间内搭建一套可用的直播系统。它的定位很纯粹:专注流媒体服务,而不是把业务逻辑也塞进来,所以跟你现有系统对接起来反而轻松。
1.2 容器化部署:从编译地狱到秒级启动
早几年部署 SRS 的主流方式是源码编译。SRS 当初依赖的开发库不算少,gcc、cmake、FFmpeg 相关依赖都得先装好,编译一次少说十几分钟,如果遇到服务器环境是老版本 CentOS 或者某些依赖冲突,整个过程会变得非常痛苦。我自己第一次编译时就被 openssl 版本卡了半天,纯粹是环境问题,跟 SRS 本身没有关系。
Docker 部署最直接的好处就是绕开这套依赖地狱。官方镜像里已经把编译产物和运行环境都打好了,拉下来就能跑,宿主机只需要有 Docker。这个优势在生产环境尤其明显:
- 环境隔离,不会污染宿主机,也不会被宿主机上其他软件影响
- 版本切换成本低,升级 SRS 只要换镜像 tag,回滚同理
- 部署一致性高,本地、测试、生产环境表现完全一致
- 扩容方便,多节点的流媒体分发可以直接用同一套镜像批量拉起来
如果你还在犹豫是自己编译还是用 Docker,我的建议很明确:优先用 Docker。特别是业务初期,把精力放到验证流媒体功能本身,不要在编译环节浪费时间。后续真到了需要深度定制 SRS 源码的阶段,再考虑编译方案也不迟。
2. 部署前的准备工作
2.1 宿主机 Docker 环境准备
Docker 部署 SRS 的前提,是宿主机已经具备可用的 Docker 环境。不同操作系统的安装方式不太一样,这里分别说一下我验证过的做法。
Linux 服务器(Ubuntu/Debian 系)可以直接通过官方脚本快速安装:
curl -fsSL https://get.docker.com | bash
systemctl enable --now docker
CentOS/RHEL 系则建议先配置 Docker 官方仓库,再安装 docker-ce 和 docker-compose-plugin:
yum install -y yum-utils
yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
yum install -y docker-ce docker-compose-plugin
systemctl enable --now docker
Windows 和 macOS 用户通常直接安装 Docker Desktop 就行。安装包在国内下载速度有时候不稳定,但整体来说图形界面的操作门槛低很多。需要注意的一点是,Docker Desktop 在 Windows 上依赖 WSL2 和 Hyper-V 相关虚拟化能力,如果你之前没装过 WSL 内核,装完 Docker Desktop 后第一次启动可能会报错。这个我在后面第 6 章专门展开讲。
安装完成后,用
docker version
和
docker compose version
验证一下客户端和服务端是否都正常。
2.2 端口规划与目录结构设计
SRS 运行时涉及的网络端口比较多,部署前最好先规划清楚,避免和业务上已有的服务冲突。默认情况下,我们至少要留出下面几个端口:
| 端口 | 协议 | 用途 |
|---|---|---|
| 1935 | TCP | RTMP 推流与拉流 |
| 1985 | TCP | HTTP API 接口,也承载 HTTP-FLV over HTTP |
| 8080 | TCP | HLS 切片文件、网页 demo、静态资源 |
| 8000 | UDP | WebRTC 的 RTP/RTCP 媒体通道 |
部署之前先在宿主机上检查端口是否被占用,命令很简单:
netstat -tlnp | grep 1935
ss -ulnp | grep 8000
如果云服务器有安全组,记得提前放行对应的入方向端口。这个坑我踩过不止一次:本地容器起来了,防火墙也没问题,结果忘了在云控制台的安全组里放行 1935 端口,推流一直失败。
目录结构方面,我习惯用一个统一的目录来管理 SRS 的配置、日志和数据,比如
/opt/srs
。里面分三个子目录:
-
conf:存放 srs.conf 配置文件,通过挂载方式注入容器 -
logs:存放 SRS 运行日志和访问日志,方便排查问题 -
data:存放 HLS 切片、录制文件等产物,避免容器重启后数据丢失
这样设计的好处是,后续升级镜像或者迁移宿主机时,配置和数据都能直接带着走,不用进容器里拷文件。
3. SRS 容器部署实操
3.1 一条命令跑起来的快速验证
快速体验阶段,不需要先写配置文件,直接用官方镜像把容器拉起来就行。SRS 5 的镜像 tag 是
ossrs/srs:5
,它内置了一套默认配置,默认开启了 HTTP-FLV、HLS 和 WebRTC 能力,适合先做功能验证。
docker run -d --name srs \
-p 1935:1935 \
-p 1985:1985 \
-p 8080:8080 \
-p 8000:8000/udp \
ossrs/srs:5
镜像拉取完成后,用
docker ps
确认容器状态是 Up。然后请求一下 SRS 的 HTTP API,确认服务真的活着:
curl http://127.0.0.1:1985/api/v1/versions
如果返回一段包含版本号的 JSON,说明 SRS 已经正常启动。这一步验证的意义在于:在你投入精力去配置更多功能之前,先用最小路径确认整条链路是通的。这也是我每次部署新服务时都会做的第一件事——先把最小闭环跑通,再去加功能。
提示:如果你的服务器在国内网络环境下拉取 Docker Hub 镜像超时,可以先配置一下镜像加速器,具体方法在第 6.2 节会说。
3.2 用 docker-compose 做正式部署
快速验证通过之后,正式环境我强烈建议用 docker-compose 来管理。相比裸
docker run
,compose 可以把容器参数、目录挂载、重启策略、资源限制都写进一个 YAML 文件里,可维护性高得多。团队协作时,一份 compose 文件推给同事,大家拉起来的环境完全一致,再也不用截图解释“我运行的那个 docker run 命令里有啥参数”。
在
/opt/srs
目录下创建
docker-compose.yml
:
version: "3.8"
services:
srs:
image: ossrs/srs:5
container_name: srs
restart: unless-stopped
ports:
- "1935:1935" # RTMP
- "1985:1985" # HTTP API / HTTP-FLV
- "8080:8080" # HLS / WEB 页面
- "8000:8000/udp" # WebRTC
volumes:
- ./conf/srs.conf:/usr/local/srs/conf/srs.conf
- ./logs:/usr/local/srs/objs/logs
- ./data:/usr/local/srs/objs/nginx/html
environment:
- TZ=Asia/Shanghai
logging:
driver: json-file
options:
max-size: "20m"
max-file: "5"
这里重点说两个容易出错的地方。
第一,SRS 镜像的工作目录是
/usr/local/srs/objs
,所以日志目录、HLS 文件目录要挂载到对应的子路径,而不是随便挂到一个 /data 上。你只有了解镜像内部的文件组织方式,挂载才能生效。我第一次部署时把 HLS 文件目录挂到了
/usr/local/srs/html
,结果切片一直在容器里生成,宿主机上什么都看不到。
第二,容器名称设置了
container_name: srs
,如果之后你误删了容器但名字还被占用,需要先删除旧容器再重新
docker compose up -d
。compose 的
restart: unless-stopped
策略可以保证系统重启或 Docker 服务重启时 SRS 自动拉起,这个参数在无人值守的服务器上非常重要。
配置文件和挂载目录准备就绪后,执行:
mkdir -p conf logs data
cd /opt/srs
docker compose up -d
docker compose logs -f srs
看到日志滚动且没有报错,就说明 SRS 以容器方式稳定运行了。后续改配置只需要编辑
conf/srs.conf
,然后重启容器即可:
docker compose restart srs
4. 直播核心链路验证:从推流到拉流
4.1 用 FFmpeg 推一路测试流
SRS 容器起来了,不代表流媒体链路一定通,必须实际推流再拉流验证。推流最方便的工具是 FFmpeg,而且不需要真实摄像头或现成视频文件,用 FFmpeg 自带的虚拟视频源就能生成一路测试信号。
ffmpeg -re -f lavfi -i testsrc=size=1280x720:rate=25 \
-f lavfi -i sine=frequency=1000:sample_rate=44100 \
-c:v libx264 -preset veryfast -tune zerolatency -pix_fmt yuv420p \
-c:a aac -shortest \
-f flv rtmp://127.0.0.1/live/livestream
这条命令里,
testsrc
会生成一个带彩色测试图案的动态视频源,
sine
会生成一个 1kHz 的测试音调,合成推流到 SRS 的默认 vhost 和
live
应用下,流名称是
livestream
。用虚拟源的好处是干净、可控,不会涉及真实素材版权问题,也方便反复测试。
如果你的环境里没有 FFmpeg,或者不想装命令行工具,用 OBS 推流也可以。OBS 的设置里,服务选择“自定义”,服务器填
rtmp://你的服务器IP/live
,串流密钥填
livestream
,点开始推流即可。
推流开始后,回到 SRS 容器日志确认是否收到了流:
docker logs -f srs | grep publish
正常会看到类似 publish stream 的日志,说明推流链路已经打通。如果没有任何 publish 日志,多半是网络没通或推流地址写错了,先检查端口和地址再继续往下排查。
4.2 拉流验证:HTTP-FLV 和 HLS
推流成功后,立刻在另一台机器(或同一台机器的另一个终端)拉流验证。网页播放最常见的两个协议是 HTTP-FLV 和 HLS。
HTTP-FLV 可以直接用 FFplay 验证:
ffplay http://127.0.0.1:1985/live/livestream.flv
HLS 地址则要等 SRS 切片生成,一般推流持续几秒后就能访问:
ffplay http://127.0.0.1:8080/live/livestream.m3u8
有几点需要解释一下。HTTP-FLV 的默认监听端口是 1985,和 HTTP API 共用一个端口,所以访问路径里不需要额外加端口区分。而 HLS 是 SRS 把流按时间切片成
.ts
文件,再生成
.m3u8
索引文件,通过 8080 端口的 HTTP 服务对外提供。如果你打开 m3u8 地址发现 404,大概率是切片还没来得及生成,多等几秒再刷新。
局域网内其他设备访问时,把 127.0.0.1 换成服务器的局域网 IP 或云服务器公网 IP。别忘了检查服务商安全组和本机防火墙,我只放行 1935 端口、忘记放行 8080 的情况也遇到过,网页端 HLS 始终加载不出来,查了半天才发现是安全组规则漏了一条。
4.3 WebRTC 低延迟播放验证
SRS 5 默认是开启 WebRTC 能力的,这是它相比很多传统流媒体服务器的一大优势。WebRTC 的拉流地址长这样:
webrtc://你的服务器IP/live/livestream
不需要让 SRS 单独配什么,直接用官方提供的播放器 demo 就能验证。浏览器访问:
http://你的服务器IP:8080/players/srs_player.html
在播放地址栏里填上面的 webrtc 地址,点击播放。如果图像出来而且延迟明显比 HLS 低,说明 WebRTC 链路是通的。
这里我补充一个实际生产中容易踩的坑:WebRTC 在公网环境强烈建议配置 HTTPS,否则部分浏览器会限制音视频相关能力。localhost 下浏览器比较宽容,HTTP 也能跑;但换到线上 IP 或域名访问时,最好通过 Nginx 加一层 TLS 终止代理,或者用 SRS 自带的 HTTPS 配置方式挂证书。你可以在部署规划阶段就把证书问题考虑进去,避免后面返工。
5. 生产环境配置与调优
5.1 核心配置项逐段解读
默认配置能跑通验证,但真正上线时要按业务需要调整。SRS 的配置文件是
srs.conf
,我梳理了一份常用配置模板,每一段的作用依次说明。
listen 1935;
max_connections 1000;
daemon off;
http_api {
enabled on;
listen 1985;
}
http_server {
enabled on;
listen 8080;
dir ./objs/nginx/html;
}
vhost __defaultVhost__ {
hls {
enabled on;
hls_fragment 2;
hls_window 30;
}
dvr {
enabled on;
dvr_path ./objs/nginx/html/record/[2006-01-02]/[15]_[04]_[05].flv;
}
http_remux {
enabled on;
mount [vhost]/[app]/[stream].flv;
}
}
listen 1935
是 RTMP 的监听端口;
max_connections
控制最大并发连接数,要根据服务器带宽和业务量来评估,默认值偏保守。
daemon off
是容器运行时的关键配置。因为容器主进程需要在前台运行,如果
daemon on
,SRS 会 fork 到后台,容器会立刻退出。镜像默认配置已经处理了这个问题,但你自己写配置时要特别注意。
http_api
是 SRS 对外提供的管理接口,可以查询流状态、踢流等,生产环境建议加上 token 鉴权参数,避免接口裸奔。
http_server
是 SRS 内嵌的静态文件服务,HLS 的 ts 切片和 m3u8 索引都靠它输出。
vhost
段的作用类似 Nginx 的虚拟主机。HLS 配置里,
hls_fragment 2
表示每 2 秒切一个分片,
hls_window 30
表示索引文件里保留最近 30 秒的切片。DVR 配置可以把直播流录制成 FLV 文件,
dvr_path
支持按时间生成目录和文件名,这个功能做点播回看非常好用。
http_remux
开启后,会把 RTMP 流实时转封装成 HTTP-FLV 输出,网页播放就靠它。
5.2 资源限制、日志与稳定性策略
容器不是“跑起来就行”,尤其是生产服务器上还可能跑着其他业务,必须对 SRS 容器的资源做一定限制。docker-compose 里可以直接配置:
deploy:
resources:
limits:
cpus: "2.0"
memory: 2g
这样即使直播并发量突然暴涨,SRS 最多也只能使用 2 核 CPU 和 2GB 内存,不会把整台服务器拖垮。需要注意的是,deploy 配置在
docker compose up
下是生效的,但如果你用的是 swarm 模式,需要额外注意编排方式。
日志问题同样不能忽略。Docker 默认的 json-file 日志驱动会无限增长,时间长了会占用大量磁盘空间。我在第 3 节的 compose 文件里已经加了日志轮转配置,
max-size: "20m"
表示单份日志最大 20MB,
max-file: "5"
表示最多保留 5 份。这样日志占用被限制在 100MB 以内,配合挂载到宿主机的
logs
目录,可以有效避免日志把根分区塞满的惨剧。
另外一点很实际的建议:SRS 的生产环境至少要监控两个指标——CPU 内存占用和 1985 端口的 API 可用性。前者反映当前负载,后者反映服务本身是否还活着。平时可以用 cAdvisor 或 Prometheus 拉取容器指标,但我们自己小团队初期用 shell 脚本定时 curl API 就足够了。
6. 常见问题与排查技巧
6.1 拉流失败与黑屏的排查顺序
我见过不少朋友第一次部署 SRS,推流推上去了,但拉流黑屏,各种查配置都没结果。这里我给大家一个可复用的排查顺序,按步骤执行,效率最高。
第一步,确认 SRS 日志里有 publish 记录。如果没有,说明推流端就没跟 SRS 建立连接,问题大概率在端口、地址或防火墙。
第二步,确认拉流地址的协议和端口匹配。HTTP-FLV 走 1985,HLS 走 8080,RTMP 走 1935,这三个端口容易搞混。用
ffplay
分别试一遍,能排除大部分手误。
第三步,直接访问 HLS 的 m3u8 文件,看是否返回内容。浏览器打开
http://你的IP:8080/live/livestream.m3u8
,如果返回的是文本索引内容,说明 HLS 链路正常;如果 404,说明切片不存在或 SRS 的 HLS 功能没开。
第四步,检查云安全组和服务器防火墙。这个最简单也最容易忽略,前面提了很多次,放行 1935、1985、8080、8000/udp 四个端口。
黑屏还有一个常见原因是编码格式不兼容:推流端如果用了不支持 H.264 的编码器(比如部分 GPU 编码器默认输出 H.265),而播放端或网页浏览器不支持对应编码格式,画面就会黑屏。SRS 默认配置下建议推流端统一使用 H.264 视频编码 + AAC 音频编码,兼容性最稳。
6.2 Docker 镜像拉取慢、超时的通用解法
国内网络环境下拉取 Docker Hub 镜像经常超时,
docker pull ossrs/srs:5
卡半天一动不动,这种情况不用怀疑机器啥问题,就是镜像下载链路太慢。解决办法是配置镜像加速器,编辑
/etc/docker/daemon.json
:
{
"registry-mirrors": [
"https://docker.m.daocloud.io",
"https://dockerproxy.net"
]
}
注意这是示例性质的加速地址,实际使用时要根据网络情况选可用的。改完配置必须重启 Docker 才能生效:
systemctl daemon-reload
systemctl restart docker
重启之后再次
docker pull ossrs/srs:5
,速度通常会明显改善。需要提醒的是,镜像加速器只加速 Docker Hub 官方镜像仓库的拉取,如果你的网络环境连加速器本身都不可达,那就换个镜像源或者通过带宽更好的网络拉取后导出再导入。
还有一个我经常用的技巧:如果 SRS 镜像始终拉不下来,可以先找一台网络更好的机器把镜像拉好,
docker save -o srs.tar ossrs/srs:5
导出为 tar 包,再传到目标服务器
docker load -i srs.tar
。离线部署时这是非常实用的方案。
6.3 Windows 下 Docker Desktop 虚拟化报错处理
Windows 上部署 SRS,最常见的是 Docker Desktop 启动失败,报错信息类似
virtualization support not detected
或
Docker Desktop failed to start because virtualization support wasn't enabled
。这个问题的本质是 Windows 的虚拟化功能没有完整开启,Docker Desktop 无法创建虚拟机来运行容器。
处理步骤一般分三步。第一步,进入 BIOS/UEFI 设置,找到 Intel Virtualization Technology(或 AMD SVM Mode),开启后保存重启。这一步是前提,如果 BIOS 里没开虚拟化,后面怎么改都白搭。
第二步,确认 Windows 功能里启用了“适用于 Linux 的 Windows 子系统”和“虚拟机平台”。可以用 PowerShell 管理员模式执行:
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
第三步,安装 WSL2 内核更新包。微软官网提供 wsl_update 安装包,装完之后在 PowerShell 里执行
wsl --set-default-version 2
,把默认版本切到 WSL2。
按这个顺序操作下来,绝大多数 Docker Desktop 启动问题都能解决。如果依然报错,把 Docker Desktop 的日志目录打开看看有没有更具体的错误码,结合日志去社区搜解决方案更准确。
6.4 容器重启后的数据与端口问题
很多人在容器重启后发现之前录制的视频没了、HLS 文件路径变了,或者干脆启动失败。原因其实就两类。
第一类,数据没有挂载到宿主机。如果你用第 3.1 节的裸
docker run
命令起容器,SRS 的日志、切片、录制文件都写在容器可写层里。容器一旦删除,数据跟着丢失。解决办法就是像第 3.2 节那样,把
./logs
和
./data
目录挂载出来。
第二类,端口被占用导致启动失败。
docker compose up -d
报端口 bind 失败时,先查占用:
lsof -i :1935
netstat -tlnp | grep 1935
如果发现端口被残余的容器进程或宿主机服务占用,需要先释放端口再启动容器。如果之前创建的旧容器还在占用资源,先执行:
docker rm -f srs
清理干净后再
docker compose up -d
。这里多嘴提醒一句:
docker rm -f
是强制删除容器,持续运行的业务容器要谨慎操作,最好在维护窗口执行。
7. 再来点扩展:录制、鉴权与集群方向
7.1 录制回看功能的快速落地
流媒体平台做起来之后,往往会面临一个需求:用户错过了直播,能不能看回放?SRS 的 DVR 功能就可以满足,配置方法在第 5.1 节的模板里已经出现了。录制的 FLV 文件会按照
dvr_path
模板生成在宿主机挂载目录里,配合
http_server
的静态文件能力,可以直接通过 8080 端口回看。
我实际使用中比较推荐的做法是:DVR 录制只作为临时的原始素材落盘,回看功能用专业的点播系统或对象存储来做。SRS 的定位是直播分发,不是重型的点播管理平台。录制的 FLV 文件可以定期拉到对象存储或 NAS 上做转码、切片,再接业务播放器。这样可以避免直播服务器磁盘被不断累积的录制文件耗尽。
7.2 推流鉴权、HTTPS 与集群化方向
业务人员最关心的还是安全。SRS 支持推流鉴权,最常用的方案是配置 HTTP 回调:推流端请求建立连接时,SRS 向业务服务器发一个 HTTP 请求,带上流名称、密钥等信息,业务服务器返回 0 允许推流,返回非 0 则拒绝。这样可以把鉴权逻辑完全交给业务系统管理,很灵活。
HTTPS 方面,SRS 自身支持配置证书做 HTTPS-FLV,但更通用的做法是前面套一层 Nginx 或负载均衡,把 TLS 终结在外面,内部的 1985、8080 仍然走 HTTP。网络架构上更清晰,也方便后续做 CDN 或者多域名配置。
集群化是 SRS 比较大的一项能力,它支持 Origin/Edge 架构。Origin 负责接收推流和录制,Edge 负责向外分发拉流,通过配置 Edge 节点指向 Origin 的地址,可以实现多节点水平扩容。如果直播业务量从几路涨到几千路,这套架构就能派上用场。但集群化不适合一开始就搞,先把单节点的稳定性跑通,再根据实际情况考虑扩容方案。
最后再分享一个我个人的习惯:SRS 的配置改动后,我会先用
docker compose config
检查 compose 文件语法,再 restart 容器,最后观察日志确认没有异常。线上环境的每个变更都要有记录,容器化的好处就是可以快速回滚——换回旧镜像 tag 重新 up 就是回滚。这个思路能让你在改动配置时钟有底气,正是一次次踩坑之后才积累下来的经验。
更多推荐

所有评论(0)