SRS流媒体服务部署在韩国服务器上,如何配置推流入口并验证播放?

发布人:A5数据发布时间:2026-11-12 12:45阅读量:45

这项部署的目标是让编码器把直播流推送到韩国服务器上的 SRS,再由 SRS 输出 HLS 和 HTTP-FLV,最后通过接口、日志、命令行播放器和浏览器播放器确认推流入口及播放链路均正常。典型入口为 rtmp://服务器公网IP:1935/live/stream_key,播放地址则对应 http://服务器公网IP:8080/live/stream_key.m3u8 或 HTTP-FLV 地址。

以下以一台具有公网 IPv4 地址的 Ubuntu 22.04/24.04 韩国云服务器为例,使用 Docker Compose 部署 SRS 5.x。服务器需要能够被编码器访问,云厂商安全组和系统防火墙应同时放行必要端口。示例中的域名、IP、流名称和密钥均为演示值,不代表实际执行结果。

准备条件

服务器、域名与端口

建议准备以下条件:

  • Ubuntu 22.04 或 Ubuntu 24.04 服务器。
  • 已安装 Docker Engine 和 Docker Compose V2。
  • 服务器具有公网 IPv4 地址,例如 203.0.113.20。
  • 编码器可以访问服务器的 TCP 1935 端口。
  • 播放端可以访问 HTTP 8080 端口,或者后续通过 Nginx 的 HTTPS 443 端口播放。
  • 管理员可以通过 SSH 登录服务器。
  • 如果使用域名,准备一个指向韩国服务器公网 IP 的 A 记录,例如 live.example.com。

先确认运行环境:

docker --version
docker compose version
uname -a
timedatectl status

预期可以看到 Docker 和 Compose 的版本信息,并确认系统时间已经同步。时间同步有助于日志分析、证书校验和后续故障定位。

域名解析完成后,在服务器或其他网络环境中检查:

dig +short A live.example.com

返回的 IPv4 地址应当与韩国服务器公网地址一致。如果配置了 AAAA 记录,还要确认服务器具备可用的 IPv6 监听能力;否则部分客户端可能优先访问 IPv6 而连接失败。

面向 SRS 推流接入与 HLS、HTTP-FLV 播放分发,A5idc数据提供韩国首尔等地区的物理服务器资源,韩国方案涵盖不同 CPU、存储及优化或国际线路配置,可为流媒体服务部署提供地域与硬件基础。针对韩国及跨境访问场景,这些资源也为直播入口和播放分发提供相应的网络部署选择。

资源和编码参数

SRS 在这里承担接收、切片和封装分发,不负责把 H.265 转成 H.264,也不负责把高码率视频自动转码成低码率版本。为了兼容常见的 HLS、HTTP-FLV 播放器,首次部署建议使用:

  • 视频编码:H.264。
  • 音频编码:AAC。
  • 关键帧间隔:约 2 秒。
  • 1080p 视频码率:可先从 3~6 Mbps 选择。
  • 音频码率:128~192 kbps。
  • 帧率:25 或 30 fps。

实际码率应以源视频内容、编码器能力和观看人数为准。服务器带宽至少要同时覆盖推流上行和播放下行。一个简单估算方式是:

出方向带宽 ≈(视频 Mbps + 音频 Mbps)× 并发观看人数 × 1.1

例如视频码率为 3 Mbps、音频为 128 kbps,即 3.128 Mbps;20 个观看连接的估算出方向带宽为:

3.128 × 20 × 1.1 ≈ 68.8 Mbps

这里的 1.1 是协议和分发开销的近似系数,不是带宽保证值。还要结合云服务器的出口计费、峰值带宽和跨区域访问情况进行确认。

端口规划

用途协议和端口是否建议公网开放说明
RTMP 推流TCP 1935是供编码器连接 SRS
SRS HTTP 服务TCP 8080仅初次验证或临时使用提供 HLS、HTTP-FLV 文件
SRS HTTP APITCP 1985否仅绑定服务器本机,供管理检查
Nginx HTTPSTCP 443是生产环境建议作为播放入口
SSH 管理TCP 22仅管理来源地址不要对所有地址长期开放

部署 SRS 服务

创建目录

在服务器上创建独立目录,避免把配置和系统其他服务混在一起:

mkdir -p "$HOME/srs-live/conf"
cd "$HOME/srs-live"
pwd

预期路径类似:

/home/ubuntu/srs-live

在正式修改配置前,保留一份目录备份:

cp -a "$HOME/srs-live" "$HOME/srs-live.backup.$(date +%Y%m%d%H%M%S)"

这份备份包含 Compose 文件和 SRS 配置。HLS 切片本身属于临时数据,不建议把不断变化的切片目录当作长期备份内容。

编写 Compose 配置

创建 compose.yaml:

services:
  srs:
    image: ossrs/srs:5
    container_name: srs
    restart: unless-stopped
    working_dir: /usr/local/srs
    entrypoint:
      - /usr/local/srs/objs/srs
    command:
      - -c
      - /usr/local/srs/conf/srs.conf
    ports:
      - "1935:1935/tcp"
      - "8080:8080/tcp"
      - "127.0.0.1:1985:1985/tcp"
    volumes:
      - ./conf/srs.conf:/usr/local/srs/conf/srs.conf:ro
    stop_grace_period: 30s
    logging:
      driver: json-file
      options:
        max-size: "20m"
        max-file: "5"

ossrs/srs:5 表示使用 SRS 5.x 系列。生产环境完成验证后,可以将镜像标签固定到已经测试过的具体版本或镜像摘要,避免不同时段重新拉取到不同补丁版本。

这里没有把 1985 端口暴露到公网,只映射到服务器本机的 127.0.0.1。SRS API 可用于检查流状态,但不应作为公开管理接口。

先检查 Compose 文件格式:

docker compose config

预期会输出整理后的 Compose 配置,且不会出现 YAML 缩进或字段错误。

编写 SRS 配置

创建 conf/srs.conf:

listen              1935;
max_connections     1000;
daemon              off;
srs_log_tank        console;

http_api {
    enabled         on;
    listen          1985;
}

http_server {
    enabled         on;
    listen          8080;
    dir             ./objs/nginx/html;
}

vhost __defaultVhost__ {
    hls {
        enabled         on;
        hls_path        ./objs/nginx/html;
        hls_fragment    5;
        hls_window      30;
    }

    http_remux {
        enabled         on;
        mount           [vhost]/[app]/[stream].flv;
        hstrs           on;
    }
}

这份配置完成三件事:

  1. 监听 TCP 1935,接收 RTMP 推流。
  2. 监听本机 API 1985,查询当前流状态。
  3. 监听 HTTP 8080,输出 HLS 和 HTTP-FLV。

HLS 每个切片约 5 秒,播放窗口保留约 30 秒。切片时间越短,端到端延迟通常越低,但切片请求频率和服务端处理开销会增加。首次部署不建议为了追求低延迟直接把参数压得过低。

启动并检查服务

拉取镜像并启动容器:

cd "$HOME/srs-live"
docker compose pull srs
docker compose up -d

查看容器状态:

docker compose ps

预期状态类似:

NAME   SERVICE   STATUS          PORTS
srs    srs       Up               0.0.0.0:1935->1935/tcp
                                  0.0.0.0:8080->8080/tcp
                                  127.0.0.1:1985->1985/tcp

查看最近日志:

docker compose logs --tail=100 srs

日志中应能看到 SRS 启动完成以及 RTMP、HTTP API、HTTP Server 相关监听信息。具体日志格式会随镜像版本变化,不应只依赖某一行固定文本。

检查主机监听端口:

sudo ss -lntp | grep -E ':(1935|8080|1985)\b'

本机检查 API:

curl -fsS http://127.0.0.1:1985/api/v1/versions

如果返回 JSON 版本信息,说明 SRS 进程和 API 已经正常工作。此时还没有推流,HLS 播放地址返回 404 是正常现象,因为 SRS 尚未生成任何直播切片。

配置网络入口

配置云安全组和系统防火墙

先检查现有 UFW 规则,避免启用防火墙时中断 SSH:

sudo ufw status numbered | tee "$HOME/ufw-before.txt"

如果服务器使用 UFW,可以先放行 SSH,再放行推流和临时播放端口:

sudo ufw allow OpenSSH
sudo ufw allow 1935/tcp
sudo ufw allow 8080/tcp
sudo ufw enable
sudo ufw status verbose

启用前应保持当前 SSH 会话,不要只依赖一条远程连接。生产环境中,1935 端口最好只允许编码器固定公网地址访问:

sudo ufw delete allow 1935/tcp
sudo ufw allow from <编码器公网IP> to any port 1935 proto tcp

如果编码器公网地址经常变化,不能只依赖 IP 白名单,应使用足够随机的流名称,并在业务层增加推流鉴权。不要把 SRS API 1985 加入公网防火墙规则。

云厂商安全组也要同步配置。若安全组没有放行,即使 UFW 显示允许,外部连接仍然可能超时。

从编码器所在网络或另一台外部机器检查端口:

nc -vz 203.0.113.20 1935
nc -vz 203.0.113.20 8080

结果含义如下:

  • succeeded:TCP 端口可以建立连接。
  • Connection refused:网络已经到达服务器,但没有可用监听或端口映射错误。
  • timed out:优先检查云安全组、UFW、路由和公网地址。

生成推流入口

应用名固定使用 live,流名称使用字母、数字和下划线,避免 URL 编码问题。可以生成一个随机后缀:

openssl rand -hex 16

例如得到一段随机字符串后,可以形成如下演示入口:

推流服务器地址:rtmp://203.0.113.20:1935/live
流名称或推流密钥:camera_01_7f3a9c2d

如果编码器要求填写完整地址,则使用:

rtmp://203.0.113.20:1935/live/camera_01_7f3a9c2d

如果编码器把“服务器地址”和“流名称”分开填写,则不要把 /live/ 重复填写:

编码器字段填写内容
服务器或 URLrtmp://203.0.113.20:1935/live
流名称、Stream Key 或密钥camera_01_7f3a9c2d
视频编码H.264
音频编码AAC
关键帧间隔约 2 秒

流名称实际承担了一部分入口识别作用,不应使用 test、live、123456 这类容易猜测的值。推流密钥不要发布到网页、工单、截图或公共代码仓库。

推流与逐步验证

使用编码器推流

在编码器中开始推流后,先观察 SRS 日志:

cd "$HOME/srs-live"
docker compose logs -f --tail=100 srs

正常情况下,日志会出现新客户端连接、发布流或推流相关信息。日志只用于辅助判断,最终状态以 API 和实际播放结果为准。

另开一个 SSH 窗口查询流列表:

curl -fsS http://127.0.0.1:1985/api/v1/streams/

为了便于查看,可以安装 jq 后格式化:

sudo apt-get update
sudo apt-get install -y jq
curl -fsS http://127.0.0.1:1985/api/v1/streams/ | jq .

示例结构如下:

{
  "streams": [
    {
      "name": "camera_01_7f3a9c2d",
      "app": "live",
      "vhost": "__defaultVhost__"
    }
  ]
}

字段名称可能随 SRS 版本和 API 返回结构变化,重点是确认返回数据中出现了目标流名称和 live 应用。

如果 API 仍返回空流列表,应先检查:

  1. 编码器是否真的开始发送数据。
  2. 推流地址是否为 rtmp://IP:1935/live/流名称。
  3. 云安全组和 UFW 是否放行 1935。
  4. SRS 日志是否出现连接或发布失败信息。
  5. 是否把播放地址错误地填到了编码器中。

验证 HLS 播放

推流开始后,等待一个或两个切片周期,再从服务器或外部机器请求 HLS 播放列表:

curl -i http://203.0.113.20:8080/live/camera_01_7f3a9c2d.m3u8

正常结果应包含:

HTTP/1.1 200 OK
Content-Type: application/vnd.apple.mpegurl

响应正文通常包含:

#EXTM3U
#EXT-X-TARGETDURATION:5
#EXT-X-MEDIA-SEQUENCE:...
#EXTINF:...

如果使用 curl 多次请求,#EXT-X-MEDIA-SEQUENCE 或切片列表应随直播推进而变化。只返回 404 时,先确认流名称、应用名和推流状态;刚开始推流的几秒内没有文件也可能是正常等待。

HLS 播放地址为:

http://203.0.113.20:8080/live/camera_01_7f3a9c2d.m3u8

浏览器直接打开 m3u8 的行为取决于浏览器本身。部分浏览器可以原生播放,其他浏览器需要使用 HLS.js 等播放器组件。也可以使用支持 HLS 的桌面播放器进行检查:

ffplay "http://203.0.113.20:8080/live/camera_01_7f3a9c2d.m3u8"

验证 HTTP-FLV 播放

HTTP-FLV 地址为:

http://203.0.113.20:8080/live/camera_01_7f3a9c2d.flv

可以使用 FFmpeg 工具检查是否收到音视频数据:

ffprobe -hide_banner \
  -i "http://203.0.113.20:8080/live/camera_01_7f3a9c2d.flv"

也可以使用播放器测试:

ffplay "http://203.0.113.20:8080/live/camera_01_7f3a9c2d.flv"

HTTP-FLV 是持续输出的数据流,使用普通 curl 请求时不会自然结束。如果仅检查是否收到响应头,可以设置超时时间:

timeout 8s curl -v \
  -o /dev/null \
  "http://203.0.113.20:8080/live/camera_01_7f3a9c2d.flv"

如果已经看到 HTTP 200 和持续接收数据,命令因超时返回并不代表播放失败。

使用 FFmpeg 构造测试推流

没有硬件编码器时,可以使用本地测试文件验证入口。测试文件应包含视频和音频轨道:

ffmpeg -re -stream_loop -1 -i sample.mp4 \
  -c:v libx264 \
  -preset veryfast \
  -tune zerolatency \
  -b:v 3000k \
  -maxrate 3000k \
  -bufsize 6000k \
  -g 50 \
  -c:a aac \
  -b:a 128k \
  -ar 48000 \
  -f flv \
  "rtmp://203.0.113.20:1935/live/camera_01_7f3a9c2d"

如果测试文件是 30 fps,-g 60 通常对应约 2 秒关键帧;25 fps 文件可以使用 -g 50。命令输出中应持续出现帧数、帧率和速度信息。停止命令使用 Ctrl+C,不会删除 SRS 配置。

生产播放入口与 HTTPS

直接使用 8080 端口适合初次验证,但对外发布时通常使用域名和 HTTPS。RTMP 推流仍然连接 1935,播放端则通过 Nginx 代理到 SRS 的 8080 端口。

生产播放入口与 HTTPS配图

配置 Nginx 反向代理

安装 Nginx 前保留现有配置备份:

sudo cp -a /etc/nginx "/etc/nginx.backup.$(date +%Y%m%d%H%M%S)"
sudo apt-get update
sudo apt-get install -y nginx

拿到与 live.example.com 对应的证书和私钥后,创建站点配置:

server {
    listen 80;
    server_name live.example.com;

    location /.well-known/acme-challenge/ {
        root /var/www/html;
    }

    location / {
        return 301 https://$host$request_uri;
    }
}

server {
    listen 443 ssl http2;
    server_name live.example.com;

    ssl_certificate     /etc/letsencrypt/live/live.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/live.example.com/privkey.pem;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_buffering off;
        proxy_cache off;
        proxy_read_timeout 3600s;
        proxy_send_timeout 3600s;
        add_header Access-Control-Allow-Origin "*" always;
    }
}

如果播放器与直播页面使用固定域名,应把 Access-Control-Allow-Origin "*" 改成实际页面来源,或者在同源部署时删除这一行。

启用配置并检查:

sudo ln -s /etc/nginx/sites-available/live.conf \
  /etc/nginx/sites-enabled/live.conf

sudo nginx -t
sudo systemctl reload nginx

nginx -t 必须返回配置测试成功后才能 reload。验证 HTTPS 播放:

curl -I https://live.example.com/live/camera_01_7f3a9c2d.m3u8

生产环境确认 HTTPS 播放正常后,可以关闭外部 8080 端口,只保留本机到 Nginx 的访问。若使用 UFW:

sudo ufw delete allow 8080/tcp

同时从云安全组中删除公网 8080 规则。删除前应确认播放器已经改用:

https://live.example.com/live/camera_01_7f3a9c2d.m3u8

如果删除后发现 Nginx 配置或证书有问题,可以临时恢复 8080 规则,先恢复播放,再处理代理配置。

常见异常处理

1935 端口超时

按由外到内的顺序检查:

常见异常处理:1935 端口超时配图

sudo ss -lntp | grep ':1935'
docker compose ps
sudo ufw status verbose
docker compose logs --tail=200 srs
  • 没有监听:检查容器是否启动、端口映射是否正确。
  • 本机监听但外部超时:检查云安全组、UFW 和服务器公网地址。
  • TCP 可以连接但推流失败:检查编码器 URL、应用名和流名称。
  • 端口被其他程序占用:检查占用进程后再决定停止旧服务或更换主机映射端口。停止旧服务前应确认其业务影响,并保留原配置。

API 没有流,但编码器显示已连接

先确认完整推流地址没有重复路径:

正确:
rtmp://203.0.113.20:1935/live/camera_01_7f3a9c2d

常见错误:
rtmp://203.0.113.20:1935/live/live/camera_01_7f3a9c2d

再检查编码器是否真的在输出视频帧,而不是只建立了 TCP 连接。SRS 不会因为端口连接成功就自动生成播放流,必须收到有效的 RTMP 发布数据。

HLS 返回 404

按照以下顺序检查:

  1. API 是否能看到流。
  2. HLS 请求中的应用名是否是 live。
  3. 文件名是否与流名称完全一致。
  4. 是否刚开始推流,尚未生成第一个切片。
  5. 容器日志是否出现 HLS 或文件写入错误。

如果 API 中有流,但持续几分钟仍然没有 HLS 文件,重点检查配置中的 hls.enabled、hls_path 和容器运行日志。

有 HLS 文件但黑屏或没有声音

这通常不是网络端口问题,而是编码参数不兼容。优先将编码器调整为:

  • H.264 视频。
  • AAC 音频。
  • 关键帧间隔约 2 秒。
  • 关闭不必要的特殊编码特性。
  • 确认源文件或编码器确实包含音频轨道。

可以用 ffprobe 检查流信息:

ffprobe -hide_banner \
  "http://203.0.113.20:8080/live/camera_01_7f3a9c2d.m3u8"

如果只能看到视频流而没有音频流,应检查编码器音频输入和 AAC 配置。

HLS 能播但延迟偏高

HLS 本身需要等待切片生成和播放器缓冲。当前配置使用 5 秒切片、30 秒窗口,实际延迟还会受到播放器缓冲策略、网络抖动和客户端解码能力影响。

可以先确认播放列表是否持续更新,再检查播放器是否设置了较大的缓冲区。不要直接将 SRS 切片时间改成极低值;低延迟设置需要同时评估 CPU、请求频率、网络稳定性和客户端兼容性。

Nginx 返回 502

先在服务器本机检查 SRS HTTP 服务:

curl -I http://127.0.0.1:8080
docker compose ps
docker compose logs --tail=100 srs

如果本机 8080 无响应,先修复 SRS 容器或端口映射;如果本机访问正常,再检查 Nginx 的 proxy_pass、证书配置和 reload 状态:

sudo nginx -t
sudo systemctl status nginx --no-pager

资源与运行结果检查

推流和播放同时进行时,检查容器资源:

docker stats --no-stream srs
free -h
df -h

重点观察:

  • CPU 是否持续接近满载。
  • 内存是否不断增长。
  • HLS 输出目录所在磁盘是否有足够空间。
  • 网络出口是否接近套餐峰值。
  • 日志是否持续出现断开、重连或写入错误。

可以查看当前 TCP 连接数量:

sudo ss -tan '( sport = :1935 or sport = :8080 )' | head -50

建议至少完成以下结果检查:

资源与运行结果检查配图

  • 编码器能够连接韩国服务器的 TCP 1935。
  • SRS API 中能看到目标应用和流名称。
  • HLS 播放列表返回 200,并且切片列表持续更新。
  • HTTP-FLV 能够持续收到数据。
  • 播放器能解码出视频和音频。
  • 从外部网络访问时结果与服务器本机测试一致。
  • 1985 API 从公网不可直接访问。
  • Nginx 启用 HTTPS 后,播放页面不出现混合内容错误。
  • 容器重启策略为 unless-stopped,日志轮转配置已经生效。

修改 SRS 配置前,先备份当前文件:

cp "$HOME/srs-live/conf/srs.conf" \
  "$HOME/srs-live/conf/srs.conf.$(date +%Y%m%d%H%M%S).bak"

修改后重启会中断当前推流和播放连接:

cd "$HOME/srs-live"
docker compose restart srs

因此,生产环境应在低峰期执行,并在重启后重新完成 API、HLS 和 HTTP-FLV 检查。

验收与回滚检查项

验收清单

  • [ ] 韩国服务器公网 IP 和域名解析结果正确。
  • [ ] 1935 已按编码器来源开放。
  • [ ] 1985 仅绑定本机,没有暴露到公网。
  • [ ] SRS 容器状态为运行中。
  • [ ] 日志没有持续性的端口占用或配置解析错误。
  • [ ] 推流地址使用正确的 live 应用名和随机流名称。
  • [ ] /api/v1/streams/ 能看到目标流。
  • [ ] HLS 地址返回 200,播放列表持续更新。
  • [ ] HTTP-FLV 地址可以持续接收数据。
  • [ ] 播放器能够正常解码 H.264 视频和 AAC 音频。
  • [ ] 生产播放入口已经切换到 HTTPS 域名。
  • [ ] 关闭 8080 前,Nginx 443 入口已经验证通过。
  • [ ] 已记录镜像版本、配置备份、推流地址格式和回滚步骤。

回滚步骤

如果新配置导致 SRS 无法启动,先停止容器以避免反复重启:

cd "$HOME/srs-live"
docker compose stop srs

恢复最近一次可用配置:

cp "$HOME/srs-live/conf/srs.conf.<时间戳>.bak" \
  "$HOME/srs-live/conf/srs.conf"
docker compose up -d srs

如果是 Nginx 变更导致播放失败,恢复 /etc/nginx 的备份前,先检查备份目录内容,再执行:

sudo nginx -t
sudo systemctl reload nginx

如果 HTTPS 入口尚未恢复,可以暂时重新开放 8080 验证 SRS 本身:

sudo ufw allow 8080/tcp

确认原始 HTTP 播放恢复后,再单独处理证书、域名和 Nginx 配置。不要使用 docker compose down -v 作为普通回滚命令;删除卷可能造成与其他服务关联的数据丢失。对于本部署,优先使用 stop、恢复配置和 up -d,保留镜像、配置备份及容器网络。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/9063.html

相关推荐