多台小米摄像头如何统一管理?micam多实例部署完整攻略

原创2026-10-24 15:23:011,651 阅读
文章标签:音视频视频智能家居WebSocket

多台小米摄像头如何统一管理?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

三个必填项获取方式:

  1. MILOCO_PASSWORD:Miloco WebUI 密码的 MD5(小写);
  2. CAMERA_ID:摄像头 DID,在 Miloco 网页按 F12 打开开发者工具,从网络请求日志中查看(见 README.md);
  3. 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 更清晰。

八、相关文件速查

按以上步骤,你可以在一台闲置主机上同时托管 N 台小米摄像头,一条命令启动、一份 .env 维护,从此告别逐台手动配置。🎉

登录后查看全文
micam