ZLMediaKit 多路无人机流管理与分发架构

一、ZLMediaKit 在无人机网站中的定位

ZLMediaKit 的职责边界：

二、多路无人机接入方案

1️⃣ 流命名规范 & 使用者痛点：命名混乱导致查询困难、权限失控。

统一命名规则可让管理员快速定位并授权。不过，

rtmp://服务器IP:/{app}/{stream}
app 命名：uav // 所有无人机统一 app
stream 命名：{无人機ID}_{码流类型}
再看示例，rtmp://server:/uav/uav_001_main # 1号主码流
至于rtmp。//server:/uav/uav_001_sub # 1号辅码流
rtmp的观点是，//server:/uav/uav_002_main # 2号主码流
rtmp这方面，//server:/uav/uav_002_sub # 2号辅码流

• 按 ID 查询清晰明了；痛点：易被误删或泄露。
• 主/辅区分便于按需拉取；痛点：频繁切换导致延迟波动。
• 统一前缀简化鉴权配置；其实，痛点：鉴权失误导致非法访问。

2️⃣ 流注册与发现 & 使用者痛点：手动维护列表效率低、错误率高。

ZLMediaKit 自动注册新上线的推流，并通过 REST API 查询当前在线状态。

# 查询所有媒体流列表
curl "http://服务器IP:/index/api/getMediaList?secret=你的secret"
# 返回示例
{
"code"的观点是，,"data":
}

• originType: 推送方式；痛点： 不同源混合导致兼容性问题。
• readerCount: 当前观看人数，用以判断是否开启转码。痛点： 人少时仍占用资源。
• aliveSecond: 活跃时间，用于超时清理。痛点： 网络波动造成误判掉线。其实，

3️⃣ 流上线/下线钩子 & 使用者痛点：人工干预慢、错误频繁。

ZLMediaKit 支持 WebHook 通知后端自动更新状态并触发转码决策。

// config.ini 中配置
enable=on_stream_changed=http://后端服务/api/stream/changed
// 后端接口示例
@PostMapping
public void onStreamChanged {
if )) {
streamService.register。hook.getStream,hook.getOriginUrl);transcodeService.checkAndStart,hook.getStream);} else if )) {
streamService.unregister,hook.getStream);transcodeService.stop,hook.getStream);}
}


*自动化降低运维成本*；痛点：*手动操作导致资源泄漏*。

*即时响应*；减少因延迟造成的使用者体验下降。

*可
性强*，支持多节点同步更新。


三、H265 → H264 按需转码策略 & 使用者痛点：CPU 占用过高、延迟不可控。

1️⃣ 按需启动 & 痛点剖析：


# 当某一路推送没有请求播放时不启动任何 FFmpeg 进程。


*节省 CPU/GPU*

graph TD
A --> B{检测浏览器类型}
B -->|Chrome| C
B -->|Firefox/Safari| D{已存在 H264 转码？按理说，}
D -->|是| E
D -->|否| F
F --> G
G --> E


*减轻 GPU 与 CPU 双重压力*

*保证只有真正需要低延迟渲染时才产生额外开销*

*避免无效编码导致能耗浪费*
**关键字段**:


`readerCount`>0 时才考虑开启 *按需* 或 *全量* 转码策略.

`aliveSecond` 用来监测空闲时间并终止未使用进程.

1️⃣ 主要代码片段
text
curl -X POST http://服务器IP:/index/api/addFFmpegSource \
-d secret=你的secret \
-d src_url=rtmp://.:/uav/uav_001_main \
-d dst_url=rtmp://./uav/uav_001_main_h264 \
-d timeout_ms=60000 \
-d enable_hls=true \
-d enable_mp4=false \
-d ffmpeg_cmd_key=live

命名规范 – 原始 + _h264 后缀方便查找。

1️⃣ FFmpeg 命令模板配置
ini
cmd=%s -re -i %s -c:v libx264 -preset ultrafast -tune zerolatency -g %d -bf %d -b:v %dM ...
若使用 GPU 加速：
ini
cmd=%s -re -i %s -c:v h264_nvenc -preset p1 ...

1️⃣ 转码资源规划表
`

`
单核 + 一块 RTX2070 可轻松支撑 .
`
d colspan=3 bgco lor='#fff'>若采用按需转译，仅在高峰期开启即可.
`…`
`，`
`…`
`，`
`…`
`，`
`t r>`
`t r>`
`t r>`
`t r>`
`t r>`
`t r>`
`

实际经验


单台8核CPU + 一块RTX3080 可支撑约30路实时主稿 + 辅稿，同时最大并发转译约10–12路。

若无GPU。则每台服务器最多可保持15路H265 主稿+10路辅稿，但整体帧率明显下降。

四、多种输出协议选择与分发

🎯 痛点分析


并发路数 
CPU软编码 / GPU硬编码 
推荐配备情况 

1 路 
50% / 20% 











协议
延迟
浏览器原生支持
并发能力
场景




WebRTC
<500 ms
Chrome/Edge/Fox/Safari
高
指挥中心大屏实时操控


HTTP‑FLV
~300 ms
所有现代浏览器 via flv.js
极高
大规模预览


HLS
~5–10 s
Safari/Mobile/Webkit 原生支持
超大
回看录像、大规模广播




📌 按场景选择输出协议
mermaid
graph TD;A-->B{场景}，B-->C;C-->D，B-->E;
E-->F，B-->G;G-->H，B-->I;I-->J，B-->K;K-->L，

🔄 多路同屏调整技巧


小画面辅链在同屏模式下使用 640×360 辅稿降低带宽和 CPU 消耗。

优先 HTTP‑FLV非实时需求采用 FLV，无需保持低延迟。

点击放大切换到 WebRTC默认 FLV 列表，点击选定通道后再切换为实时 WebRTC。怎么说呢，

ini
// 前端逻辑示例
function playStream {
if {
const url = `http://server:/uav/${streamId}.live.flv`;playWithFlvJs;} else if {
const url = `http://server:/index/api/webrtc?app=uav&stream=${streamId}&type=play`;playWithWebRTC;}
}


五、集群部署与负载均衡

⚙️ 集群架构图
mermaid
graph TD;A --> B，B --> C;B --> D，...
C --> F;D --> F，...
C --> G;...
F --> H

🚦 流方法投递问题 & 痛点：


单节点投递失败导致“找不到视频”错误。

因为节点数量增加，同一无人機可能被拆散在不同机器上。


🔑 推荐方法 – Redis 注册中心
kotlin
// 无人机上线时记录映射关系，并设定 TTL
redisTemplate.opsForValue.set(
"stream:${streamId}"。nodeIp,Duration.ofMinutes
)
// 播放请求时查询对应节点 IP 并重定向或代理到源节点
String nodeIp = redisTemplate.opsForValue.get;if return error;return playUrl;

🛠️ 节点健康检查
bash
curl http://节点IP:/index/api/getServerConfig
{
...
"data":
}
结合 LB 的健康探针，可实现故障节点自动剔除。


六、监控与告警 – 防止“灾难级别”卡顿
'
'
'
'
'
'
'
'


指标名称
告警阈值 / 建议动作 
说明 / 痛点评价 
- /n/n/t/n/t/t/t/t/n/t/n/n/n/n/p/s/p/g/m/e/e/e/d/e/p/i/l/d/l/d/a/g/l/k/o/s/g/m/r/r/b/b/c/k/k/r/r/a/a/s/e/e/p/w/x/x/s/d/j/o/m/c/f/g/y/z/z/c/m/q/h/h/k/y/i/i/y/i/k/b/r/f/l/j/j/v/x/a/a/q/s/q/g/q/l/j/h/y/f/s/y/m/h/f/f/w/w/x/w/g/k/p/c/j/k/y/l/b/d/c/g/d/h/i/k/c/o/w/h/l/b/b/p/o/o/q/i/m/v/z/q/x/r/v/x/z/f/h/q/v/z/r/p/w/o/b/l/v/t/g/j/a/e/n/m/d/d/h/z/h/f/w/x/f/k/u/x/n/j/t/q/p/x/c/r/c/f/v/v/a/p/a/r/b/y"







在线流数量下降>10% → “可能出现批量掉线”报警;建议及时排查网络连通性或重启相关节点.;由于无线信号弱或基站拥堵导致断链频繁.;怎么说呢，

⚠️ 确认是否为临时网络抖动还是持续掉线.;


...等请自行补充...
...







✅ 自动断线检测与恢复
less
@Scheduled
public void checkStreamHealth {
List onlineStreams = streamService.getOnlineStreams;for {
// 若最终活跃时间超过阈值则视为断连处理：
if - stream.getLastActiveTime> /*30秒*/) {
streamService.markOffline);// 标记离线
websocketNotify,"stream_offline");// 通知前端画面已断开
 transcodeService.stop,stream.getStreamId);// 清理进程
// 如有备用源，可尝试重连：
// transcod eService.retryOrPullFallback;}
}


}



七、 & 痛点评价表格



常见问题 / 痛点描述 
方法概览 
效果评估 









Bottleneck – 单个节点 CPU 超载或 GPU 接近饱和。根本原因：: 未做按需或超算资源不足。


: 高峰期突然下线或画面卡顿。了解更多实例案例 →🔗︎📰︎📚︎🕒︎▶︎✉︎🔍︎⌨︎❗︎🚫︎🔓︎💰︎👋︎❎︎✏️↔️💬❤➡️🌐︎🗣‍♂️👻👴💟🤝🏿🏆🐦💯👀🚨🙊📢🪜⚡️🥇🥈🥉☑️🧪✳️➤🆓⚡️🟢🔵⚪⬜🌍🌎🌏⏱⏲⌚⌛⏳🏘🚷🚫🚬🚳🎰🎱🎲🎳🎹🍔🍕🍜🍣🍱🍣🍜🍚🍵☕🥤🥢🍺🥃💊💉📍⏴🏮🏁✈️🚀📡🌐✨'
style=
'display:block;color:#999，font-size:.85em;margin-top:.75em;text-align:center;'>阅读更多案例»-->
TD>,TD>,TD>,
TR>









































主要原则的观点是。按需分配资源，不把每条直播都硬编码成最高质量，而是根据真实观看需求动态调度，以有限硬件支撑更大规模的无人机程序运行。如有进一步技术细节需求，请留言讨论或提问！祝你部署顺利 🚀🔥.









按钮样式请自行调整。

祝您项目成功!