香港服务器如何部署SRS流媒体并完成推拉流验证?
在香港服务器上部署SRS,可以采用“Ubuntu 24.04 LTS+Docker Compose+SRS 6”的组合:先启动仅本机可访问的服务,再按来源IP开放媒体端口,最后使用FFmpeg或OBS推送RTMP流,分别验证RTMP、HTTP-FLV和HLS播放链路。这样既能确认程序正常运行,也能区分容器配置、端口放行和客户端编码问题。
本教程以一台具有公网IPv4的香港服务器为部署对象,目标是完成单节点直播分发验证,不包含服务端转码、集群调度和完整业务鉴权。上线前还需补齐HTTPS、推流鉴权、监控与容量评估;香港机房的位置本身并不代表所有观看地区都能获得相同的访问质量。
A5数据提供中国香港及美国、日本、新加坡等地区的物理服务器资源,香港产品覆盖Xeon Gold、AMD EPYC等平台,并配备SSD或NVMe存储及CN2、国际带宽等线路选择,可为SRS流媒体服务的推流接入、转发分发和多协议播放提供主机与网络基础;面向不同地区观众的业务,也可结合对应区域服务器构建多地部署架构。
一、准备环境与端口访问条件
1. 明确服务器和客户端职责
示例环境如下,资源规格仅作为小规模功能验证的起点,不代表并发承诺。
| 项目 | 本文采用的条件 | 用途 |
|---|---|---|
| 服务器系统 | Ubuntu 24.04 LTS,amd64 | 运行Docker与SRS |
| 服务器资源 | 约2核CPU、2GB内存、20GB可用磁盘 | 单路推流与少量播放验证 |
| SRS版本 | SRS 6镜像,拉取后固定镜像摘要 | 避免重复部署时版本漂移 |
| 推流客户端 | 安装FFmpeg或OBS的电脑 | 编码并发送RTMP流 |
| 播放客户端 | FFmpeg、ffprobe或VLC | 验证不同播放协议 |
| 网络条件 | 公网IPv4、SSH权限、可配置入站规则 | 远程部署和访问测试 |
本方案由客户端完成H.264和AAC编码,SRS负责接收与分发。因此,不能把验证环境的CPU占用直接套用到需要实时转码的业务。
先在服务器确认系统、架构、空间和端口:
cat /etc/os-release
uname -m
df -h / /opt
sudo ss -lntp | grep -E ':(1935|1985|8080)\b' || true
预期系统信息对应Ubuntu 24.04,架构为x86_64,目标端口没有被其他程序占用。如果端口已占用,应先确认所属服务,不要直接结束未知进程。
2. 规划端口,而不是一次开放全部端口
| 端口 | 协议与用途 | 建议访问范围 |
|---|---|---|
| SSH实际端口 | TCP,服务器管理 | 管理员固定公网IP |
| 1935 | TCP,RTMP推流与拉流 | 推流端、测试拉流端公网IP |
| 8080 | TCP,HTTP-FLV与HLS | 测试播放端公网IP |
| 1985 | TCP,SRS HTTP API | 只绑定服务器本机回环地址 |
本文不启用WebRTC,因此不需要额外开放相关UDP端口。
首次启动时,三个端口都只映射到127.0.0.1。完成本机检查后,再选择通过SSH隧道验证,或者开放受来源IP限制的公网媒体端口。
Docker发布端口可能不受UFW常规入站规则按预期约束。不能仅凭“UFW默认拒绝”就认定容器端口没有暴露。 公网测试应优先在云平台安全组或独立网络防火墙中限制来源;没有这层控制时,先使用SSH隧道,不要直接改成公网监听。
修改网络规则前,记录原规则并保留当前SSH会话。不要为了测试媒体服务调整SSH端口,也不要直接清空防火墙。
二、安装Docker并固定SRS镜像
1. 安装运行环境
以下命令适用于Ubuntu 24.04新服务器,需要sudo权限,会添加Docker软件源并安装相关组件。已有Docker、容器业务或第三方Docker软件源的机器,应先检查现状,避免混装软件包。
sudo apt-get update
sudo apt-get install -y ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg \
-o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" \
| sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update
sudo apt-get install -y \
docker-ce docker-ce-cli containerd.io \
docker-buildx-plugin docker-compose-plugin
sudo systemctl enable --now docker
验证安装:
sudo docker version
sudo docker compose version
sudo systemctl is-active docker
应能看到Docker客户端、服务端和Compose版本,服务状态为active。若拉取软件源失败,应检查服务器DNS、出站访问和系统时间,不要通过关闭证书校验规避错误。
本文继续使用sudo docker,不把普通账号加入Docker用户组。Docker管理权限接近主机管理员权限,不宜随意授予。
2. 创建目录并记录镜像摘要
先确认/opt/srs不是已有业务目录。以下备份命令会复制现有目录,执行前应确保磁盘空间足够:
if sudo test -d /opt/srs; then
sudo cp -a /opt/srs "/opt/srs.backup.$(date +%Y%m%d-%H%M%S)"
fi
sudo install -d -m 0755 /opt/srs
sudo docker pull ossrs/srs:6
ossrs/srs:6是主版本标签,后续可能指向不同构建。将本次拉取结果转换为镜像摘要写入配置:
SRS_IMAGE=$(sudo docker image inspect ossrs/srs:6 \
--format '{{index .RepoDigests 0}}')
test -n "$SRS_IMAGE" || {
echo "未取得镜像摘要,请检查拉取结果"
exit 1
}
printf 'SRS_IMAGE=%s\nMEDIA_BIND_IP=127.0.0.1\n' "$SRS_IMAGE" \
| sudo tee /opt/srs/.env > /dev/null
检查实际程序版本:
sudo docker run --rm "$SRS_IMAGE" ./objs/srs -v
预期输出包含SRS版本信息。后续故障记录应同时保留版本号和镜像摘要,不能只写“使用SRS 6”。
三、配置SRS并完成本机验证
1. 编写最小可用配置
以下写入会覆盖同名文件,因此仅在新目录或已完成备份的目录执行。
sudo tee /opt/srs/srs.conf > /dev/null <<'EOF'
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 2;
hls_window 12;
}
http_remux {
enabled on;
mount [vhost]/[app]/[stream].flv;
}
}
EOF
配置的作用分别是:
- RTMP监听1935端口。
- HTTP API提供状态查询,但不向公网发布。
- HTTP服务提供HLS文件和HTTP-FLV流。
- HLS按约2秒目标时长切片,保留约12秒播放窗口;实际切片还受视频关键帧位置影响。
- 日志输出到容器标准输出,便于统一查看。
max_connections 1000只是连接数量上限,不代表当前服务器已经具备1000路播放能力。
2. 编写Compose配置
sudo tee /opt/srs/compose.yaml > /dev/null <<'EOF'
services:
srs:
image: ${SRS_IMAGE}
restart: unless-stopped
command: ["./objs/srs", "-c", "conf/srs.conf"]
ports:
- "${MEDIA_BIND_IP}:1935:1935/tcp"
- "${MEDIA_BIND_IP}:8080:8080/tcp"
- "127.0.0.1:1985:1985/tcp"
volumes:
- ./srs.conf:/usr/local/srs/conf/srs.conf:ro
logging:
driver: json-file
options:
max-size: "10m"
max-file: "3"
EOF
该配置只挂载配置文件,没有持久化HLS切片。容器重建后,旧切片可能消失;对于本教程的直播验证,这是预期行为。如果业务需要录像归档,应单独规划存储、保留周期和磁盘告警,不能把直播切片目录直接视为录像库。
先检查Compose解析结果,再检查SRS语法:
cd /opt/srs
sudo docker compose config
sudo docker compose run --rm --no-deps srs \
./objs/srs -t -c conf/srs.conf
两条命令都应正常结束。若出现未知配置项、路径不存在或语法错误,应先修复配置,不要通过反复重启掩盖问题。
3. 启动并检查进程状态
cd /opt/srs
sudo docker compose up -d
sudo docker compose ps
sudo docker compose logs --tail=80 srs
curl -fsS http://127.0.0.1:1985/api/v1/versions
成功时,容器应处于运行状态,API返回JSON,通常包含code为0以及版本字段。
继续检查端口发布:
sudo docker compose port srs 1935
sudo docker compose port srs 8080
sudo docker compose port srs 1985
此时三个结果均应指向127.0.0.1。需要注意:容器运行、API可访问,只能证明服务启动,不能证明已经收到媒体流。
四、推送测试流并验证三种播放方式
1. 选择测试访问方式
最稳妥的初次验证方式是SSH隧道。在客户端电脑执行,将示例地址替换为真实服务器地址,用户名和SSH端口也按实际情况填写:
ssh -N \
-L 1935:127.0.0.1:1935 \
-L 8080:127.0.0.1:8080 \
-L 1985:127.0.0.1:1985 \
admin@203.0.113.10
203.0.113.10仅为文档示例地址,不能直接用于连接。保持该窗口运行;客户端对应端口如已占用,应修改-L左侧端口,并同步修改后面的测试地址。
隧道方式可以验证完整媒体链路,但不能证明公网1935和8080端口已正确放行。如果还要验证直接公网访问,应先在安全组中:
- 允许推流端公网IP访问TCP 1935。
- 允许测试播放端公网IP访问TCP 8080。
- 如需公网RTMP拉流,也允许该拉流端IP访问TCP 1935。
- 不开放1985端口。
规则设置后,在服务器执行:
cd /opt/srs
sudo cp -a .env .env.before-public
sudo sed -i 's/^MEDIA_BIND_IP=.*/MEDIA_BIND_IP=0.0.0.0/' .env
sudo docker compose up -d --force-recreate srs
sudo docker compose ps
sudo docker compose port srs 1985
重建会中断现有媒体连接,应在尚未承载业务时操作。1985仍应只发布到127.0.0.1。公网入口验证完毕后,可按文末方法恢复回环绑定。

2. 使用FFmpeg推送测试流
在客户端安装FFmpeg,并确认具备H.264编码器:
ffmpeg -version
ffmpeg -hide_banner -encoders | grep libx264
Windows可在编码器列表中查找libx264,不必照搬grep命令。
以下命令适用于常见Linux或macOS终端,会生成720p测试画面和测试音频。编码消耗发生在客户端,结束时按Ctrl+C:
ffmpeg \
-re -f lavfi -i "testsrc2=size=1280x720:rate=25" \
-re -f lavfi -i "sine=frequency=1000:sample_rate=48000" \
-c:v libx264 -preset veryfast -tune zerolatency \
-pix_fmt yuv420p -b:v 2500k -maxrate 2500k -bufsize 5000k \
-g 50 -keyint_min 50 -sc_threshold 0 \
-c:a aac -b:a 128k -ar 48000 \
-f flv rtmp://127.0.0.1:1935/live/check01
使用SSH隧道时保留127.0.0.1;直接公网测试时,将其替换为服务器公网IP。
本例每秒25帧、每50帧设置关键帧,目标关键帧间隔为2秒,与HLS切片设置配合。成功推流时,FFmpeg中的frame和time应持续增加,没有持续重连或写入失败。
使用OBS时,可选择自定义流媒体服务:
- 服务器:
rtmp://服务器地址:1935/live - 串流密钥:
check01 - 视频编码:H.264
- 音频编码:AAC
- 关键帧间隔:2秒
这里的check01只是流名称,不是密码或鉴权令牌。本配置没有启用业务鉴权,不能把“地址不容易猜到”作为安全措施。
3. 验证服务端确实收到流
保持推流运行,在服务器执行:
curl -fsS http://127.0.0.1:1985/api/v1/streams/
sudo docker compose -f /opt/srs/compose.yaml \
--project-directory /opt/srs logs --tail=100 srs
API响应的streams列表应出现对应流,通常可看到应用名live、流名check01及媒体相关信息。若列表为空,应先检查推流客户端是否仍在运行、目标地址是否正确。
4. 验证RTMP拉流
在另一个客户端终端执行:
ffprobe -v error \
-show_entries stream=codec_name,codec_type,width,height \
-of json \
rtmp://127.0.0.1:1935/live/check01
预期能识别H.264视频和AAC音频,视频分辨率为1280×720。再验证能否持续解码:
ffmpeg -hide_banner \
-i rtmp://127.0.0.1:1935/live/check01 \
-t 10 -f null -
预期约10秒后正常结束,处理帧数持续增长,而不是只有连接成功提示。
5. 验证HTTP-FLV与HLS
HTTP-FLV地址为:
http://127.0.0.1:8080/live/check01.flv
验证实际读取和解码:
ffmpeg -hide_banner \
-i http://127.0.0.1:8080/live/check01.flv \
-t 10 -f null -
HTTP-FLV是持续响应,不能只凭浏览器能否直接打开来判断成功。浏览器播放通常需要合适的播放器组件。
保持推流约十几秒,再检查HLS播放列表:
curl -fsS http://127.0.0.1:8080/live/check01.m3u8
响应应包含#EXTM3U、媒体序列和.ts分片地址。等待几秒重复请求,媒体序列或分片列表应向前推进。
进一步验证:
ffmpeg -hide_banner \
-i http://127.0.0.1:8080/live/check01.m3u8 \
-t 10 -f null -
也可以用VLC打开该地址进行视听检查。听到的是测试音,建议先调低音量。
媒体链路验收至少应包含:推流持续发送、服务端能查询到活动流、播放端能持续解码。 仅有端口连通、HTTP 200或播放列表存在,都不足以单独证明直播链路正常。

五、常见异常处理与上线边界
1. 按低风险顺序定位失败位置
| 现象 | 优先核对 | 结果说明与处理 |
|---|---|---|
| 公网连接超时 | 客户端公网IP、安全组、服务器实际地址 | 本机可用而公网超时,优先查访问路径和来源规则 |
| 立即拒绝连接 | docker compose ps、发布地址和日志 | 容器可能退出,或端口仍绑定回环地址 |
| 推流正常但API无流 | 推流URL、应用名、流名 | 确认推流发往本实例,而非旧地址 |
| RTMP正常但HTTP-FLV失败 | HTTP服务、http_remux、播放路径 | 检查配置是否加载,以及8080是否可达 |
| HLS开始时404 | 推流持续时间、编码、关键帧间隔 | 等待切片生成,再看日志是否有写入或封装错误 |
| 有画面但无声音 | 源端音轨和AAC编码 | 先用ffprobe确认流中是否存在音频 |
| 持续卡顿 | 客户端上行、服务器出口、CPU和播放器缓存 | 分别检查,不要直接认定SRS性能不足 |
服务器上可用以下命令检查容器资源和近期日志:
cd /opt/srs
sudo docker stats --no-stream
sudo docker compose logs --since=10m srs
df -h /
若容器反复重启,先查配置语法、文件挂载和退出日志,再考虑资源不足。不要一开始就重启Docker服务,因为这可能影响服务器上的其他容器。
HLS存在切片和播放器缓冲,延迟通常高于RTMP、HTTP-FLV。不要仅通过不断缩短切片时间追求低延迟;应同时检查编码关键帧、播放器缓冲和网络抖动。
2. 公网业务需要补齐的条件
本教程配置适合验证和受控访问,不应直接作为匿名开放直播平台使用。对外提供服务前,应补齐:
- 推流和播放鉴权,必要时通过SRS HTTP回调与业务系统对接。
- HTTPS入口,避免HTTPS网页加载HTTP媒体时产生混合内容问题。
- 管理API隔离,禁止将1985直接开放给不受信任的网络。
- 容器、日志和业务指标监控,以及明确的告警阈值。
- 按实际观看地区测量播放成功率、启动时间和卡顿情况。
带宽估算应按出站播放流量计算。例如每路音视频合计约3Mbps、10个观众各拉取一路,则媒体出口约为:
3Mbps × 10 = 30Mbps
按20%余量估算:30Mbps × 1.2 = 36Mbps
这里的Mbps是兆比特每秒,不是MB/s;36Mbps按十进制换算约为4.5MB/s。以上未精确计入封装与传输开销,也不包含额外录像、回源和多码率分发。
服务器套餐是否满足需求,应核对实际出口限速、共享或独享方式,以及峰值流量表现,不能只看端口标称速率。
六、验收与回滚检查项
1. 部署验收清单
- [ ] 已记录Ubuntu版本、SRS版本与镜像摘要。
- [ ] Compose和SRS配置检查通过,容器没有反复重启。
- [ ] 1985只绑定回环地址,公网访问受来源规则控制。
- [ ] 推流持续运行,API中能查到
live/check01。 - [ ] RTMP和HTTP-FLV均能持续读取并解码。
- [ ] HLS播放列表持续更新,分片能够获取和解码。
- [ ] 使用实际观看网络完成画面、声音与卡顿检查。
- [ ] 在无业务窗口重建容器后,重新推流并确认能够恢复。
- [ ] 已明确鉴权、HTTPS、监控和带宽容量的上线责任。
2. 收回公网入口
仅停止推流不会关闭媒体端口。测试结束后,如需恢复为仅本机访问:
cd /opt/srs
sudo cp -a .env ".env.before-loopback.$(date +%Y%m%d-%H%M%S)"
sudo sed -i 's/^MEDIA_BIND_IP=.*/MEDIA_BIND_IP=127.0.0.1/' .env
sudo docker compose up -d --force-recreate srs
sudo docker compose port srs 1935
sudo docker compose port srs 8080
该操作会中断现有连接。随后删除安全组中本次新增的媒体端口规则,并从另一台外部设备确认无法再直接访问。只检查本机配置,不足以完成公网暴露检查。
3. 回滚配置或停止部署
后续修改配置前,先建立带时间戳的备份:
cd /opt/srs
BACKUP="backup-$(date +%Y%m%d-%H%M%S)"
sudo mkdir "$BACKUP"
sudo cp -a srs.conf compose.yaml .env "$BACKUP/"
echo "$BACKUP"
如果变更失败,将backup-YYYYMMDD-HHMMSS替换为实际备份目录,恢复三份文件:
cd /opt/srs
sudo cp -a backup-YYYYMMDD-HHMMSS/srs.conf .
sudo cp -a backup-YYYYMMDD-HHMMSS/compose.yaml .
sudo cp -a backup-YYYYMMDD-HHMMSS/.env .
sudo docker compose config
sudo docker compose run --rm --no-deps srs \
./objs/srs -t -c conf/srs.conf
sudo docker compose up -d --force-recreate srs
恢复前应先停止测试推流,并确认备份中的镜像摘要仍可用。恢复后重新执行API查询与媒体解码验证;配置文件恢复成功并不等于业务已经恢复。
若不再保留本次部署,可停止并移除本项目容器及其网络:
cd /opt/srs
sudo docker compose down
该命令保留主机上的配置文件,但容器内未持久化的HLS切片会随容器移除而丢失。不要顺手执行全局容器清理或卸载Docker,以免影响其他业务。最终应确认本项目容器已停止、临时安全组规则已撤销、测试推流已结束,配置备份与镜像摘要已留存。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/3421.html

