Dieser Ordner enthält einen containerisierten Freifunk-Servernode mit:
registrar(Registrierung, Node-ID, fastd/bmxd Runtime-Dateien)sysinfo(30s-Refresh vonsysinfo.json+nodes.json)wireguard(Status-Logging für WireGuard-Peers)fastd+bmxdnginx(Port 80, UI + JSON-Endpunkte)
- Docker + Docker Compose Plugin
- Linux-Host mit
/dev/net/tun - Der Container muss
net.ipv4.ip_forward=1aktivieren können
cd dockernode
cp .env.example .envMindestens diese Werte in .env setzen:
NODE_CONTACT_EMAILNODE_NAMENODE_COMMUNITY(DresdenoderLeipzig)NODE_GPS_LATITUDENODE_GPS_LONGITUDE
Optional:
BACKBONE_PEERSleer lassen → Defaults ausconfig/defaults.yamlNODE_REGISTRATION_URLleer lassen → Defaults ausconfig/defaults.yamlREGISTRAR_INTERVALmuss zwischen3600und21600Sekunden liegen (1–6h)
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:roEin 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.
docker compose build dockernodeBei einem Git-Tag-Push baut GitHub Actions automatisch ein Image und pusht es nach GHCR:
ghcr.io/freifunkstuff/ffdd-node:<tag>- Push auf
mastererzeugt zusätzlich:ghcr.io/freifunkstuff/ffdd-node:master
Beispiel:
git tag v1.0.1
git push origin v1.0.1Ergebnis:
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.1docker compose up -d dockernodedocker 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/ | headIm Container laufen getrennte Dienste:
registrarsysinfowireguardfastdbmxdnginx
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 sysinfoLogs ansehen:
docker compose logs -f dockernodeDer 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.
Persistente Daten liegen auf dem Host in:
./data/node.yaml
Darin werden u. a. gespeichert:
registration.node_idregistration.register_keyfastd.secretwireguard.secret
Flüchtige Laufzeitdaten liegen im Container unter:
/run/freifunk/fastd/run/freifunk/bmxd/run/freifunk/sysinfo/run/freifunk/www
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.
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.
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_capacityist die exakte Kapazität in CPU-Äquivalenten; die Cpuset-Anzahl ist separat. Das ältere ganzzahligecpucountrundet 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_statund 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/uptimeminus 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:masterDie 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.
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.
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/32Der 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=8080docker 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 --buildDer 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.
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/32LAN_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-meshDer 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.
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.
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.
GET /sysinfo.jsonGET /sysinfo-json.cgiGET /nodes.jsonGET /statistics.json(versionierter Ring mit 1s-/15s-Auflösung)GET /statistics-live.json(kleiner aktueller 1s-Ausschnitt)GET /ui/GET /licenses/*(Rechtstexte)
Ausführen im Container:
docker compose exec -T dockernode <kommando>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)