FREIFUNK - MÜNCHEN
wgkex (WireGuard key exchange) ist der Dienst, über den sich Freifunk-Knoten mit einem Gateway verbinden. Die Knoten bauen darüber ihren verschlüsselten Mesh-Uplink auf: BATMAN läuft über VXLAN über WireGuard. Auf den Knoten kommt dafür das Gluon-Paket ffmuc-mesh-vpn-wireguard-vxlan zum Einsatz.
POST /api/v2/wg/key/exchange)./api/v1) und ein zufälliges Gateway aus seiner Konfiguration zurück.Peers ohne Handshake räumt der Worker nach einiger Zeit selbst wieder ab.
| Teil | Wo | Aufgabe |
|---|---|---|
| Worker | auf jedem Gateway (Systemdienst wgkex) | legt WireGuard-Peers und VXLAN-Einträge an, meldet Status, Auslastung und Peers |
| Broker | Docker-Container auf den Docker-Hosts, hinter HAProxy | nimmt Schlüssel entgegen, wählt das Gateway, verteilt die Last |
| MQTT | EMQX auf den Docker-Hosts | Nachrichten zwischen Brokern und Workern |
wgkex in ffmuc-salt-public, siehe Saltstack). Die Broker sind Compose-Stacks (stacks/docker0X/wgkex), ausgerollt mit Komodo.
Erst die Worker, dann die Broker, damit neue Nachrichten von allen verstanden werden: Salt-State wgkex auf den Gateways anwenden (oder auf den täglichen Highstate um 18:00 Uhr warten), danach die Broker-Stacks nacheinander in Komodo neu ausrollen.
/run/wgkex/drain anlegen (touch). Der Worker meldet Status „draining“; die Broker weisen ihm keine neuen Knoten mehr zu und er gibt pro Minute 10 % seiner Peers ab./run wird dabei geleert, das Gateway ist danach wieder normal im Dienst, und der Lastausgleich bringt nach etwa 10 Minuten Knoten zurück.Immer nur ein Gateway gleichzeitig.
Worker und Broker liefern Prometheus-Metriken, die telegraf einsammelt; sie landen in InfluxDB/Grafana (Dashboard „wgkex“ auf stats.ffmuc.net). Icinga überwacht den Systemdienst wgkex auf den Gateways.
README.md, Docs/operations.md, Docs/metrics.md)wgkex/README.md im Salt-Repository