Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,8 @@

Zero-hop MQTT anti-flood service for self-hosted [EMQX](https://www.emqx.io/) brokers serving [Meshtastic](https://meshtastic.org/) networks. Intercepts MQTT PUBLISH events via [EMQX ExHook](https://www.emqx.io/docs/en/latest/extensions/exhook.html) (gRPC) and sets `MeshPacket.hop_limit=0` in-flight before delivery to subscribers, preventing LoRa rebroadcast floods when gateways downlink MQTT packets.

Tested against EMQX 6.2.0 (ExHook v3 proto, EMQX 5.9.0+).

## Why

Meshtastic's official public broker enforces a [zero-hop policy](https://meshtastic.org/docs/software/integrations/mqtt/#zero-hop-policy): packets delivered from the broker to gateway nodes are zeroed before downlink so they don't rebroadcast across the local LoRa mesh. This prevents internet-scale MQTT traffic from flooding regional radio networks.
Expand Down
2 changes: 1 addition & 1 deletion docker-compose.test.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@

services:
emqx:
image: emqx/emqx:6.1.1
image: emqx/emqx:6.2.0
container_name: floodgate-test-emqx
networks: [floodgate-test-net]
ports:
Expand Down
2 changes: 1 addition & 1 deletion docker-compose.yaml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
services:
emqx:
image: emqx/emqx:6.1.1
image: emqx/emqx:6.2.0
ports:
- "1883:1883" # MQTT
- "18083:18083" # Dashboard / REST API
Expand Down
2 changes: 1 addition & 1 deletion proto/emqx/exhook.proto
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
// Copyright (c) 2020-2026 EMQ Technologies Co., Ltd. All Rights Reserved.
// Licensed under the Apache License, Version 2.0
// Source: https://github.com/emqx/emqx/blob/release-60/apps/emqx_exhook/priv/protos/exhook.proto
// Source: https://github.com/emqx/emqx/blob/release-62/apps/emqx_exhook/priv/protos/exhook.proto
//
// v3: EMQX 5.9.0+ / EMQX 6.x
// v2: EMQX 5.0–5.8.x
Expand Down
Loading