yatryan/ring-alarm-mqtt

ring-alarm-mqtt镜像说明

镜像概述

该镜像基于https://github.com/dgreif/ring-alarm API开发，通过MQTT协议提供Ring报警控制面板及传感器的访问能力。支持Home Assistant风格的MQTT自动发现，可零配置快速集成Home Assistant，也适用于其他支持MQTT的工具（如Node-RED）。

核心功能

• 支持多种Ring设备：接触/运动传感器、水浸/冻结传感器、烟雾/CO监听设备、Z-Wave烟感（实验性）、集成门锁（状态与控制）
• 提供设备电池状态、篡改状态等属性信息
• Home Assistant MQTT自动发现，设备自动显示在UI中
• 按位置/设备ID生成一致的MQTT主题，便于自定义自动化
• 报警布防/撤防控制，支持命令重试机制
• 多位置报警系统支持
• 监控WebSocket连接状态，自动恢复后重发设备状态
• 响应Home Assistant MQTT在线消息，自动重发配置数据

使用场景

1. 智能家居集成：与Home Assistant、OpenHAB等平台集成，实现Ring报警系统的集中管理
2. 自定义自动化：通过Node-RED等工具，基于传感器状态触发自定义场景（如门窗打开时推送通知）
3. 多位置管理：统一监控多个Ring报警系统（如家庭和办公室）

配置说明

Docker部署示例

构建镜像

bash
docker build -t ring-alarm-mqtt/ring-alarm-mqtt .

运行容器

bash
docker run  -e "MQTTHOST={MQTT broker地址}" -e "MQTTPORT={MQTT端口}" -e "MQTTRINGTOPIC=ring" -e "MQTTHASSTOPIC=homeassistant" -e "MQTTUSER={MQTT用户名}" -e "MQTTPASSWORD={MQTT密码}" -e "RINGUSER={Ring账号}" -e "RINGPASS={Ring密码}" ring-alarm-mqtt/ring-alarm-mqtt

Home Assistant MQTT配置（推荐）

在Home Assistant的configuration.yaml中添加以下配置：

yaml
mqtt:
  broker: 127.0.0.1
  discovery: true
  discovery_prefix: homeassistant
  birth_message:
    topic: 'hass/status'
    payload: 'online'
    qos: 0
    retain: false

限制监控位置

如需限制监控的位置，可在配置中添加位置ID列表（从Ring官网地址栏获取，格式为https://app.ring.com/location/{location_id}）：

json
"location_ids": ["loc-id1", "loc-id2"]