nanomq

NanoMQ 轻量级 MQTT Broker

补充说明

NanoMQ 是面向边缘计算的轻量 MQTT Broker，资源占用低，支持 MQTT 5.0、桥接和规则转发。适合网关、工业设备和资源受限环境。

常用示例

启动默认配置：

nanomq start --url nmq-tcp://0.0.0.0:1883

指定配置文件：

nanomq start --conf /etc/nanomq/nanomq.conf

订阅与发布：

nanomq_cli sub -h 127.0.0.1 -p 1883 -t 'edge/#'
nanomq_cli pub -h 127.0.0.1 -p 1883 -t 'edge/device1' -m 'online' -q 1

配置桥接到中心 Broker：

cat > /etc/nanomq/nanomq.conf <<'EOF'
mqtt {
  url = "nmq-tcp://0.0.0.0:1883"
}
bridges.mqtt.emqx {
  server = "mqtt-tcp://emqx:1883"
  forwards = [
    { remote_topic = "edge/#", local_topic = "edge/#" }
  ]
}
EOF

查看连接和统计：

nanomq_cli stats
nanomq_cli conn list

易错点与排错

• 桥接 topic 没有配置方向，只订阅不转发或只转发不订阅。
• 边缘设备时钟不准，TLS 证书校验失败。
• 本地持久化目录不可写，重启后会话丢失。
• QoS 1 消息在弱网下大量重传，需要调整重试间隔。
• 桥接远端地址使用 localhost，容器内指向自身。
• 主题通配符层级写错，转发范围过大。
• 资源受限设备上开启过多日志和规则，内存占用升高。