Skip to content

About

Dockerized "server" node for Freifunk Dreseden / Freifunk Leipzig

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Freifunk Dresden/Leipzig Docker-Servernode

Dieser Ordner enthält einen containerisierten Freifunk-Servernode mit:

  • registrar (Registrierung, Node-ID, fastd/bmxd Runtime-Dateien)
  • sysinfo (30s-Refresh von sysinfo.json + nodes.json)
  • wireguard (Status-Logging für WireGuard-Peers)
  • fastd + bmxd
  • nginx (Port 80, UI + JSON-Endpunkte)

Quickstart

Voraussetzungen

  • Docker + Docker Compose Plugin
  • Linux-Host mit /dev/net/tun
  • Der Container muss net.ipv4.ip_forward=1 aktivieren können

1) Konfiguration anlegen

cd dockernode
cp .env.example .env

Mindestens diese Werte in .env setzen:

  • NODE_CONTACT_EMAIL
  • NODE_NAME
  • NODE_COMMUNITY (Dresden oder Leipzig)
  • NODE_GPS_LATITUDE
  • NODE_GPS_LONGITUDE

Optional:

  • BACKBONE_PEERS leer lassen → Defaults aus config/defaults.yaml
  • NODE_REGISTRATION_URL leer lassen → Defaults aus config/defaults.yaml
  • REGISTRAR_INTERVAL muss zwischen 3600 und 21600 Sekunden liegen (1–6h)

TLS der Registrierung

Die Registrierung erfordert HTTPS und prüft immer Zertifikatskette und Hostnamen. Für eigene NODE_REGISTRATION_URL-Hosts gelten standardmäßig die System-CAs. Nur für den exakten Default-Host selfsigned.register.freifunk-dresden.de wird stattdessen die mitgelieferte FFDD-CA verwendet. Es gibt keinen unsicheren Fallback und keine Option zum Abschalten der Zertifikatsprüfung.

Die öffentliche CA in config/ca-root-ffdd.crt stammt aus der Firmware und ist bytegleich mit der Server-Konfiguration. SHA-256-Fingerprint: FA:A5:60:C0:D4:8B:7B:19:CA:BD:5E:EF:94:06:BF:2E:2E:FB:97:37:FC:45:DC:62:3A:AA:8E:68:82:8D:71:D1. Dies ist ein expliziter CA-Vertrauensanker, kein Pin des Server-Zertifikats. Die ältere FFDD-Root-CA enthält keine keyUsage-Erweiterung. Nur für dieses mitgelieferte Default-Bundle wird daher VERIFY_X509_STRICT deaktiviert; Zertifikatskette, Gültigkeit und Hostname werden weiterhin geprüft. Für eigene Bundles und System-CAs bleiben die Python-Standardprüfungen unverändert.

Mit NODE_REGISTRATION_CA_FILE=/data/registration-ca.pem kann ein eigenes PEM-CA-Bundle gewählt werden. Der Pfad gilt im Container; die Datei muss lesbar sein, etwa durch einen zusätzlichen read-only Bind-Mount:

services:
  dockernode:
    volumes:
      - ./registration-ca.pem:/data/registration-ca.pem:ro

Ein explizites Bundle ersetzt für diese Anfrage die System- bzw. Default-CA. Fehlende, unlesbare oder ungültige CA-Dateien führen zum Abbruch; sie schalten keine Prüfung ab. CA-Dateien nur aus einer unabhängig vertrauenswürdigen Quelle beziehen, niemals beim fehlgeschlagenen TLS-Verbindungsaufbau ungeprüft übernehmen. Die Registrierungs-URL enthält einen geheimen Schlüssel und gehört nicht in Logs. Redirects zu HTTP oder einem anderen Host/Port werden deshalb ebenfalls abgewiesen.

Bei der Live-Prüfung des aktuellen Default-Registrars wurde die Kette erfolgreich gegen diese CA verifiziert. Das Server-Zertifikat gilt vom 24.01.2021 bis 22.01.2031; sein SHA-256-Fingerprint lautet 76:98:0C:B1:DB:BE:42:95:85:69:BC:5B:E3:CC:AB:4B:0A:EE:27:63:64:0D:06:34:EA:A9:F8:00:25:A7:F8:79. Das Legacy-Zertifikat hat keinen SAN; der Hostname wird über den passenden CN geprüft. Dies dokumentiert den Prüfstand und ist kein zusätzlicher Leaf-Pin.

2) Bauen

docker compose build dockernode

CI Release (Tag -> Image-Tag)

Bei einem Git-Tag-Push baut GitHub Actions automatisch ein Image und pusht es nach GHCR:

  • ghcr.io/freifunkstuff/ffdd-node:<tag>
  • Push auf master erzeugt zusätzlich: ghcr.io/freifunkstuff/ffdd-node:master

Beispiel:

git tag v1.0.1
git push origin v1.0.1

Ergebnis:

  • ghcr.io/freifunkstuff/ffdd-node:v1.0.1

Pull-Beispiel:

docker pull ghcr.io/freifunkstuff/ffdd-node:master
docker pull ghcr.io/freifunkstuff/ffdd-node:v1.0.1

3) Starten

docker compose up -d dockernode

4) Erreichbarkeit prüfen

docker compose ps
curl -sSf http://127.0.0.1/sysinfo.json | head
curl -sSf http://127.0.0.1/nodes.json | head
curl -sSf http://127.0.0.1/ui/ | head

Betrieb

Services (runit)

Im Container laufen getrennte Dienste:

  • registrar
  • sysinfo
  • wireguard
  • fastd
  • bmxd
  • nginx

Status prüfen:

docker compose exec -T dockernode sh -lc 'sv status registrar; sv status sysinfo; sv status wireguard; sv status fastd; sv status bmxd; sv status nginx'

Einzelnen Dienst neu starten:

docker compose exec -T dockernode sv restart sysinfo

Logs ansehen:

docker compose logs -f dockernode

Wiederanlauf und WireGuard-Endpunkte

Der Registrar aktualisiert WireGuard-Peers bei jedem erfolgreichen Reconcile in-place. Dadurch wird der DNS-Name des Endpunkts auch bei unverändertem Konfigurationstext erneut aufgelöst. Das Intervall ist REGISTRAR_INTERVAL (Standard eine Stunde, konfigurierbar auf 1–6 Stunden); dies ist kein minütlicher DNS-Refresh wie in der Router-Firmware. Registrierung und Peer-Validierung müssen für einen vollständigen Durchlauf erreichbar sein.

Bestehende gewünschte Peers werden nicht mehr vorsorglich entfernt. Erst nach erfolgreichen Updates werden veraltete Peers gelöscht. Ein apply-pending-Marker hält auch unterbrochene Interface-Reparaturen wiederholbar; die Runtime-Umgebung wird erst nach erfolgreicher Anwendung veröffentlicht. Unveränderte, erfolgreich angewendete Durchläufe erzeugen keine IPIP-Tunnel neu.

Für fastd und bmxd wird die zuletzt erfolgreich geladene Konfiguration separat als service-applied.sha256 im jeweiligen Runtime-Verzeichnis quittiert. Fehlgeschlagene Neustarts werden erneut versucht, auch wenn nur der Registrar neu gestartet wurde. Eine Topologie-Reparatur invalidiert die bmxd-Quittierung. Fastd-Verbindungsmarker werden beim Daemonstart sowie bei Interface-up/down bereinigt, damit ein Absturz keine alten „connected“-Zustände hinterlässt.

Persistenz

Persistente Daten liegen auf dem Host in:

  • ./data/node.yaml

Darin werden u. a. gespeichert:

  • registration.node_id
  • registration.register_key
  • fastd.secret
  • wireguard.secret

Flüchtige Laufzeitdaten liegen im Container unter:

  • /run/freifunk/fastd
  • /run/freifunk/bmxd
  • /run/freifunk/sysinfo
  • /run/freifunk/www

Temporärer Betrieb und reine Mesh-Nodes

NODE_REGISTRATION_MODE=registered bleibt der Default. Mit NODE_REGISTRATION_MODE=temporary wird ohne Registry-Anfragen eine temporäre FFDD-ID von 900 bis 999 verwendet. Die Firmware-Formel bleibt erhalten: 900 + ((ganze Uptime-Sekunden + erste sechs Nichtnull-Ziffern des MD5 von ip addr) % 100). Die Uptime wird an Container angepasst: Host-Uptime minus Startzeit von Container- PID 1. Das Ergebnis liegt separat unter temporary.node_id im persistenten Zustand und wird beim Neustart wiederverwendet. Eine vorhandene reguläre Registrierung wird nicht überschrieben; die UI kennzeichnet temporären Betrieb. Der kleine Bereich ist nicht global reserviert und kann kollidieren. Ein Wechsel auf registrierten Betrieb erfolgt ausdrücklich über Modusänderung und Neustart.

BACKBONE_ENABLED=0 deaktiviert alle WireGuard-/fastd-Backbone-Verbindungen, Peer-API-Abfragen und deren Konfigurationsanforderungen. Die Node kann dann allein über MESH_INTERFACES teilnehmen. Leere Peer-Strings allein reichen dafür nicht, weil sie ansonsten die Image-Defaults verwenden.

Für eine Bestandsmigration kann NODE_EXPECTED_ID auf die zwingend zu übernehmende ID gesetzt werden. Dann verweigert der Registrar sowohl eine abweichende persistierte ID als auch eine andere Registry-Zuweisung, bevor sie aktiviert oder gespeichert wird. Default 0 erhält automatische Zuweisung; mit temporärem Modus ist der Pin nicht kombinierbar. Beim Import alter Firmware muss der vollständige Registrierungswert erhalten bleiben: Manche Geräte hängen ddmesh.system.register_key an ein bereits MAC-präfixiertes credentials.registration.register_service_url an. Nur der Systemwert allein ist dann eine andere Identität. Alle Teile ausschließlich als Secret behandeln.

Rollenmeldung, Modell und Container-Laufzeit

NODE_TYPE=node kennzeichnet Router/Offloader gegenüber Karte und Collector. NODE_TYPE=server bleibt aus Kompatibilitätsgründen der Default für bisherige Server-Deployments. Das ist eine Meldung, keine Aktivierung eines Internet-Exits. Der Collector behandelt Legacy-Server besonders (Gatewaydarstellung und keine Standortmarkierung); ein Offloader mit Koordinaten muss daher ausdrücklich node melden. Registrierungsmodus und Rolle sind voneinander unabhängig.

Das Gerätemodell ist standardmäßig docker-alpine. SYSINFO_BOARD, SYSINFO_MODEL und SYSINFO_MODEL2 erlauben eine explizite Containerbeschreibung; der Collector bevorzugt das nichtleere model2. Beispielsweise meldet ein Kubernetes-Offloader FFDD Docker-Node (Kubernetes), nicht die alte VM-Hardware. Die CPU-Beschreibung bleibt eine Hardwareinformation und ist ausdrücklich als cpuinfo_scope=hardware-host markiert; eine virtuelle Container-CPU-Bezeichnung gibt es nicht. Ressourcenzähler kommen dagegen aus einem gemeinsamen Snapshot.

Gekapselte Ressourcen und Uptime

system_resources.py ist der einzige Reader für CPU, RAM und Uptime, mit injizierbarem Dateisystem und Takt für eigene Tests. Das Image setzt SYSINFO_RESOURCE_SCOPE=container; native Python-Ausführung kann auto oder host verwenden. Auto erkennt bekannte Runtime-/Kubernetes-Hinweise, kann eine vollständig unmarkierte private cgroup-Namespace aber nicht sicher von einem Host unterscheiden. Der explizite Image-Hinweis verhindert diese Verwechslung.

  • cgroup v1/v2: sichtbare Quota-/Cpuset-/RAM-Grenzen, CPU-Zeit und Throttling, Speicherverbrauch und Cache. Keine Hostwerte als Ersatz für unbekannte Containerwerte. Sichtbare Elternlimits werden berücksichtigt.
  • data.resources.cpu_capacity ist die exakte Kapazität in CPU-Äquivalenten; die Cpuset-Anzahl ist separat. Das ältere ganzzahlige cpucount rundet die Kapazität auf (z.B.0,5→1); es ist keine Aussage über reservierte Kerne.
  • Container-Load-Average wird nicht erfunden. Host-cpu_load, cpu_stat und Host-Bufferwerte werden dort nicht veröffentlicht. CPU-Nutzung ergibt sich aus der Änderung der CPU-Sekundenzähler, nicht aus Host-Load-Average.
  • Container-Uptime ist die Lebensdauer von PID1, berechnet aus /proc/uptime minus dessen Startticks. Die cgroup-Zugehörigkeit muss zur eigenen passen; bei Host-/Shared-PID-Namespace oder fehlender Verifikation bleibt sie unbekannt. Native Host-Uptime bleibt Kernel-Uptime. Kein stiller Host-Uptime-Fallback.
  • RAM-Gesamt ist das Limit, verbleibender RAM ist Limit minus Verbrauch; dies ist nicht Linux-MemAvailable. Unbegrenzte/verborgene Limits bleiben unbekannt. Kubernetes-Requests sind keine cgroup-Limits und werden nicht geraten.

System, Statistik und strukturierte Ressourcen werden aus demselben Snapshot gebaut. Interne cgroup-Pfade werden vor Veröffentlichung entfernt.

WireGuard-Datenzähler werden aus den konfigurierten tbb_wgN-IPIP-Interfaces aggregiert als tbb_wg_rx/tx veröffentlicht. Das verschlüsselte Underlay tbbwg wird nicht zusätzlich gezählt; fastd bleibt separat. Konfigurierte beliebig benannte Mesh-Interfaces werden als LAN-Meshlinks klassifiziert.

fastd v23 enthält einen gezielten Linux-Patch für die Bereinigung vererbter Dateideskriptoren: close_range(3, UINT_MAX, 0) statt eines Scans aller möglichen Nummern. Auf älteren oder eingeschränkten Kerneln werden tatsächlich offene Deskriptoren über rohe /proc/self/fd-Syscalls geschlossen. Der Fallback benötigt keine Speicherallokation und ist auch nach multithreaded fork() verwendbar. Die bisherigen Aufrufstellen beim Start und vor Shell-Hooks bleiben erhalten; 0–2 werden unverändert belassen. So erben Hooks keine Daemon-Sockets oder Geräte. Wenn eine vollständige Schließung nicht sicher möglich ist, beendet sich der betroffene Prozess mit Fehler statt unsicher weiterzulaufen. Nicht-Linux-Code bleibt unverändert; das Image ist Linux-basiert.

Der frühere globale nofile=65536-Workaround entfällt. Soft-/Hard-Limits bleiben unter Kontrolle der Runtime bzw.des Operators. Zusätzlich zu Unit-Tests prüfen tests/integration_fastd_fd_close.py Fehler-/Fork-Fälle und tests/integration_fastd_image.py CLI, echte Daemon-Hooks und erzwungene ENOSYS-/EPERM-Fallbacks im vollständigen Image, auch bei sehr großen FD-Limits.

docker build --target builder -t ffdd-node-test-builder .
python3 tests/integration_fastd_fd_close.py
python3 tests/integration_fastd_image.py --image ghcr.io/freifunkstuff/ffdd-node:master

Die Publish-CI führt beide Prüfungen zusätzlich gegen den veröffentlichten Image-Digest aus. Peerloses Multitap benötigt dabei weder TUN noch zusätzliche Capabilities; die Tests verwenden ausschließlich eigene Wegwerf-Konfigurationen.

Vorhandene Mesh-Interfaces und lokaler VLAN-Test

MESH_INTERFACES ist eine durch Leerzeichen getrennte Liste bereits im Container vorhandener Mesh-Interfaces. Die Node erstellt keine VLANs oder externen Bridges. Sie setzt FFDD-Mesh-Adresse, /16, Broadcast 10.255.255.255, MTU 1200 und bindet die Interfaces mit /linklayer 1 in bmxd ein. Der Registrar kontrolliert sie zwischen den Registrierungen alle fünf Sekunden auf Verfügbarkeit und repariert entfernte/wiederkehrende Interfaces. Der Status steht unter /run/freifunk/bmxd/mesh-interfaces.json.

Die normale Default-Route bleibt Internet-Uplink für eigenen Verkehr. Interfaces mit einer Default-Route werden nicht als Mesh-Anschluss akzeptiert. Eine eigene Forwarding-Chain erlaubt Transit ausschließlich zwischen Mesh- und Backbone-Interfaces; die gewöhnliche Uplink-Schnittstelle ist kein Exit. Es werden keine globalen Firewall-Chains geleert. Mesh-Deployments benötigen eine eigene Netzwerk-Namespace, nicht network_mode: host, sowie NET_ADMIN und vom Runtime gesetztes net.ipv4.ip_forward=1. Docker stellt /proc/sys innerhalb des Containers schreibgeschützt bereit; dies wird daher über Compose gesetzt, nicht durch zusätzliche Privilegien oder Host-Sysctl-Änderungen umgangen. Der Entrypoint nimmt die bereitgestellten Mesh-Links zunächst herunter, installiert die Schutzregeln und lässt erst dann die Mesh-L3-Konfiguration starten. Fehlgeschlagene Schutzregeln verhindern den Start.

Anwendungscode kann keine Pakete kontrollieren, die bereits vor PID1 eintreffen. Für eine lückenlose Startisolation müsste die Runtime den Mesh-Anschluss zunächst geschlossen liefern (z.B.administrativ DOWN). Standard-Macvlan liefert ihn UP. Bei Forwarding1 besteht deshalb vor der ersten Entrypoint-Aktion ein bewusst zu akzeptierendes Startfenster ohne Node-Firewall. Dessen Länge ist nicht zugesichert: Ein verzögerter/fehlgeschlagener Containerstart kann es verlängern. Der mw-home-Offloader akzeptiert dieses Restrisiko ausdrücklich und verwendet normales Flannel plus zwei Macvlans, ohne RPF-Startwechsel oder Init-Container. Ab Prozessstart installiert die Node selbst die Policy, konfiguriert Routen und Adressen und aktiviert danach den Mesh-Link. Beim Containerneustart in derselben Pod-Namespace bleibt eine bestehende Policy stehen und wird nur atomar in eigenen Chains aktualisiert. Ein fehlgeschlagener Guard verhindert den weiteren Start.

Optionaler Uplink-Wechsel bei erhaltener Management-/Pod-IP

Alle folgenden Werte leer: keine Änderung der bestehenden Default-Route.

NODE_UPLINK_INTERFACE=lan0
NODE_UPLINK_GATEWAY=192.168.61.1
NODE_MANAGEMENT_INTERFACE=eth0
NODE_MANAGEMENT_GATEWAY=
NODE_MANAGEMENT_ROUTES=10.42.0.0/16 10.43.0.0/16 192.168.1.9/32

Der Entrypoint installiert zuerst die Mesh-Sperre. uplink_routes.py validiert anschließend die gesamte Routingplanung, erhält die expliziten Managementziele über das ursprüngliche Gateway und bewegt erst dann die Default-Route ins LAN. Die Node kennt keine fest eingebauten Kubernetes-Netze; die Beispielpräfixe sind Runtime-Eingaben. Bei erneuter Ausführung kann das Managementgateway aus vorhandenen eindeutigen Via-Routen oder dem expliziten Wert rekonstruiert werden. Es wird nie die erste Subnetzadresse geraten. Fremde konkurrierende Routen oder mehrere Defaults führen zum Fehler, nicht zum pauschalen Löschen. Der Mesh-Link bleibt bei Fehlern unten; eine fehlgeschlagene Default-Verifikation versucht die ursprüngliche Default-Route wiederherzustellen.

INPUT/OUTPUT-Regeln trennen zusätzlich die Node-Adressen: Aus dem Mesh sind nur Mesh-Protokoll, ICMP-Diagnose und HTTP auf den FFDD-Adressen erlaubt. Die Docker-/Uplink-Adresse und andere lokale Dienste sind von dort nicht erreichbar. Die Web-UI bleibt auf Port 80 über den Mesh-Anschluss und über den normalen Docker-/Managementanschluss verfügbar. Fehlgeroutete lokale Pakete in private Netze über Mesh und Pakete mit Mesh-Quelladresse über den Uplink werden gesperrt. IPv6-Mesh ist noch nicht unterstützt und wird explizit gesperrt. Diese Variante bietet weder Client-DHCP noch eine neue Internet-Ausleitung an.

Für ein lokal bereits bis zum PC transportiertes VLAN liegt ein Compose-Override bei. Beispiel für VLAN 1062 an Host-Interface enp6s0:

MESH_PARENT_INTERFACE=enp6s0.1062
HTTP_BIND_ADDRESS=127.0.0.1
HTTP_PORT=8080
docker compose -f docker-compose.yaml -f docker-compose.mesh.yaml config --quiet
docker compose -f docker-compose.yaml -f docker-compose.mesh.yaml up -d --build

Der Docker-macvlan-Treiber stellt daraus das Container-Interface mesh0 bereit; das normale Bridge-Netz hat weiterhin Vorrang für die Default-Route. Docker vergibt auf dem macvlan weder IP-Adresse noch Default-Gateway. Die Node leitet ihre Mesh-Adresse aus ihrer persistenten registrierten Identität ab. Die Knotennummer/Identität muss vor dem Anschluss an ein vorhandenes Mesh passen; keine fremde Nummer verwenden und nicht dieselbe Identität gleichzeitig auf mehreren Nodes betreiben.

Die Variante benötigt einen aktuellen Docker Engine/Compose mit enable_ipv4, interface_name und gw_priority. Docker kann die Trunk-Subschnittstelle enp6s0.1062 automatisch erstellen. Der Switchport muss VLAN 1062 getaggt zum PC transportieren. Host und macvlan-Container können auf dem macvlan standardmäßig nicht direkt miteinander sprechen; die lokale UI ist stattdessen über http://127.0.0.1:8080/ erreichbar. Der physische Host-Uplink und seine Default-Route werden nicht durch die Node umkonfiguriert.

Optionaler LAN-/Uplink-Zugriff auf FFDD

Standardmäßig bleibt LAN_MESH_ACCESS_ENABLED=false: Der normale Uplink ist kein Mesh-Clientanschluss und kein Internet-Exit. Die gezielte Freigabe wird explizit aktiviert, zum Beispiel:

LAN_MESH_ACCESS_ENABLED=true
LAN_MESH_ACCESS_SOURCES=192.168.10.0/24 192.168.20.5/32

LAN_MESH_ACCESS_SOURCES ist bei aktivierter Funktion zwingend erforderlich: eine durch Leerzeichen getrennte Liste explizit vertrauenswürdiger, kanonischer IPv4-CIDRs (Netzadresse mit Präfix, einzelne Hosts mit /32). Die Quellen müssen den am Container tatsächlich sichtbaren Quelladressen entsprechen. Docker-NAT kann diese verändern; nicht vorsorglich größere Netze freigeben. Auch öffentliche Unicast-Netze können ausdrücklich vertraut werden; RFC1918 ist keine Voraussetzung. Die Eingangs-Schnittstelle wird automatisch über die IPv4-Default-Route der MAIN-Routingtabelle bestimmt, nicht über einen fest verdrahteten Namen wie eth0.

Das einzige Zielnetz ist fest 10.200.0.0/16 und nicht konfigurierbar. Der Zugriff verwendet die primäre FFDD-Adresse dieser Node als SNAT-Quelle, damit Rückverkehr ohne Bekanntmachung der LAN-Netze im Mesh funktioniert. Dies ist keine Freigabe für Internet-Ausleitung, allgemeinen Uplink-Transit oder neue Mesh-Initiierungen ins LAN. LAN-Clients bzw. deren Router benötigen eine Route für 10.200.0.0/16 über den erreichbaren Container-Uplink; die Node ändert keine Host-/LAN-Routen. Die normalen Mesh-/Uplink-Schutzregeln bleiben für sonstigen Verkehr bestehen. Nur am Uplink ursprünglich eingegangene erlaubte Verbindungen werden per Conntrack-Markierung autorisiert. SNAT und die Rückrichtung verlangen diese Markierung; eine aus dem Mesh gefälschte LAN-Quelladresse allein reicht nicht. Die Freigabe für Antworten ist auf REPLY und ESTABLISHED/RELATED begrenzt. Auch Antworten des lokalen Webservers auf seine eigene Mesh-Adresse sind damit vom LAN aus möglich, ohne allgemeine Mesh-Quelladressen zum Uplink durchzulassen.

Explizite isolierte Pakettests (keine echten Netze, keine Registry):

python3 tests/integration_mesh_isolation.py ffdd-node:local-mesh
python3 tests/integration_lan_mesh_access.py ffdd-node:local-mesh
python3 tests/integration_runtime_capabilities.py ffdd-node:local-mesh

Der LAN-Test prüft Default aus, aktiviertes SNAT ohne LAN-Rückroute auf der Gegenstelle, nicht erlaubte Quellen/Ziele, Mesh→LAN-Sperre, gefälschte LAN-Quellen aus dem Mesh und erneutes Deaktivieren. Er verwendet vorab erfolgreiche Positivkontrollen, damit bloß fehlende Routen nicht als Firewall-Erfolg zählen.

Ungültige CIDRs, Hostbits in Netzpräfixen, IPv6, 0.0.0.0/0, Loopback, Link-local, Multicast und reservierte/Broadcast-Bereiche werden abgewiesen. Auch jede Überlappung mit FFDD 10.200.0.0/15 oder dem Transportnetz 10.203.0.0/16 ist verboten, einschließlich größerer umschließender Präfixe: LAN-Vertrauen darf kein Spoofing von Mesh-Quelladressen ermöglichen. Nichtleere Quelllisten werden auch bei deaktivierter Funktion validiert. Ein Quellpräfix ist eine Vertrauensentscheidung des Betreibers, kein Authentizitätsnachweis; es sollte so klein wie möglich sein. Es gibt weder Client-DHCP noch eine neue Internet-Gateway-Ankündigung.

Gateway-Präferenz und Anzeige

BMXD_PREFERRED_GATEWAY=10.200.200.21 übergibt die primäre Mesh-IP als bmxd- Präferenz (-p). Ein geeignetes erreichbares bevorzugtes Gateway gewinnt gegen bessere Alternativen; fehlt es oder zieht sein Gateway-Angebot zurück, kann bmxd auf ein anderes Gateway ausweichen. Die Nodes-Ansicht zeigt Bevorzugt (★) und Aktiv (●) unabhängig voneinander zwischen den Spalten Usage und BRC. Eine bevorzugte Adresse ist nicht automatisch der aktuell gewählte Exit; die aktive Gateway-Zeile erhält keinen besonderen Hintergrund mehr.

BMXD_ONLY_COMMUNITY_GATEWAYS=true (Default) wählt nur Gateway-Ankündigungen mit dem bmxd-Merkmal COMMUNITY_GATEWAY. Mit false werden auch andere angebotene Exits berücksichtigt. Die Einstellung akzeptiert auch 1/0; ungültige Werte werden beim Konfigurationscheck abgewiesen. Intern wird bmxd 1 bzw. 0 übergeben. Das Merkmal kennzeichnet die im Protokoll für Community-übergreifende Default-Ausleitung vorgesehenen Gateways. Es ist kein Filter nach NODE_COMMUNITY und kein Authentizitäts-/Vertrauensnachweis. Ein gewöhnlicher Router kann Internet anbieten, ohne dieses Merkmal zu setzen; solche Kandidaten bleiben im Gateway-Verzeichnis sichtbar, werden mit diesem Filter aber nicht ausgewählt. Die Präferenz überstimmt diesen Filter nicht.

Eine Auswahl allein schaltet weder die eigene Uplink-Freigabe noch eine Client-Ausleitung ein. Die tatsächliche Exit-Funktion bleibt separat abzusichern.

Web-UI und flüchtige Statistik

Die bestehende Navigation und Erweiterungsschnittstelle bleiben erhalten; Statistik kommt als zusätzlicher Bereich hinzu. Hell ist der Standard, Hell/Dunkel/System kann im Header gewählt und lokal im Browser gespeichert werden. Der Nodes-Filter durchsucht ausschließlich Node-ID und IP-Adresse der Zeile.

Die Statistik erfasst CPU, RAM und Backbone-Zähler unabhängig vom Browser einmal pro Sekunde. Die Auswahl 5 Min zeigt 1-Sekunden-Werte, 1h 15-Sekunden-Blöcke. CPU-/Traffic-Raten werden aus echten Zählerdifferenzen berechnet; Resets, fehlende Werte und Lücken bleiben Lücken. RAM-Blöcke enthalten Mittelwert und Min/Max. Das verschlüsselte WG-Underlay wird nicht zusätzlich zu seinen IPIP-Tunneln gezählt.

Der eigene Runit-Dienst statistics liest nur Ressourcen- und Interface-Dateien; bmxd-Abfragen, Registrierung und Schlüsselableitungen bleiben im bestehenden Sysinfo-Takt. Der begrenzte Ring liegt im Arbeitsspeicher. Öffentliche JSON-Dateien werden atomar im Laufzeit-tmpfs /dev/shm/ffdd-node-statistics bereitgestellt und unter /statistics.json bzw. /statistics-live.json verlinkt. /dev/shm muss im Runtime beschreibbar sein; es werden keine weiteren Capabilities, Ports oder Datenvolumes benötigt. Der volle Ring wird alle 15 Sekunden, ein kleiner Livetail jede Sekunde veröffentlicht. Inhalte sind auf Ressourcen und aggregierte Zähler begrenzt; Kontakt, Schlüssel, Konfiguration und gesamte Mesh-Topologie fehlen.

Ein Browser-Reload lädt den vorhandenen Verlauf sofort. Ein Neustart des Statistikdienstes oder eine Container-Neuerstellung beginnt einen neuen Ring; eine Laufzeitkennung verhindert das Vermischen verschiedener Ringe. Es gibt keine Datenbank und keine Speicherung auf /data.

Wichtige Endpunkte

  • GET /sysinfo.json
  • GET /sysinfo-json.cgi
  • GET /nodes.json
  • GET /statistics.json (versionierter Ring mit 1s-/15s-Auflösung)
  • GET /statistics-live.json (kleiner aktueller 1s-Ausschnitt)
  • GET /ui/
  • GET /licenses/* (Rechtstexte)

Wichtige Befehle (insb. bmxd -c)

Ausführen im Container:

docker compose exec -T dockernode <kommando>

bmxd-Status und Routing

bmxd -c status
  • Kurzstatus des Daemons (Uptime/Node/IP/Last)
bmxd -c options
  • Effektive bmxd-Parameter
bmxd -c --links
  • Direkte Nachbarn + Linkqualität (RTQ, RQ, TQ)
bmxd -c --gateways
  • Bekannte Gateways + bevorzugtes/ausgewähltes Gateway
bmxd -c --originators
  • Originator-Tabelle (Mesh-Routen, Next-Hop, BRC)

About

Dockerized "server" node for Freifunk Dreseden / Freifunk Leipzig

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages