fabtesta/unifi-nvr-api-motion-mqtt-gifs

unifi-nvr-api-motion-mqtt-gifs镜像说明

镜像概述

本镜像基于开源项目构建，通过Python脚本调用UniFI Video NVR未公开API，从摄像头运动事件录制的视频中提取片段并生成动画GIF，同时将结果通过MQTT协议推送至指定服务器，方便用户快速获取监控事件的可视化内容。

核心功能

1. 支持UniFI Video NVR未公开API交互
2. 多摄像头事件轮询与处理
3. 自定义ffmpeg参数调整GIF质量与尺寸
4. 跨容器重启保留已处理事件记录
5. MQTT协议推送GIF生成通知

使用场景

适用于家庭或企业监控系统，当摄像头检测到运动事件时，自动生成关键片段的GIF并推送至MQTT服务器，用户可通过智能家居平台或自定义应用接收并查看事件内容，提升监控响应效率。

配置说明

需提供JSON格式配置文件，示例如下：

json
{
  "data_folder": "",
  "mqtt_server": "broker.shiftr.io",
  "mqtt_port": 1883,
  "mqtt_user": "user",
  "mqtt_pwd": "password",
  "mqtt_base_topic": "unifi/cameras/gifs",
  "ffmpeg_working_folder": "./gifs",
  "unifi_video_base_api_url": "http://127.0.0.1",
  "unifi_video_user": "admin",
  "unifi_video_password": "password123",
  "unifi_cameras": [
    {
      "_id": "5c561db5ded6a576d76356fd",
      "skip_first_n_secs": 5,
      "max_length_secs": 5,
      "scale": 320,
      "topic_name": "camera_1"
    }
  ]
}

关键参数说明：

• data_folder: 存储已处理事件的SQLite数据库路径（Docker环境留空）
• mqtt_server: MQTT服务器地址
• unifi_video_base_api_url: UniFI Video NVR API基础地址
• unifi_cameras: 摄像头配置列表（包含ID、片段参数等）

部署示例

Docker Run命令

shell
docker run \
    -v $(pwd)/config:/config \
    -v $(pwd)/data:/data \
    -v $(pwd)/gifs:/gifs \
    docker.xuanyuan.run/fabtesta/unifi-nvr-api-motion-mqtt-gifs:latest

Docker Compose配置（绑定挂载）

yaml
services:
  unifi-nvr-api-motion-mqtt-gifs:
    image: docker.xuanyuan.run/fabtesta/unifi-nvr-api-motion-mqtt-gifs:latest
    volumes:
      - ./config:/config
      - ./data:/data
      - ./gifs:/gifs
    restart: unless-stopped

Docker Compose配置（持久卷）

yaml
services:
  unifi-nvr-api-motion-mqtt-gifs:
    image: fabtesta/unifi-nvr-api-motion-mqtt-gifs:latest
    volumes:
      - ./config:/config
      - unifi_data:/data
      - ./gifs:/gifs
    restart: unless-stopped
    
volumes:
  unifi_data: