stjohnjohnson/smartthings-mqtt-bridge

SmartThings MQTT Bridge镜像说明

镜像概述

SmartThings MQTT Bridge是连接SmartThings智能家居平台与MQTT协议的桥接工具，实现设备状态的双向同步，帮助用户通过MQTT协议控制SmartThings设备或获取实时状态，适用于跨平台智能家居集成场景。

核心功能

• 双向同步：SmartThings设备状态变化自动发布到MQTT主题，同时支持通过MQTT主题向SmartThings发送控制指令；
• 灵活配置：支持自定义MQTT服务器地址、主题前缀、认证信息及端口等参数；
• 多部署方式：提供Docker和NPM两种安装方式，适配不同环境需求。

使用场景

• 智能家居集成：将SmartThings设备接入Home Assistant等支持MQTT的智能家居系统；
• 自动化联动：通过MQTT协议实现跨平台设备的自动化控制逻辑；
• 状态监控：实时获取SmartThings设备的开关、亮度等状态信息并通过MQTT监控。

配置说明

配置文件为config.yml，关键参数示例：

yaml
mqtt:
  host: mqtt://localhost  # MQTT服务器地址
  preface: smartthings    # MQTT主题前缀
  # username: your_username  # 可选认证信息
  # password: your_password
port: 8080                # 桥接服务监听端口

Docker部署示例

拉取镜像

bash
docker pull stjohnjohnson/smartthings-mqtt-bridge

运行容器

bash
docker run \
  -d \
  --name="mqtt-bridge" \
  -v /opt/mqtt-bridge:/config \  # 挂载配置目录
  -p 8080:8080 \                # 映射端口
  stjohnjohnson/smartthings-mqtt-bridge

Docker Compose集成示例

yaml
version: '3'
services:
  mqtt:
    image: matteocollina/mosca
    ports:
      - "1883:1883"
  mqttbridge:
    image: stjohnjohnson/smartthings-mqtt-bridge
    volumes:
      - ./mqtt-bridge:/config
    ports:
      - "8080:8080"
    links:
      - mqtt
  homeassistant:
    image: balloob/home-assistant
    ports:
      - "80:80"
    volumes:
      - ./home-assistant:/config
      - /etc/localtime:/etc/localtime:ro
    links:
      - mqtt