做实时音视频项目的人应该都有同感:推流端和播放端其实都不复杂,真正麻烦的是中间那台流媒体服务器。你的视频流要从摄像头、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 就是回滚。这个思路能让你在改动配置时钟有底气,正是一次次踩坑之后才积累下来的经验。

Logo

邀请您加入社区

更多推荐