vsimonaitis/http_to_mqtt

HTTP到MQTT桥接工具

镜像概述

本镜像实现了HTTP到MQTT的桥接功能，旨在解决家庭自动化场景中的集成需求（如Google Assistant与Home Assistant的连接）。当IFTTT缺乏直接MQTT服务支持时，该工具可通过HTTP请求接收信号并转发至MQTT broker，避免Home Assistant直接暴露在公网的安全风险。工具基于NodeJS开发，使用Express框架处理HTTP请求，MQTT.js客户端连接MQTT broker。

核心功能

• 接收HTTP POST请求并将消息发布至指定MQTT主题
• 支持订阅MQTT主题，实时返回收到的消息
• 通过环境变量配置认证密钥、MQTT broker地址及 credentials
• 提供保活机制防止部署平台（如Heroku）进入休眠状态
• 支持Plex webhook集成，处理文件上传和JSON payload解析

使用场景

• 家庭自动化：连接Google Assistant与Home Assistant，实现语音控制设备
• Plex媒体服务器：通过webhook将播放事件同步至MQTT系统
• 跨系统数据同步：将HTTP-based服务的事件转发至MQTT生态系统

配置说明

Docker部署示例

bash
docker run -d \
  --name http_to_mqtt \
  -p 5000:5000 \
  -e AUTH_KEY=your_unique_auth_key \
  -e MQTT_HOST=mqtts://your_broker_host:port \
  -e MQTT_USER=your_mqtt_username \
  -e MQTT_PASS=your_mqtt_password \
  vsimonaitis/http_to_mqtt

Heroku部署

1. 配置Home Assistant的MQTT触发器
2. 配置CloudMQTT服务（参考官方教程）
3. 点击部署按钮将工具部署至Heroku：https://www.herokucdn.com/deploy/button.svg](https://heroku.com/deploy?template=https://github.com/petkov/http_to_mqtt)
4. 设置Heroku环境变量：
   • AUTH_KEY：自定义认证密钥
   • MQTT_HOST：MQTT broker地址（如mqtts://k99.cloudmqtt.com:21234）
   • MQTT_USER：MQTT用户名
   • MQTT_PASS：MQTT密码
5. 在IFTTT中配置Maker Webhooks，使用POST请求发送JSON数据至https://<app_name>.herokuapp.com/post/

自有服务器部署

1. 克隆仓库：git clone https://github.com/petkov/http_to_mqtt.git
2. 进入目录：cd http_to_mqtt
3. 运行：node index.js（默认监听5000端口，连接本地MQTT broker）

Home Assistant保活配置

为防止Heroku应用休眠，可在Home Assistant中设置定时请求：

yaml
rest_command:
  http_to_mqtt_keep_alive:
    url: https://<your_app_address>/keep_alive/
    method: get

automation:
  alias: HTTP到MQTT保活
  trigger:
    platform: time
    minutes: '/10'
    seconds: 00
  condition:
    condition: time
    after: '7:30:00'
    before: '23:59:59'
  action:
    service: rest_command.http_to_mqtt_keep_alive

Plex集成示例

配置Plex webhook指向以下URL： http://localhost:5000/post?topic=/plex/playback&single=thumb&path=payload 该配置会将Plex的播放事件转发至/plex/playback主题，并解析payload中的关键信息。

致谢

特别感谢BRUH Automation的Ben提供的教程，为本项目提供了灵感。