oliverlorenz/http2mqtt

http2mqtt镜像说明

镜像概述

http2mqtt是一个轻量级工具，用于实现HTTP与MQTT协议之间的桥接，将HTTP请求转换为MQTT消息。它简单易用，支持Docker部署和灵活的环境变量配置，适用于需要在HTTP系统与MQTT系统间传递数据的场景。

核心功能

• 连接指定的MQTT Broker
• 启动Web服务器接收HTTP请求
• 将HTTP请求路径映射为MQTT主题，请求体作为消息payload
• 支持GET和POST两种HTTP请求方法
• 支持通过环境变量配置MQTT连接和服务端口等参数

使用场景

• IoT设备通过HTTP接口向MQTT系统发送数据
• 快速实现HTTP接口到MQTT消息的转换
• 测试MQTT消息发送功能

配置说明

可通过以下环境变量调整镜像配置：

• BROKER_URL：MQTT Broker地址，默认值为mqtt://test.mosquitto.org
• TOPIC_BASE：MQTT主题前缀（可选）
• HTTP_PORT：Web服务端口，默认值为9001
• MQTT_USERNAME：MQTT Broker认证用户名（可选）
• MQTT_PASSWORD：MQTT Broker认证密码（可选）

部署示例

Docker Run命令

bash
docker run -it --rm -p 9001:9001 oliverlorenz/http2mqtt

使用步骤

1. 启动容器：执行上述命令启动http2mqtt服务
2. 订阅MQTT主题：使用MQTT客户端订阅目标主题，例如：

   bash
   mosquitto_sub -h test.mosquitto.org -t "my/mqtt/topic"
   

3. 发送HTTP请求：通过浏览器或工具访问http://localhost:9001/my/mqtt/topic，订阅端会收到null消息；若发送POST请求并附带body，则body会作为payload传递。