流媒体与实时通信 / 系统课时
推流地址如何映射到目标源站
推流地址如何映射到目标源站
推流 URL 不只是“服务器地址”,它通常同时携带应用名、流名和查询参数。把这些字段解析成稳定的流标识,再映射到主播、直播间和源站实例,才能正确接入、排查冲突并支持路由迁移。
学习目标
- 能从 RTMP 推流 URL 中识别 host、应用名、流名和查询参数,并生成统一流标识。
- 能设计“主播 → 直播间 → stream key → 源站”的映射规则,避免流名冲突和非法路径。
- 能在路由发生变化时区分鉴权问题、命名问题和源站选择问题,并完成验证。
先拆开推流 URL
以常见 RTMP 地址为例:rtmp://ingest.example.com/live/room-10086?token=abc123®ion=us-west。可以把它拆成四类信息:协议是 rtmp,接入主机是 ingest.example.com,应用名是 live,流名是 room-10086,查询参数则包含鉴权或路由提示。
真正用于业务路由的通常不是完整 URL,而是标准化后的复合键,例如 live/room-10086。token 这类参数一般用于鉴权,不应直接拼进持久化的直播间 ID;否则同一个流仅因 token 更新,就会被误判成不同流。

下面的 Python 示例只负责解析字段,不代表完整的鉴权服务。它适合先验证“解析结果是否符合路由规则”。
from urllib.parse import urlparse, parse_qs
url = "rtmp://ingest.example.com/live/room-10086?token=abc123®ion=us-west"
parsed = urlparse(url)
path_parts = [part for part in parsed.path.split("/") if part]
if len(path_parts) != 2:
raise ValueError("RTMP 路径必须为 /<app>/<stream>")
app, stream = path_parts
query = parse_qs(parsed.query)
stream_key = f"{app}/{stream}"
print("host=", parsed.hostname)
print("app=", app)
print("stream=", stream)
print("stream_key=", stream_key)
print("region=", query.get("region", [None])[0])预期输出
host= ingest.example.com
app= live
stream= room-10086
stream_key= live/room-10086
region= us-west建立稳定的映射键
一个可落地的映射表可以先做到三层分离:streamKey 负责定位发布流,roomId 负责业务直播间,originId 负责实际承载实例。例如 live/room-10086 → room-10086 → ingest-02。这样源站迁移时只改变 originId,不需要修改主播使用的流地址。
推荐把流名限制为小写字母、数字和短横线,例如 room-10086。同时拒绝空流名、路径段数量异常、包含 .. 的路径以及超长值。这样既方便日志检索,也能避免不同系统对路径规范化产生歧义。
| 字段 | 示例 | 路由用途 | 是否持久化 |
|---|---|---|---|
| app | live |
选择发布协议/业务分区 | 是 |
| stream | room-10086 |
定位发布流 | 是 |
| token | abc123 |
鉴权 | 否,按鉴权系统保存 |
| region | us-west |
候选源站区域 | 可选 |
错误做法是直接用完整 URL 作为主键。这样 token 一变,数据库里可能出现两条看似不同的发布记录;正确做法是先去掉鉴权参数,再用规范化后的 app/stream 形成稳定的流标识。
把流标识映射到源站
源站选择不应只靠“随机挑一台服务器”。实际系统通常先根据区域、容量和当前发布状态筛选候选实例,再建立短期发布会话。例如某主播推流到 us-west,系统发现 ingest-01 当前发布连接数为 680、ingest-02 为 310,而单实例目标上限为 800,则可以优先选择 ingest-02。
建议把“业务映射”和“当前承载”分开保存:业务层记录 room-10086 对应的直播主体,接入层记录当前 publisher session 在 ingest-02。这样源站故障时可以迁移承载关系,而不改变直播间和流名。
路由键还应带版本或租约信息。例如创建发布会话时生成 sessionId=<ID>,同时记录 originId、创建时间和过期时间。收到停止推流请求时,优先检查 sessionId 是否仍然是该 streamKey 的当前会话,避免旧连接在重连后误删新会话。
处理冲突与非法路径
流名冲突最危险的情况是两个主播同时发布相同 streamKey。推荐采用“先鉴权,再原子占用”的顺序:先验证 token 与主播/直播间关系,再尝试独占 streamKey;占用失败直接返回“流正在发布”,而不是把旧会话静默踢掉。
对于非法路径,可以统一在接入层拒绝并记录结构化原因。常见规则是:应用名必须属于白名单,流名长度限制为 1~128 个字符,只允许 [a-z0-9-],查询参数中的 token 单独校验,不能用 region 参数绕过权限检查。
路由变更时怎么验证
源站从 ingest-02 切换到 ingest-03 时,先保持 streamKey=live/room-10086 不变,只更新当前发布会话对应的 originId。随后用新的连接建立流程验证四件事:鉴权仍通过、流名仍一致、新源站出现发布会话、旧源站不再接受同一租约的结束操作。
排障时可以按这个顺序检查:
- 解析日志中确认
app和stream是否正确,尤其检查是否多了一层路径或出现 URL 编码差异。 - 检查标准化后的
streamKey是否已经被其他活跃会话占用。 - 检查主播与直播间、streamKey 的绑定关系,确认 token 对应的是当前直播主体。
- 检查源站选择记录,确认目标
originId处于健康、可发布状态。 - 检查发布会话的
sessionId与租约时间,排除旧连接清理新会话的问题。
一个容易忽略的边界是重连。主播网络抖动后,新的连接可能携带新 token,但仍应解析成同一个 streamKey。因此“token 是否变化”和“是不是同一条业务流”必须分开判断。只要业务绑定没有变化,就应沿用原直播间与流标识,再创建新的发布会话。