4. 推流并确认播放
向前三步中配置的传输路径发送测试信号,然后依次确认 StreamPackage 源站与 CSS CDN。
准备工作
- 确认 StreamLink Flow 与 StreamLive 频道已处于启动状态。
- 准备 StreamLink 输入的实际推流地址。
- 准备 StreamPackage Endpoint URL 与 CSS 播放 URL。
- 确认推流 IP 允许策略、所需的认证信息、DNS 与 HTTPS 证书。
- 准备 FFmpeg / ffprobe / ffplay 或 OBS 与 HLS 播放器。
以下 URL 仅用于说明。
1. 发送测试信号
在 OBS 中,输入与 StreamLink 输入设置相匹配的服务器地址和串流密钥,然后开始推流。如果使用 FFmpeg,可以按如下方式发送视频测试图案与 440Hz 测试音。播放测试音前请先调低音量。
STREAM_PUSH_URL='rtmp://YOUR_STREAMLINK_HOST/YOUR_APP/YOUR_STREAM_KEY'
ffmpeg -re \
-f lavfi -i "testsrc=size=1920x1080:rate=30" \
-f lavfi -i "sine=frequency=440:sample_rate=48000" \
-c:v libx264 -preset veryfast -b:v 4000k -maxrate 4000k -bufsize 8000k \
-pix_fmt yuv420p -g 60 \
-c:a aac -b:a 128k -ar 48000 \
-f flv "$STREAM_PUSH_URL"检查 FFmpeg 日志中的推流帧数与时间、StreamLink 输入地址 / 协议 / 端口 / 允许 IP,以及目的地的接收状态。
2. 确认传输与处理状态
| 环节 | 确认内容 |
|---|---|
| 编码器 → StreamLink | 输入连接与接收状态 |
| StreamLink → StreamLive | Flow 输出目的地与 StreamLive 输入接收状态 |
| StreamLive → StreamPackage | 输出组、目标频道 ID、输出状态 |
| StreamPackage → CDN | 域名连接、双向服务权限、源站访问策略 |
同时确认 RUNNING 状态、输入 / 输出指标与最终播放。
3. 确认源站主播放列表
STREAM_ORIGIN_URL='https://YOUR_PACKAGE_HOST/YOUR_ENDPOINT_PATH/index.m3u8'
curl --fail-with-body --show-error --silent --max-time 20 "$STREAM_ORIGIN_URL"如果已配置端点认证,请另行应用该请求所需的请求头或认证信息。
以下是包含两种分辨率的列表格式示例。文件名与数值会随实际配置而不同。
#EXTM3U
#EXT-X-STREAM-INF:BANDWIDTH=2128000,RESOLUTION=1280x720,FRAME-RATE=30.000
720p.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=4128000,RESOLUTION=1920x1080,FRAME-RATE=30.000
1080p.m3u8如果能看到这两项,说明主列表中已声明两路输出。要确认各路输出的视频是否正常,需要一直查到媒体列表与实际分片。
4. 确认媒体列表与分片
以实际主列表 URL 为基准解析主列表中写明的媒体列表 URI。如果只有文件名,则以同一目录为基准;如果以 / 开头,则以同一主机的根目录为基准。如果是完整 URL,则直接使用该地址。
STREAM_MEDIA_URL='https://YOUR_PACKAGE_HOST/YOUR_ENDPOINT_PATH/720p.m3u8'
curl --fail-with-body --show-error --silent --max-time 20 "$STREAM_MEDIA_URL"每隔几秒重新确认以下格式的列表。
#EXTM3U
#EXT-X-TARGETDURATION:4
#EXT-X-MEDIA-SEQUENCE:100
#EXTINF:4.000,
segment100.ts
#EXTINF:4.000,
segment101.ts- 确认直播推流过程中是否有新的分片加入。
- 在滑动列表中,确认 MEDIA-SEQUENCE 是否随时间递增。
- 确认列表中记录的分片 URL 是否实际可访问。
- 确认
720p与1080p中是否各自包含视频 / 音频。
ffprobe -v error -show_entries stream=codec_type,codec_name,width,height,r_frame_rate \
-of json "$STREAM_MEDIA_URL"ffprobe 结果用于确认媒体格式。是否存在黑屏、静音、卡顿,需要通过实际播放另行确认。
5. 通过 CDN 确认播放
对连接到 StreamPackage 的 CSS 播放 URL 重复同样的检查。
STREAM_CDN_URL='https://YOUR_PLAYBACK_DOMAIN/YOUR_ENDPOINT_PATH/index.m3u8'
curl --fail-with-body --show-error --silent --max-time 20 \
--dump-header - --output /dev/null "$STREAM_CDN_URL"
ffplay "$STREAM_CDN_URL"确认播放器中是否播放了视频测试图案与测试音,以及在一段时间内是否无中断地持续播放。由于自动画质选择可能只播放其中一种分辨率,因此也要分别检查各个媒体列表。
HTTPS 播放需通过有效的证书 / 主机名 / 证书链来确认。
故障环节区分
| 现象 | 优先确认 |
|---|---|
| StreamLink 输入 — | 编码器推流地址 / 密钥、协议、防火墙与允许 IP |
| StreamLive 输入 — | Flow 输出地址与 StreamLive 安全组 |
源站列表 404 | 端点路径、源站是否在推流、输出目的地 |
源站或 CDN 出现 403 | 请求引用对象的权限、请求头 / 查询认证、IP 限制、域名连接 |
| 主列表正常 / 媒体结果确认 | 媒体 URI 解析、路径与认证信息 |
| 媒体正常 / 分片结果确认 | 分片 URI 与访问策略、已缓存列表的有效性 |
| 列表更新中断 | 源站推流、输入 / 输出状态、列表缓存 |
| 源站播放 / CDN 结果确认 | CSS 源站访问权限、Host / 路径 / 认证传递、DNS / TLS |
| 只有视频播放而没有声音 — | 源站音频轨、音频选择与输出模板 |
同时确认该请求的主机 / 路径 / 响应 / 各环节日志。
完成标准
- 在 StreamLink 与 StreamLive 中确认源站接收与输出投递
- 确认 StreamPackage 主列表中包含所需的分辨率列表
- 确认各媒体列表的更新与分片可访问
- 在源站与 CSS CDN 中确认实际视频 / 音频播放
- 确认播放过程中的输入 / 输出状态与连续播放
结束测试
FFmpeg 请在其运行的终端中按 Ctrl+C 结束推流。之后停止用于测试的 StreamLink Flow 与 StreamLive 频道。删除为可选操作,请先确认是否为共享资源以及相关依赖关系。
同时确认运行资源与存储 / 传输用量。