Micam

Micam 是专为小米摄像头打造的非官方 RTSP 桥接服务，核心解决小米摄像头专有协议与主流智能家居平台的兼容问题——将小米摄像头视频流本地转推为 RTSP 协议，无需 GPU 即可运行，轻松接入 HomeAssistant、Go2rtc、Frigate、Scrypted、Homekit 等 NVR/智能家居系统。

该项目基于小米官方 Miloco 开发，集成 Go2rtc 实现 RTSP 流服务，采用 Docker Compose 一键部署，填补了小米摄像头生态中「高质量视频流」与「RTSP 协议输入」的互操作性缺口。

快速安装（Docker Compose 方式）

# 创建部署目录
mkdir /opt/micam && cd /opt/micam
# 下载配置文件
wget https://raw.githubusercontent.com/miiot/micam/refs/heads/main/docker-compose.yml
# 启动服务（自动部署Miloco、Go2rtc、RTSP转发服务）
docker compose up -d

• 多摄像头支持：编辑 docker-compose.yml，运行多个 micam 服务即可；
• 部署说明：默认部署无 AI 引擎的 Miloco 基础版，无 GPU 算力要求，适配绝大部分设备；基于官方镜像优化，新增 arm64 支持，默认拉取摄像头高清流+音频流。

基础使用教程

1. Miloco 配置（核心步骤）

• 备选部署方式：可通过 HAOS 加载项一键部署 Miloco（需添加对应加载项仓库）；
• 访问 WebUI：https://[你的服务器IP]:8000（如 https://192.168.1.xx:8000）；
  ⚠️ 注意：Miloco 使用自签证书，需忽略浏览器证书错误，必须通过 https 访问；
• 关键操作：设置 Miloco 密码 → 绑定小米账号（完成摄像头关联）；
• 排坑提示：若摄像头显示离线，参考「Xiaomi Miloco Q&A」排查。

2. Go2rtc 配置

• 备选部署方式：也可通过 HAOS 加载项部署 Go2rtc；
• 访问配置页面：http://[你的服务器IP]:1984/config.html；
• 配置空视频流（示例）：

  streams:
    your_stream1:
    your_stream2:
  

• 配置后保存并重启 Go2rtc 服务。

3. Micam 环境变量配置

1. 创建/编辑 .env 文件：

   cat << EOF > .env
   MILOCO_PASSWORD=your_miloco_password_md5  # Miloco密码的MD5值（小写）
   CAMERA_ID=1234567890                      # 摄像头DID（Miloco网页F12网络日志可查）
   RTSP_URL=rtsp://192.168.1.xx:8554/your_stream1  # Go2rtc的RTSP流地址（8554为默认端口）
   EOF
   

2. 重启 Micam 服务：

   docker compose restart micam1
   

详细配置说明（环境变量）

核心原则

建议所有环境变量配置在 .env 文件中，通过 docker compose up -d 生效，不建议直接修改 docker-compose.yml。

Micam 关键变量

Miloco 辅助变量