monster1025/aqara-mqtt

Aqara-MQTT镜像

镜像概述

Aqara-MQTT是一款将Aqara（小米）网关与MQTT broker连接的桥接工具，可无缝集成到Home Assistant智能家居系统，实现设备状态同步与远程控制。

核心功能

• 同步Aqara网关设备状态至MQTT主题
• 通过MQTT主题发送指令控制Aqara设备（如开关、插座、RGB灯等）
• 支持Home Assistant模板配置与自动化场景

使用场景

• 智能家居系统中Aqara设备与MQTT生态的互联互通
• Home Assistant用户对Aqara设备的状态监控与远程控制
• 构建基于MQTT的智能家居自动化流程

配置说明

1. 激活Aqara网关开发者模式（参考链接：[***]
2. 复制config/config-sample.yaml并重命名为config/config.yaml，根据需求编辑配置

Docker部署示例

Docker Compose配置

yaml
aqara:
  image: monster1025/aqara-mqtt
  container_name: aqara
  volumes:
    - "./config:/app/config"
  network_mode: host
  restart: always

Home Assistant集成示例

网关RGB灯模板

yaml
- platform: mqtt_template
  name: "主网关"
  state_topic: "home/gateway/main/rgb"
  command_topic: "home/gateway/main/rgb/set"
  command_on_template: "{%- if red is defined and green is defined and blue is defined -%}{{ red }},{{ green }},{{ blue }}{%- else -%}255,179,0{%- endif -%},{%- if brightness is defined -%}{{ (float(brightness) / 255 * 100) | round(0) }}{%- else -%}100{%- endif -%}"
  command_off_template: "0,0,0,0"
  state_template: "{%- if value.split(',')[3]| float > 0 -%}on{%- else -%}off{%- endif -%}"  # 必须返回`on`或`off`
  brightness_template: "{{ (float(value.split(',')[3])/100*255) | round(0) }}"
  red_template: "{{ value.split(',')[0] | int }}"
  green_template: "{{ value.split(',')[1] | int }}"
  blue_template: "{{ value.split(',')[2] | int }}"

开关自动化示例

yaml
trigger:
  platform: mqtt
  topic: home/switch/hall/status
  payload: 'click'
action:
  service: script.hall_force_light_on