kyberpunk/paho

Eclipse Paho MQTT-SN 透明/聚合网关

镜像概述和主要用途

该Docker镜像包含针对IPv4 UDP数据包的自定义构建Eclipse Paho MQTT-SN网关，支持ARM平台。

MQTT-SN协议要求使用MQTT-SN网关作为协议转换器，将MQTT-SN消息转换为MQTT消息。MQTT-SN客户端无法直接与MQTT broker（TCP/IP）通信。更多信息可查看https://github.com/eclipse/paho.mqtt-sn.embedded-c/tree/master/MQTTSNGateway%E3%80%82

核心功能和特性

• 支持IPv4 UDP上的MQTT-SN协议转换
• 提供多种协议支持，通过不同镜像标签区分：
  • udp（默认）
  • udp6
  • dtls
  • dtls6
  • loralink
  • xbee
• 支持ARM平台部署
• 可通过命令行参数或自定义配置文件灵活配置

使用场景和适用范围

适用于需要将使用MQTT-SN协议的物联网设备连接到标准MQTT broker的场景。当设备采用MQTT-SN协议（通常用于低功耗、低带宽网络），而后端系统使用标准MQTT协议时，该网关作为中间件实现协议转换，确保设备与broker的正常通信。

构建镜像

源代码可在https://github.com/kyberpunk/paho-mqtt-sn-docker%E8%8E%B7%E5%8F%96%E3%80%82

使用方法和配置说明

使用默认配置

使用默认配置运行网关。默认情况下，应用监听***端口，并连接到broker mqtt.eclipse.org。

bash
docker run -d -p 10000:10000 -p 10000:10000/udp kyberpunk/paho

使用自定义MQTT broker设置

使用自定义MQTT broker的IP地址和端口运行网关。

bash
docker run -d -p 10000:10000 -p 10000:10000/udp kyberpunk/paho --broker-name $HOST --broker-port $PORT

将$HOST替换为目标MQTT broker的主机名或IP地址，$PORT替换为目标broker的端口号。

使用自定义配置

通过文件系统使用自定义配置运行网关。可从https://github.com/eclipse/paho.mqtt-sn.embedded-c/blob/master/MQTTSNGateway/gateway.conf%E8%8E%B7%E5%8F%96%E9%BB%98%E8%AE%A4%E9%85%8D%E7%BD%AE%E6%A8%A1%E6%9D%BF%E5%B9%B6%E8%B0%83%E6%95%B4%E3%80%82

bash
docker run -d -p 10000:10000 -p 10000:10000/udp -v $PWD/gateway.conf:/etc/paho/gateway.conf:ro kyberpunk/paho

将$PWD替换为存储配置文件的目录路径。