timotto/mqtt-http-gateway

mqtt-http-gateway

镜像概述

mqtt-http-gateway是一个双向HTTP-MQTT协议转换网关，主要用于实现HTTP与MQTT之间的双向通信，特别适用于通过IFTTT等外部服务触发MQTT家庭自动化设备执行操作。

核心功能与特性

• 双向协议转换：支持HTTP请求转换为MQTT消息发布，同时支持MQTT消息转换为HTTP回调
• IFTTT集成：专为与IFTTT服务对接设计，便于通过IFTTT平台控制MQTT设备
• 轻量级设计：基于Node.js构建，资源占用低，适合家庭自动化场景部署

使用场景与适用范围

• 家庭自动化系统中，通过IFTTT等外部服务控制MQTT协议设备
• 需要在HTTP应用与MQTT设备网络之间建立通信桥梁的场景
• 希望通过简单HTTP接口实现对MQTT设备远程控制的应用场景

使用方法与配置说明

基本部署

Docker Run命令

bash
docker run -d \
  --name mqtt-http-gateway \
  -p 8080:8080 \
  -e MQTT_HOST=mqtt-broker.example.com \
  -e MQTT_PORT=1883 \
  timotto/mqtt-http-gateway

Docker Compose配置

yaml
version: '3'
services:
  mqtt-http-gateway:
    image: timotto/mqtt-http-gateway
    container_name: mqtt-http-gateway
    ports:
      - "8080:8080"
    environment:
      - MQTT_HOST=mqtt-broker.example.com
      - MQTT_PORT=1883
      - HTTP_PORT=8080
    restart: unless-stopped

环境变量配置

基本使用示例

通过HTTP POST请求向MQTT主题发布消息：

bash
curl -X POST http://localhost:8080/publish \
  -H "Content-Type: application/json" \
  -d '{"topic": "home/light", "payload": "on"}'

该请求将向MQTT主题home/light发布消息on，控制相应的MQTT设备执行开灯操作。