From ce246054849b5b797dc4da0a55116238a4c00d7e Mon Sep 17 00:00:00 2001 From: ila <2+ila@noreply.git.ilapage.cn> Date: Fri, 28 Aug 2026 16:01:02 +0800 Subject: [PATCH] docs: record Sense MediaMTX sharding (#77) --- Deployment-and-Operations.-.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/Deployment-and-Operations.-.md b/Deployment-and-Operations.-.md index 9e0855f..55ee077 100644 --- a/Deployment-and-Operations.-.md +++ b/Deployment-and-Operations.-.md @@ -92,3 +92,15 @@ Sense\start_sense.bat 节点超过 90 秒没有心跳即显示离线。离线时页面继续显示最后已知的隧道、视频、负载和回填状态，并标明陈旧时长，这不表示通道仍实时可用。心跳恢复但通道未收敛时显示“恢复中”，应分别检查控制隧道、视频数据面和回填队列。当前版本只提供 Sense 内部投影入口，不包含外部心跳接入协议或跨节点回填执行；没有节点数据时不会自动生成演示节点。 + + +## Sense MediaMTX 分片配置与排错 + +主 MediaMTX 继续使用 `SENSE_MEDIAMTX_MODE`、`SENSE_MEDIAMTX_BINARY`、`SENSE_MEDIAMTX_CONFIG` 和 `SENSE_MEDIAMTX_API`。可选 `SENSE_MEDIAMTX_CAPACITY` 为正整数；留空时使用数据库中的当前统一配额。 + +额外分片通过 `SENSE_MEDIAMTX_SHARDS_FILE` 指向仓库外 JSON 文件。相对路径按 Windows 交付包根目录解析；示例结构见包内 `config\mediamtx-shards.example.json`。每项必须包含唯一 id、名称、本机回环 Control API 和正容量，mode 只能为 external。文件不得包含摄像头账号、密码、数据库连接或其他秘密。 + +额外 MediaMTX 进程由部署方独立启动并为各实例分配不冲突的 API、RTSP 及其他监听端口；Sense 只做健康探测和路径管理，不启停这些外部进程。升级后看不到“媒体分片”时，确认迁移 `2026082814000_media_shard.go` 成功并重新登录刷新动态菜单。 + +页面“运行异常”表示最近一次 Control API 探测失败；“状态已陈旧”表示运行循环已超过 30 秒没有更新探测结果。故障时先在详情定位设备/Profile/路径，不要手工改数据库归属。迁移预检不会执行迁移；任何实际跨分片迁移都必须另建高风险工单和回退方案。 +