Stilles Fehlverhalten der Konfiguration beenden: leere Filterliste, doppelte Site-ID, Peer-Adressen, Dedup-Fenster #61

Merged
jochen merged 5 commits from fix/config-checks into master 2026-11-13 10:29:25 +00:00
Collaborator

Fixes #41, fixes #42, fixes #52. Baut auf master nach #60 auf.

Alle drei Issues haben dasselbe Muster: Eine Konfiguration, die so nicht gemeint sein kann, wurde angenommen, und der Daemon lief ohne Hinweis falsch weiter.

⚠ Verhaltensänderung: leere Filterliste

Eine leere service_filters-Liste brückt jetzt nichts mehr. Bis 0.1.1 bzw. Plugin 1.0.1 hat sie alles gebrückt. Wer wirklich alles brücken will, setzt forward_all_services = true (nur Labor; das Plugin bietet den Schalter bewusst nicht an).

Bitte vor dem Update auf allen vier Systemen prüfen, dass mindestens ein Filter aktiv ist. Sonst steht danach die Bridge. Das ist dann wenigstens sichtbar: WARN beim Start und in --check-config, im Plugin auf dem Status-Tab unter Configuration check.

Änderungen

#41 Leere Filterliste

  • ServiceFilter::new(vec![]) lässt nichts durch, ServiceFilter::all() alles.
  • Neuer Schlüssel forward_all_services (Standard false).
  • Config::warnings() liefert die Warnung für eine leere Liste, für forward_all_services und für beides zusammen (die Liste wird dann ignoriert). Ausgegeben werden sie beim Start und von --check-config.

#42 Gleiche Site-ID

  • Der letzte Eintrag im Pfad eines Frames ist der Nachbar, der ihn geschickt hat. Wer weiterreicht, hängt sich vorher selbst an. Ist dieser letzte Eintrag die eigene ID, ist das keine Schleife, sondern ein Peer mit derselben ID.
  • Solche Frames zählen jetzt als site_id_conflicts statt als dropped_loop. Dazu kommt eine WARN-Zeile, höchstens zehn pro Minute: the peer uses this site's site_id - every bridged site needs its own; nothing from it is accepted.
  • Ein Peer, der mit der eigenen site_id konfiguriert ist, ist ein Konfigurationsfehler.
  • Plugin: Der Hilfetext zur Site-ID sagt jetzt, was eine doppelte ID bewirkt und wo man sie sieht. Den Standardwert 1 habe ich gelassen: Ein Pflichtfeld ohne Default bricht Neuinstallationen (check_model.py, #33).

#52 Konfigurationsprüfung

  • peers[].addr muss host:port sein, mit Port 1–65535. Als Host gilt eine IPv4-Adresse, eine IPv6-Adresse in Klammern oder ein gültiger Name. Rein numerische Namen wie 10.0.0.256 werden abgewiesen. Die Fehlermeldung nennt den Peer: peer b: addr = "10.0.0.1:99999": port '99999' is not a number from 1 to 65535.
  • dedup_window_ms unter 100 wird abgewiesen, wie im Plugin.
  • Plugin: Die Maske für die Peer-Adresse lässt nur noch Ports 1–65535 zu, und zusätzlich IPv6 in Klammern.

Nachgestellt (Linux, zwei Daemons, Release-Build)

Szenario master dieser Branch
Beide Seiten site_id = 1, eine Ankündigung B: dropped_loop 1, kein Log-Eintrag B: site_id_conflicts 1, dropped_loop 0, WARN mit Peer-Adresse
dedup_window_ms = 0 + multicast_loop auf beiden Seiten ein Paket kreist, ~9500 Multicast/s je LAN Daemon startet nicht, Fehlermeldung mit Begründung
addr = "10.0.0.1:99999" --check-config OK, danach Fehler bei jedem Verbindungsversuch --check-config schlägt fehl, Apply wird abgelehnt
service_filters = [] alles gebrückt, kein Hinweis nichts gebrückt, WARN

Regressionen laufen unverändert durch: E2E-Herkunftsprüfung (12/12), Peer-Frames (#36), Replay nach Neustart der Gegenseite (2000/2000, dropped_rate 0).

Tests

95 Unit-Tests grün (4 neu, 1 umgeschrieben), clippy -D warnings für Linux und das FreeBSD-Target. Plugin: render_templates.py und check_model.py grün. Die Szenarien ohne Filter erwarten jetzt die Warnung; jede andere Warnung lässt den Test weiterhin scheitern.

Neu:

  • Leere Liste lässt nichts durch, all() alles.
  • 6 gültige und 11 ungültige Peer-Adressen.
  • Dedup-Minimum und eigene Site-ID am Peer.
  • Die Filter-Warnungen.
  • Am echten Listener: Konflikt, echte Schleife und normales Paket werden unterschieden.

Hinweise

  • Commit 9836349 ist ohne listener.rs hochgegangen und baut für sich allein nicht. b9fc14f reicht die Datei nach. Ab dort ist jeder Commit grün; am Diff gegen master ändert das nichts.
  • Die Site-ID im Handshake (Vorschlag 3 in #42) habe ich nicht umgesetzt. Das ist eine Protokolländerung und gehört zusammen mit #47.
  • FreeBSD: nur über die Unit-Tests auf dem Runner geprüft. Die Plugin-Maske habe ich mit Python-re getestet, nicht mit PHP.

🤖 Generated with Claude Code

https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp

Fixes #41, fixes #42, fixes #52. Baut auf master nach #60 auf. Alle drei Issues haben dasselbe Muster: Eine Konfiguration, die so nicht gemeint sein kann, wurde angenommen, und der Daemon lief ohne Hinweis falsch weiter. ## ⚠ Verhaltensänderung: leere Filterliste **Eine leere `service_filters`-Liste brückt jetzt nichts mehr.** Bis 0.1.1 bzw. Plugin 1.0.1 hat sie alles gebrückt. Wer wirklich alles brücken will, setzt `forward_all_services = true` (nur Labor; das Plugin bietet den Schalter bewusst nicht an). **Bitte vor dem Update auf allen vier Systemen prüfen, dass mindestens ein Filter aktiv ist.** Sonst steht danach die Bridge. Das ist dann wenigstens sichtbar: WARN beim Start und in `--check-config`, im Plugin auf dem Status-Tab unter *Configuration check*. ## Änderungen **#41 Leere Filterliste** - `ServiceFilter::new(vec![])` lässt nichts durch, `ServiceFilter::all()` alles. - Neuer Schlüssel `forward_all_services` (Standard `false`). - `Config::warnings()` liefert die Warnung für eine leere Liste, für `forward_all_services` und für beides zusammen (die Liste wird dann ignoriert). Ausgegeben werden sie beim Start und von `--check-config`. **#42 Gleiche Site-ID** - Der letzte Eintrag im Pfad eines Frames ist der Nachbar, der ihn geschickt hat. Wer weiterreicht, hängt sich vorher selbst an. Ist dieser letzte Eintrag die eigene ID, ist das keine Schleife, sondern ein Peer mit derselben ID. - Solche Frames zählen jetzt als `site_id_conflicts` statt als `dropped_loop`. Dazu kommt eine WARN-Zeile, höchstens zehn pro Minute: `the peer uses this site's site_id - every bridged site needs its own; nothing from it is accepted`. - Ein Peer, der mit der eigenen `site_id` konfiguriert ist, ist ein Konfigurationsfehler. - Plugin: Der Hilfetext zur Site-ID sagt jetzt, was eine doppelte ID bewirkt und wo man sie sieht. Den Standardwert 1 habe ich gelassen: Ein Pflichtfeld ohne Default bricht Neuinstallationen (`check_model.py`, #33). **#52 Konfigurationsprüfung** - `peers[].addr` muss `host:port` sein, mit Port 1–65535. Als Host gilt eine IPv4-Adresse, eine IPv6-Adresse in Klammern oder ein gültiger Name. Rein numerische Namen wie `10.0.0.256` werden abgewiesen. Die Fehlermeldung nennt den Peer: `peer b: addr = "10.0.0.1:99999": port '99999' is not a number from 1 to 65535`. - `dedup_window_ms` unter 100 wird abgewiesen, wie im Plugin. - Plugin: Die Maske für die Peer-Adresse lässt nur noch Ports 1–65535 zu, und zusätzlich IPv6 in Klammern. ## Nachgestellt (Linux, zwei Daemons, Release-Build) | Szenario | master | dieser Branch | |---|---|---| | Beide Seiten `site_id = 1`, eine Ankündigung | B: `dropped_loop` 1, kein Log-Eintrag | B: `site_id_conflicts` 1, `dropped_loop` 0, WARN mit Peer-Adresse | | `dedup_window_ms = 0` + `multicast_loop` auf beiden Seiten | ein Paket kreist, ~9500 Multicast/s je LAN | Daemon startet nicht, Fehlermeldung mit Begründung | | `addr = "10.0.0.1:99999"` | `--check-config` OK, danach Fehler bei jedem Verbindungsversuch | `--check-config` schlägt fehl, Apply wird abgelehnt | | `service_filters = []` | alles gebrückt, kein Hinweis | nichts gebrückt, WARN | Regressionen laufen unverändert durch: E2E-Herkunftsprüfung (12/12), Peer-Frames (#36), Replay nach Neustart der Gegenseite (2000/2000, `dropped_rate` 0). ## Tests 95 Unit-Tests grün (4 neu, 1 umgeschrieben), `clippy -D warnings` für Linux und das FreeBSD-Target. Plugin: `render_templates.py` und `check_model.py` grün. Die Szenarien ohne Filter erwarten jetzt die Warnung; jede andere Warnung lässt den Test weiterhin scheitern. Neu: - Leere Liste lässt nichts durch, `all()` alles. - 6 gültige und 11 ungültige Peer-Adressen. - Dedup-Minimum und eigene Site-ID am Peer. - Die Filter-Warnungen. - Am echten Listener: Konflikt, echte Schleife und normales Paket werden unterschieden. ## Hinweise - Commit 9836349 ist ohne `listener.rs` hochgegangen und baut für sich allein nicht. b9fc14f reicht die Datei nach. Ab dort ist jeder Commit grün; am Diff gegen master ändert das nichts. - Die Site-ID im Handshake (Vorschlag 3 in #42) habe ich nicht umgesetzt. Das ist eine Protokolländerung und gehört zusammen mit #47. - FreeBSD: nur über die Unit-Tests auf dem Runner geprüft. Die Plugin-Maske habe ich mit Python-`re` getestet, nicht mit PHP. 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp
Empty filter list bridges nothing; a peer with our site_id is reported
Some checks failed
ci / rust (push) Failing after 1m3s
9836349128
An empty service_filters list bridged every mDNS packet of the LAN, in
both directions - and that is what the OPNsense plugin renders while no
filter is enabled (#41). It now bridges nothing; ServiceFilter::all()
is the explicit way to bridge everything (wired to a config switch with
the next commit).

Two connected sites with the same site_id dropped everything they got
from each other at the loop guard, counted as dropped_loop and nothing
else (#42). The last site in a frame's path is the neighbour that sent
it; if that is our own site_id, it is not a loop but a peer with the
same ID. Such frames are now counted as site_id_conflicts and logged
(ten lines a minute at most).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp
Belongs to the previous commit, which went up without this file: the
site_id check before the loop guard (#42) with its test, and the
listener tests use ServiceFilter::all() now that an empty list admits
nothing.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp
- peers[].addr must be host:port with a port from 1 to 65535 and a host
  that is an IPv4 address, an IPv6 address in brackets or a valid name.
  10.0.0.1:99999 used to pass --check-config, and the daemon then failed
  every connect (#52).
- dedup_window_ms below 100 is refused, as in the plugin: with 0 and
  multicast_loop on two sites, one packet circled between them for
  good, about 9500 multicast packets a second in each LAN (#52).
- A peer configured with this site's own site_id is an error (#42).
- forward_all_services = true is the explicit way to bridge everything
  (#41). An empty service_filters list, and forward_all_services, are
  logged as warnings at startup and by --check-config, which the
  plugin shows on its Status tab.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp
- The peer address mask accepts ports 1 to 65535 only, and IPv6
  addresses in brackets (#52). The daemon's check stays the authority;
  the mask catches the obvious cases in the dialog already.
- The site ID help says what a duplicate ID does and where it shows.
  The default 1 stays: a required field without a default breaks fresh
  installs (check_model.py, #33).
- render_templates.py: scenarios without an enabled filter now get the
  warning that nothing is bridged; it is expected there, any other
  warning still fails.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp
README: empty filter list, forward_all_services, config checks, site_id_conflicts
All checks were successful
ci / rust (push) Successful in 3m23s
build-freebsd / freebsd (pull_request) Successful in 3m7s
build-freebsd / release (pull_request) Has been skipped
ci / rust (pull_request) Successful in 3m26s
50c1dcd7af
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp
Author
Collaborator

Korrektur zum Hinweis auf die Commit-Historie in der Beschreibung: Nicht nur 9836349, auch b9fc14f ist im CI rot. Der Grund: ServiceFilter::all() wird bis e234214 nur in Tests benutzt, und clippy meldet für den Release-Build toten Code. Erst ab e234214 sind die Commits grün.

Der Endstand (50c1dcd) ist grün: 95 Tests unter Linux und auf dem FreeBSD-Runner, render_templates.py alle vier Szenarien ok, check_model.py ohne Befund.

Korrektur zum Hinweis auf die Commit-Historie in der Beschreibung: Nicht nur 9836349, auch b9fc14f ist im CI rot. Der Grund: `ServiceFilter::all()` wird bis e234214 nur in Tests benutzt, und clippy meldet für den Release-Build toten Code. Erst ab e234214 sind die Commits grün. Der Endstand (50c1dcd) ist grün: 95 Tests unter Linux und auf dem FreeBSD-Runner, `render_templates.py` alle vier Szenarien ok, `check_model.py` ohne Befund.
jochen approved these changes 2026-11-13 10:28:56 +00:00
jochen merged commit 362b76df9e into master 2026-11-13 10:29:25 +00:00
jochen deleted branch fix/config-checks 2026-11-13 10:29:25 +00:00
Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
jochen/mdns-bridge!61
No description provided.