mtand/post2mqtt Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

post2mqtt

概述

post2mqtt是一个轻量工具，用于将HTTP POST请求转换为MQTT事件。其核心工作流程为：监听HTTP POST请求，将请求的URL路径作为MQTT主题，请求体内容作为MQTT消息内容，从而实现HTTP协议到MQTT协议的转换。

核心功能与特性

• 监听HTTP POST请求并自动转换为MQTT事件
• 以POST请求的URL路径作为MQTT主题
• 以POST请求的请求体作为MQTT消息内容
• 支持通过令牌（TOKEN）进行请求认证
• 可配置MQTT服务器连接参数（地址、用户名、密码等）
• 支持设置MQTT消息的保留标志（RETAIN）

使用场景

适用于家庭自动化系统（如Home Assistant）中处理来自外部服务（如IFTTT）的Webhook请求。通过该工具可避免直接暴露家庭自动化系统的API令牌，转而通过MQTT协议进行安全通信，简化外部服务与本地MQTT生态的集成。

配置说明

通过环境变量进行配置，具体参数如下：

使用示例

Docker部署

通过Docker启动服务的命令如下：

bash
docker run --rm -e TOKEN=theauthtoken \
           -e MQTT_URL="mqtt://192.168.0.3" \
           -p 8080:8080 mtand/post2mqtt

上述命令会启动post2mqtt服务，监听本地8080端口，连接至mqtt://192.168.0.3的MQTT服务器，并要求请求携带令牌theauthtoken进行认证。

发送测试请求

服务启动后，可通过以下curl命令发送POST请求测试：

bash
curl -d '{"key1":"value1", "key2":"value2"}' \
 -H "Content-Type: application/json" \
 -H "Authorization: theauthtoken" \
 -X POST http://localhost:8080/a/b

该请求会将JSON内容{"key1":"value1", "key2":"value2"}发送至MQTT主题a/b。

若无法使用Authorization请求头，也可通过URL参数传递令牌：

bash
curl -d '{"key1":"value1", "key2":"value2"}' \
 -H "Content-Type: application/json" \
 -X POST http://localhost:8080/a/b?token=theauthtoken