媒体节点

概念说明

媒体节点用于管理视频中心背后的流媒体服务（ZLM）。每个节点都是一台对接好的 ZLM 流媒体服务，负责把设备推上来的视频流转成浏览器可播放的画面。平台按租户独立维护节点，同一租户配置多个节点时会自动组成负载集群——每次取流时，平台都会选取当前并发数最低的在线节点来承载，从而分摊负载、提升稳定性。

媒体节点只承载媒体流，与负责 SIP 信令接入的【信令节点】职责分离、各自独立扩展：信令节点决定设备从哪里注册接入，媒体节点决定视频流落在哪台 ZLM。本页是新增、编辑、查看媒体节点的入口；信令节点的查看与管理见 信令节点。

一、进入媒体节点

进入【视频中心】>【媒体节点】，页面以卡片展示当前租户下的所有媒体节点（ZLM），卡片底色随在线 / 离线状态变化，便于区分。

媒体节点（默认节点卡片）

二、卡片信息说明

每张节点卡片展示以下信息，帮助你快速掌握节点的运行状况：

• 节点名称：节点的显示名称，以标签形式展示，点击即可进入编辑。
• 节点编码：节点的唯一标识，必须与该 ZLM 的 mediaServerId 一致。
• 节点地址：平台访问该 ZLM 的地址。
• 是否启用：显示「启用」或「禁用」。禁用的节点不再参与取流的负载选择。
• 在线状态：显示「在线」或「离线」，依据节点上报的心跳判定。
• 并发数：当前节点正在承载的取流路数，以「N 路」展示，是负载选择的依据。
• 最近心跳：节点最近一次上报心跳的时间，可据此判断节点是否失联。

提示

并发数越低，表示该节点负载越轻。平台取流时优先选择并发数最低的在线节点，因此一般无需手动干预负载分配。

三、新建节点

点击页面右上角的【新建节点】按钮，从右侧滑出媒体节点配置抽屉。表单按用途分为四个分组，逐项填写后点击【保存】即可创建。

新建节点抽屉

3.1 基本信息

• 节点名称：必填，便于识别的显示名称，例如「主媒体节点」。
• 节点编码：必填，节点的唯一标识，必须与该 ZLM 的 config.ini 中 general.mediaServerId 完全一致。心跳上报与流回调都按此值匹配节点，填错会导致节点无法上线或取流失败。
• 是否启用：选填，默认为「启用」。停用后该节点不再参与取流的负载选择，但已经落在该节点上的在途会话不受影响。

3.2 接入地址与端口

这一组配置平台如何访问 ZLM 的管理接口（REST API）。

• 节点地址：必填，平台访问 ZLM REST API 的地址。同机部署可填 127.0.0.1；Docker 部署填宿主机或容器网络可达的 IP。
• HTTP 端口：必填，ZLM 的 HTTP API 端口，默认 80。使用 Docker 端口映射时，填对外映射的端口（例如映射 8800:80 则填 8800）。
• 内网 HTTP 端口：选填，默认 0。ZLM 进程经回环地址（127.0.0.1）自访问的端口，用于截图等内部拉流。当 Docker 映射端口与容器内端口不一致时，须填容器内的端口（通常为 80）；留 0 则回退使用上面的 HTTP 端口。
• 节点密钥：新增时必填，对应 ZLM config.ini 中 [api] 的 secret，平台每次调用 REST API 都据此鉴权；编辑时留空表示保持原密钥不变。

3.3 收流配置（设备 → ZLM）

这一组配置设备如何把视频流推送到 ZLM。

• RTP 收流端口：选填，默认 10000。填固定端口即启用「单端口收流」，所有取流共用此端口、由 ZLM 依 SSRC 分流，Docker 环境只需放行这一个端口（该值须与 ZLM config.ini 中 [rtp_proxy] 的 port 一致）；留空（0）则由 ZLM 为每路流动态分配独立端口，此时 Docker 需放行整个端口段。两种模式的机制详见 配置详解 §3.5。
• TCP 被动收流：选填，默认「是（TCP 被动）」。选「是」时由 ZLM 监听端口、设备主动连入，在 NAT（内外网穿透）场景下更稳定；选「否（UDP）」则走 UDP 收流。此项只影响视频流的传输方式，与设备信令的连接方式无关。
• SDP 媒体地址：选填。下发给设备、供其推送视频流的媒体 IP，必须是设备网络能够路由到的地址。留空则回退使用「节点地址」。

3.4 拉流配置（浏览器 ← ZLM）

这一组配置浏览器如何从 ZLM 拉取视频流进行播放。

• HTTP 拉流地址：选填。浏览器侧的拉流地址，前端会据此拼接播放地址，必须是浏览器能够访问到的地址。留空则回退使用「节点地址」。
• SSL 拉流端口：选填，默认 0。对应 ZLM 的 http.sslport。配置后平台会按加密方式（https/wss）生成拉流地址；当管理端通过 HTTPS 访问时必须配置，否则浏览器会因「混合内容」拦截普通拉流。留 0 走非加密拉流。
• RTMP 端口：选填，默认 1935。ZLM 的 RTMP 拉流端口，用于回填流会话的 RTMP 地址。

注意

• 节点地址、SDP 媒体地址、HTTP 拉流地址 三者分别面向不同对象：节点地址给平台访问管理接口，SDP 媒体地址给设备推流，HTTP 拉流地址给浏览器播放。Docker、内外网混合等部署场景下三者可能并不相同，请按各自可达性分别填写。
• 媒体节点配置须与对应 ZLM 的 config.ini 保持对应，配置不一致会导致节点上线、设备推流或浏览器播放失败。

四、编辑节点

点卡片上的节点名称标签（或操作区的编辑按钮）弹出与新建一致的抽屉，载入现有配置，按需修改后【保存】。不更换密钥时把节点密钥留空即保持原值不变。

五、删除节点

在节点卡片操作区点【删除】并确认即可移除该节点。

危险操作

• 节点上若仍有正在进行的取流会话（在途会话），后端会校验并拒绝删除、删除请求失败，需等会话结束后再操作。
• 删除节点会使该节点退出负载集群，后续取流将由其余在线节点承载；请确认仍有可用节点后再删除，避免影响视频播放。