StreamLink 概述
StreamLink 在现场编码器 / 演播室 / 云处理系统之间传输直播信号。本文档先介绍控制台的菜单,再按 Event → Flow → Input → Output 的顺序配置传输路径。按分辨率转码在 StreamLive 中执行,面向观众的 HLS 分发在 StreamPackage 和 CDN 中配置。
控制台菜单导航
| 菜单 / 页面 | 作用 | 此处执行的任务 |
|---|---|---|
| Flow 的 Event 列表 | 按活动 / 服务划分的传输路径集合 | Create event、选择 Event、进入 Flow management |
| Flow management | 管理归属于 Event 的各条传输路径 | 创建 Flow、连接 Input / Output、单独启动 / 停止 |
| Security Group | 管理输入 / 输出允许访问的 IP | 注册推流方或接收方的公网 IP 范围 |
| Usage statistics | 用量查询 | 按查询周期与对象查看传输用量 |
| Gateway | 管理 Gateway 配置 | 在使用 Gateway 的传输设计中配置 |
Event 是管理集合,Flow 是传输路径。创建 Input 和 Output 后即可确认推流 / 接收的连接端点。
1. Event 创建与选择
在 StreamLink 控制台中选择 Create event。名称填写活动或服务的标识值,描述填写用途。例如可以使用 demo_event 和 Encoder to processing service。

选择已保存 Event 的 Flow management。Start all 会影响 Event 内的多个 Flow,因此初次操作时请使用单个 Flow 的启动按钮。

截图中的名称 / 地域 / 输入值仅是用于页面说明的示例。请按实际使用的传输路径进行设置。
2. Flow 创建
在 Flow management 中选择 Create,创建传输路径。

| 输入框 | 设置方法 | 注意事项 |
|---|---|---|
| Flow name | demo_flow 等用于标识路径的名称 | 主 / 备路径通过名称区分 |
| Max bandwidth | 需能容纳原始码率与传输余量的取值 | 除视频外,还需考虑音频 / 开销及波动量 |
| Region | 配置该输入路径的地域 | 需考虑推流设备的位置与网络路径 |
API 的 MaxBandwidth 以 bps 为单位。创建后确认状态与 Flow 名称,然后添加 Input。
3. 支持的输入协议与选择标准
下表以官方控制台指南中的输入类型为准。随账号 / 服务更新可能会显示更多类型,因此请同时确认实际控制台与 API 版本的支持范围。
| 输入协议 | 源信号接入方式 | 主要使用场景 |
|---|---|---|
| SRT Listener | 推流设备以 Caller 身份连接到 StreamLink | 接收外部编码器的 SRT Push |
| SRT Caller | StreamLink 连接到源端 Listener | 从处于等待接收状态的 SRT 源拉取 |
| RTMP_PUSH | 编码器推送到已生成的输入地址 | 连接 RTMP 推流软件 / 设备 |
| RTMP_PULL | StreamLink 连接到源端 RTMP 地址 | 从外部 RTMP 源拉取 |
| RTP | 推流方推送到已生成的输入地址 | 连接基于 RTP 的设备 |
| RTSP_PULL | StreamLink 连接到源端 RTSP 地址 | 对接 RTSP 源 |
| RIST Listener | 接收源端 Caller 的连接 | 连接支持 RIST 的推流设备 |
SRT 的 Caller/Listener 表示由谁发起连接。输入 / 输出表示数据方向,Caller / Listener 表示建立连接的角色,二者需区分开。
4. 添加 Input
选择 Flow 并打开 Add input。选择名称、协议、输入地域 / 可用区后,再配置该协议对应的字段。

| 所选方式 | 需准备的值 |
|---|---|
| Push 或 Listener | 实际推流公网 IP、允许策略、所需的加密设置 |
| Pull 或 Caller | 源地址 / 端口、所需的 Stream Key 或 Stream ID、源端认证信息 |
| SRT | 连接角色、延迟缓冲区、加密密钥与密钥长度 |
| 支持 Failover 的输入 | 向生成的两个地址发送的主 / 备推流及切换验证计划 |
IP 允许列表属于访问限制,加密则用于保护传输内容。保存输入后,可在 Addresses 中确认推流所需的地址。
5. 输出协议与连接方向
先确认输入与输出支持的组合。
| 输入类型 | 官方控制台指南中的输出类型 |
|---|---|
| RTMP_PUSH / RTMP_PULL | RTMP_PUSH、RTMP_PULL、SRT |
| SRT | SRT、RTMP_PUSH、RTMP_PULL |
| RTP | RTP |
| RTSP_PULL | RTSP_PULL |
| RIST | RIST |
| 输出方式 | 发起连接的一方 | 需配置的目的地 |
|---|---|---|
| RTMP_PUSH | StreamLink | 接收平台的 URL 与 Stream Key |
| RTMP_PULL | 接收系统 | 将 StreamLink 生成的地址填入接收系统 |
| SRT Caller | StreamLink | 对端 Listener 的地址 / 端口 / Stream ID |
| SRT Listener | 接收系统的 Caller | StreamLink 生成的输出地址 |
连接 StreamLive 的 RTMP_PUSH 输入时,使用 StreamLink 的 RTMP_PUSH 输出。用于推流的 StreamLink Input 地址与目的地 StreamLive 的 Input 地址是两个不同的地址。
6. 添加 Output 与并发连接数
在 Add output 中指定输出类型、名称、地域 / 可用区、协议与目的地。

| 输出类型 | 用途与限额 |
|---|---|
| Pinpoint | 每个输出 1 个 路 Push 或最多 4 个 路 Pull。按协议分别适用连接数限制 |
| MultiMesh | 供多个接收方 Pull 的 SRT Listener 输出。官方文档说明 Pull 数量没有限制,但仍需进行访问控制与用量管理 |
据官方文档,Pinpoint RIST Listener 支持并发 Pull 1 个。输出节点与连接数增加,费用也会随之变化。
7. 启动 / 日志 / 状态确认
选择 Flow 的 Start 后,开始源端推流与目的地接收。目的地服务器或接收端必须已准备就绪。
| 页面 | 需确认的内容 |
|---|---|
| Addresses | 输入 / 输出地址、节点 IP、端口、协议 |
| Log | 连接 / 断开 / 重连及响应记录 |
| Health | 输入 / 输出码率、各协议的丢包 / 重传指标 |
| 接收系统 | 实际视频 / 音频、卡顿与延迟 |
分别确认输入信号、输出传输以及接收系统的播放情况。
各功能详细步骤
- Event 与 Flow 基本设置
- SRT Input / Output 配置
- RTMP Input / Output 配置
- Flow 启动 / 停止
- 地址 / 日志 / Health 确认
- 输入 / 输出变更
- 主 / 备冗余与切换验证
- API / CLI
结束与官方文档
测试结束后,请清理该 Flow 及专用资源。以 Event 为单位的操作,请先确认其中包含的 Flow 列表后再进行。