多台小米摄像头如何统一管理?micam多实例部署完整攻略
多台小米摄像头如何统一管理?micam多实例部署完整攻略
micam 是一个专为小米摄像头设计的 RTSP 桥接服务(非官方),它能把小米摄像头的视频流转发到标准 RTSP 地址,让 HomeAssistant、Frigate、Go2rtc、Scrypted 等 NVR 和智能家居系统直接接入。本文是 micam 多实例部署完整攻略:在一台服务器上统一管理多台小米摄像头,无需 GPU,纯 Docker Compose 三步跑起来。🎦
一、micam 架构:为什么能统一管理多台摄像头?
小米摄像头官方协议不直接输出 RTSP,而 Miloco 是小米官方的摄像头接入后端。micam 把整套方案封装成三个容器,各司其职:
| 组件 | 角色 | 说明 |
|---|---|---|
| Miloco | 小米账号桥梁 | 绑定小米账号后,统一管理名下所有摄像头,输出 WebSocket 高清视频流 |
| Go2rtc | RTSP 流服务器 | 在 8554 端口汇聚所有 RTSP 流,并提供 WebUI(1984 端口) |
| Micam | 流转发器 | 每台摄像头对应一个实例,把 Miloco 的流写入 Go2rtc 的对应流 |
关键设计:Miloco 全局只跑一个(绑定一次小米账号即可),而 Micam 按摄像头数量横向扩展——每台摄像头一个独立实例、一条独立 RTSP 流。这就是「多实例部署」的核心思想。
转发逻辑在 micam/init.py 的 RTSPBridge.run() 中:登录 Miloco → 连接 WebSocket → 等待关键帧 → 通过 FFmpeg 写入目标 RTSP 地址,断流自动重连。
二、一键部署 micam 多实例模板
micam 仓库的 docker-compose.yml 已经内置了多实例骨架:默认启用 micam1,并预置了一个被禁用的 micam2 模板,扩展起来非常省事。
git clone https://gitcode.com/gh_mirrors/mi/micam
cd micam
docker compose up -d
部署完成后会拉起 4 类容器:miloco、go2rtc、micam1(及后续启用的实例)。几个贴心细节:
- 内置的 Miloco 为基础版(不带 AI 引擎),无 GPU 算力要求,树莓派也能跑;
- 基于官方镜像修改,额外支持 arm64,并默认开启高清流 + 音频流(改动见 Dockerfile.miloco);
- micam 容器基于 Alpine + uv 快速构建,见 Dockerfile 与 pyproject.toml。
三、在 .env 中配置多台摄像头的环境变量
官方建议所有变量统一写在 .env 文件中,而不是直接改 docker-compose.yml(见 README.md 提示)。多摄像头采用 CAMERA_N_ID / CAMERA_N_RTSP_URL 的命名约定:
cat << EOF > .env
# 公共配置
MILOCO_PASSWORD=你的Miloco密码的md5小写值
TZ=Asia/Shanghai
# 摄像头 1(对应 micam1)
CAMERA_ID=1234567890
RTSP_URL=rtsp://192.168.1.10:8554/stream1
# 摄像头 2(对应 micam2)
CAMERA_2_ID=9876543210
CAMERA_2_RTSP_URL=rtsp://192.168.1.10:8554/stream2
EOF
三个必填项获取方式:
MILOCO_PASSWORD:Miloco WebUI 密码的 MD5(小写);CAMERA_ID:摄像头 DID,在 Miloco 网页按 F12 打开开发者工具,从网络请求日志中查看(见 README.md);RTSP_URL:Go2rtc 提供的流地址,端口固定8554,流名自定义。
四、启用 micam2:多实例的精髓在 YAML 锚点
打开 docker-compose.yml,你会发现 micam2 通过 YAML 锚点(&micam / <<: *micam)复用了 micam1 的全部配置,只覆盖了两项:
micam2:
<<: *micam
scale: 0 # Disabled by default, set 1 to enable
environment:
<<: *micam_envs
CAMERA_ID: ${CAMERA_2_ID}
RTSP_URL: ${CAMERA_2_RTSP_URL}
scale: 0表示默认禁用,改为1即启用该实例;- 第 3 台、第 4 台摄像头?照抄
micam2块,依次命名micam3、micam4……变量换成CAMERA_3_ID/CAMERA_3_RTSP_URL即可; - 改完执行
docker compose up -d让配置生效。
验证是否成功:
docker compose logs -f micam2
看到 Keyframe detected! Starting stream... 即表示该摄像头流已推送到 RTSP 服务器 ✅
五、在 Go2rtc 中聚合全部视频流
micam 只是「搬运工」,流名要提前在 Go2rtc 里声明。访问 WebUI:http://192.168.1.xx:1984/config.html,为每台摄像头配置一条空流:
streams:
stream1:
stream2:
保存并重启后,每台摄像头的实时画面即可通过 rtsp://192.168.1.10:8554/stream1、stream2 被任何 RTSP 客户端拉取,也可在 Go2rtc WebUI 里直接预览。
💡 Go2rtc 使用
network_mode: host(见 docker-compose.yml),因此 RTSP 地址直接写宿主机 IP 即可。
六、接入 NVR 与智能家居系统
流就绪后,主流平台都能一键接入(参考 README.md 集成清单):
| 平台 | 接入方式 |
|---|---|
| Home Assistant | Generic Camera 集成,填入 rtsp://...:8554/streamN |
| Frigate | NVR 场景,可开启 AI 事件检测(HAOS 加载项) |
| Scrypted | 摄像头扩展,支持 RTSP 直连 |
| HomeKit | 经 Go2rtc 的 WebRTC/HomeKit 转换 |
以 HA 为例,实体配置大致是:
camera:
- platform: generic
name: 客厅小米摄像头
still_image_url: http://192.168.1.10:1984/stream1.jpg
stream_source: rtsp://192.168.1.10:8554/stream1
七、常见问题排查清单
- 摄像头离线:确认所有摄像头都绑定在同一个已登录的小米账号下,且 Miloco 网页中可见;
- 登录失败:检查
MILOCO_PASSWORD是否为 MD5 小写值; - 画面卡顿/花屏:尝试调整
VIDEO_CODEC(默认hevc,可改h264)或STREAM_CHANNEL(默认0); - 端口冲突:修改
MILOCO_PORT后,同步更新各实例的MILOCO_BASE_URL; - 不要直接在
docker-compose.yml里硬编码环境变量,统一维护在.env更清晰。
八、相关文件速查
- 多实例编排模板:docker-compose.yml
- 转发器主程序(WebSocket→RTSP):micam/init.py
- 修改版 Miloco 构建脚本(高清流+音频):Dockerfile.miloco
- 环境变量完整说明:README.md
按以上步骤,你可以在一台闲置主机上同时托管 N 台小米摄像头,一条命令启动、一份 .env 维护,从此告别逐台手动配置。🎉