dmitriy/broadlink-mqtt

概述

本Docker镜像用于容器化部署https://github.com/eschava/broadlink-mqtt%E9%A1%B9%E7%9B%AE%EF%BC%8C%E5%AE%9E%E7%8E%B0Broadlink%E8%AE%BE%E5%A4%87%EF%BC%88%E5%A6%82RM%E7%B3%BB%E5%88%97%E7%BA%A2%E5%A4%96%E9%81%A5%E6%8E%A7%E5%99%A8%EF%BC%89%E4%B8%8EMQTT%E6%9C%8D%E5%8A%A1%E5%99%A8%E7%9A%84%E8%BF%9E%E6%8E%A5%EF%BC%8C%E6%94%AF%E6%8C%81%E9%80%9A%E8%BF%87MQTT%E6%B6%88%E6%81%AF%E5%8F%91%E9%80%81%E7%BA%A2%E5%A4%96%E6%8C%87%E4%BB%A4%E6%8E%A7%E5%88%B6%E6%99%BA%E8%83%BD%E5%AE%B6%E5%B1%85%E8%AE%BE%E5%A4%87%E3%80%82

核心功能

• 建立Broadlink设备与MQTT服务器的通信链路
• 通过MQTT主题接收控制指令并转发至Broadlink设备
• 支持环境变量配置关键参数（如MQTT服务器地址、设备IP/MAC）

使用场景

• 智能家居自动化：通过MQTT协议控制红外设备（电视、空调、机顶盒等）
• 家庭自动化平台集成：与Home Assistant等系统联动实现设备远程控制

配置说明

通过环境变量配置容器参数，主要参数包括：

• MQTT_SERVER：MQTT服务器地址（必填）
• DEVICE_HOST：Broadlink设备IP地址（必填）
• DEVICE_MAC：Broadlink设备MAC地址（必填）
• MQTT_TOPIC_PREFIX：MQTT主题前缀（可选，默认"broadlink/"）

部署示例

构建镜像

bash
docker build --pull --rm --tag=broadlink-mqtt .

运行容器

bash
docker run -it --rm \
  -e MQTT_SERVER=192.168.1.1 \
  -e DEVICE_HOST=192.168.1.60 \
  -e DEVICE_MAC=34:AA:FF:CC:D5:68 \
  docker.xuanyuan.run/broadlink-mqtt

Docker Compose示例

yaml
broadlink-mqtt:
  image: broadlink-mqtt
  environment:
    - MQTT_SERVER=mosquitto
    - MQTT_TOPIC_PREFIX=broadlink/rm-mini3/
    - DEVICE_HOST=192.168.1.60
    - DEVICE_MAC=34:AA:FF:CC:D5:68
  depends_on:
    - mosquitto