流媒体与实时通信 / 系统课时

推流地址如何映射到目标源站

推流地址如何映射到目标源站

推流 URL 不只是“服务器地址”,它通常同时携带应用名、流名和查询参数。把这些字段解析成稳定的流标识,再映射到主播、直播间和源站实例,才能正确接入、排查冲突并支持路由迁移。

学习目标

  • 能从 RTMP 推流 URL 中识别 host、应用名、流名和查询参数,并生成统一流标识。
  • 能设计“主播 → 直播间 → stream key → 源站”的映射规则,避免流名冲突和非法路径。
  • 能在路由发生变化时区分鉴权问题、命名问题和源站选择问题,并完成验证。

先拆开推流 URL

以常见 RTMP 地址为例:rtmp://ingest.example.com/live/room-10086?token=abc123&region=us-west。可以把它拆成四类信息:协议是 rtmp,接入主机是 ingest.example.com,应用名是 live,流名是 room-10086,查询参数则包含鉴权或路由提示。

真正用于业务路由的通常不是完整 URL,而是标准化后的复合键,例如 live/room-10086。token 这类参数一般用于鉴权,不应直接拼进持久化的直播间 ID;否则同一个流仅因 token 更新,就会被误判成不同流。

推流URL字段拆解与流标识映射关系图

下面的 Python 示例只负责解析字段,不代表完整的鉴权服务。它适合先验证“解析结果是否符合路由规则”。

python
from urllib.parse import urlparse, parse_qs

url = "rtmp://ingest.example.com/live/room-10086?token=abc123&region=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])

预期输出

text
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。随后用新的连接建立流程验证四件事:鉴权仍通过、流名仍一致、新源站出现发布会话、旧源站不再接受同一租约的结束操作。

排障时可以按这个顺序检查:

  1. 解析日志中确认 app 和 stream 是否正确,尤其检查是否多了一层路径或出现 URL 编码差异。
  2. 检查标准化后的 streamKey 是否已经被其他活跃会话占用。
  3. 检查主播与直播间、streamKey 的绑定关系,确认 token 对应的是当前直播主体。
  4. 检查源站选择记录,确认目标 originId 处于健康、可发布状态。
  5. 检查发布会话的 sessionId 与租约时间,排除旧连接清理新会话的问题。

一个容易忽略的边界是重连。主播网络抖动后,新的连接可能携带新 token,但仍应解析成同一个 streamKey。因此“token 是否变化”和“是不是同一条业务流”必须分开判断。只要业务绑定没有变化,就应沿用原直播间与流标识,再创建新的发布会话。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

推流地址如何映射到目标源站

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通