SRV-Ziel-Adressen, Replay bei (Re-)Connect, Abbrucherkennung, unbekannte Config-Keys #22

Merged
jochen merged 2 commits from feat/replay-addr into master 2026-11-10 20:39:00 +00:00
Collaborator

Teil 2 der Portierung aus Branch auth / ZIP-Version, überarbeitet. Kein Protokollwechsel (Handshake bleibt v1).

Adress-Records der SRV-Ziele (filter.rs)

Bisher kamen A/AAAA-Records nur mit, wenn sie im selben Paket wie ein passender Dienstname standen. Die alte Variante always_forward_address_records ließ dagegen jeden Adress-Record des LANs durch, und nur egress.

Jetzt: Aus Paketen, die service_filters matchen, werden die SRV-Ziele gelernt (z. B. esp-kitchen.local). Danach passieren auch Pakete, die einen dieser Hosts nennen (A/AAAA, Adress-Queries). Das gilt bei Capture und Empfang, unbeteiligte Hosts bleiben lokal. Haltezeit mind. 75 min, max. 4096 Hosts.

Replay bei (Re-)Connect (replay.rs)

Lokal erfasste Pakete werden gecacht und direkt nach dem Handshake an den Peer geschickt. Ein neu gestarteter Standort ist so sofort synchron.

  • Ablauf nach kleinster TTL im Paket
  • Goodbye (TTL 0) entfernt alle Einträge mit dem Record; Goodbye-Pakete werden selbst nie gecacht
  • neueres Paket ersetzt ältere, deren Records es vollständig abdeckt (z. B. geänderter TXT)
  • SRV-Pakete zuerst, damit der Empfänger die Ziele kennt, bevor deren A-Records kommen (sonst verwirft sein Filter sie)
  • erst nach Dedup befüllt, damit die eigene Reinjektion (multicast_loop) nie als lokaler Zustand gilt

Abbrucherkennung

  • forward beobachtet die Lese-Seite → Neustart der Gegenseite wird sofort erkannt (vorher erst beim nächsten Live-Paket), der Reconnect löst das Replay aus
  • TCP-Keepalive 30 s / 10 s × 3 auf beiden Seiten für still verschwundene Peers (Host weg, Tunnel down)
  • ersetzt den periodischen Full-Resync (resync_interval_secs)

Unbekannte Config-Keys

Werden per serde_ignored gesammelt und beim Start als Warnung geloggt (inkl. Pfad, z. B. interfaces.0.multicast_tll). Für resync_interval_secs und always_forward_address_records gibt es eine Erklärung, was sie ersetzt. Beispiele und FreeBSD-Sample sind per Test frei davon.

Status: neu replayed, replay_cache_entries.

Getestet

  • fmt, clippy -D warnings, 39 Tests (5× stabil), FreeBSD cargo check, cargo audit
  • E2E mit zwei Daemons (Multicast auf ifb0/ifb1):
    • A-Record vor bekanntem SRV → bleibt lokal; nach SRV → kommt an; printer.local → bleibt lokal
    • B neu gestartet → A erkennt den Abbruch sofort, Reconnect nach ~1,5 s, Replay (SRV, dann A) wird auf B reinjiziert
    • SRV-Refresh nach dem A-Record → Replay-Reihenfolge trotzdem SRV vor A
    • nach Goodbye nur noch der A-Record im Cache; der neue B verwirft ihn korrekt (Dienst zurückgezogen)
    • Warnungen für resync_interval_secs und Tippfehler-Key erscheinen
  • Nicht lokal testbar: Keepalive bei still verschwundenem Peer (Loopback). Bitte beim OPNsense-Test einmal den Tunnel trennen und prüfen, dass nach ~1 min peer connection lost kommt.

Danach: Plugin.

🤖 Generated with Claude Code

https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp

Teil 2 der Portierung aus Branch `auth` / ZIP-Version, überarbeitet. Kein Protokollwechsel (Handshake bleibt v1). ## Adress-Records der SRV-Ziele (`filter.rs`) Bisher kamen A/AAAA-Records nur mit, wenn sie im selben Paket wie ein passender Dienstname standen. Die alte Variante `always_forward_address_records` ließ dagegen **jeden** Adress-Record des LANs durch, und nur egress. Jetzt: Aus Paketen, die `service_filters` matchen, werden die **SRV-Ziele gelernt** (z. B. `esp-kitchen.local`). Danach passieren auch Pakete, die einen dieser Hosts nennen (A/AAAA, Adress-Queries). Das gilt bei Capture **und** Empfang, unbeteiligte Hosts bleiben lokal. Haltezeit mind. 75 min, max. 4096 Hosts. ## Replay bei (Re-)Connect (`replay.rs`) Lokal erfasste Pakete werden gecacht und direkt nach dem Handshake an den Peer geschickt. Ein neu gestarteter Standort ist so sofort synchron. - Ablauf nach kleinster TTL im Paket - Goodbye (TTL 0) entfernt alle Einträge mit dem Record; Goodbye-Pakete werden selbst nie gecacht - neueres Paket ersetzt ältere, deren Records es vollständig abdeckt (z. B. geänderter TXT) - SRV-Pakete zuerst, damit der Empfänger die Ziele kennt, bevor deren A-Records kommen (sonst verwirft sein Filter sie) - erst nach Dedup befüllt, damit die eigene Reinjektion (`multicast_loop`) nie als lokaler Zustand gilt ## Abbrucherkennung - forward beobachtet die Lese-Seite → Neustart der Gegenseite wird **sofort** erkannt (vorher erst beim nächsten Live-Paket), der Reconnect löst das Replay aus - TCP-Keepalive 30 s / 10 s × 3 auf beiden Seiten für still verschwundene Peers (Host weg, Tunnel down) - ersetzt den periodischen Full-Resync (`resync_interval_secs`) ## Unbekannte Config-Keys Werden per `serde_ignored` gesammelt und beim Start als Warnung geloggt (inkl. Pfad, z. B. `interfaces.0.multicast_tll`). Für `resync_interval_secs` und `always_forward_address_records` gibt es eine Erklärung, was sie ersetzt. Beispiele und FreeBSD-Sample sind per Test frei davon. Status: neu `replayed`, `replay_cache_entries`. ## Getestet - fmt, clippy `-D warnings`, 39 Tests (5× stabil), FreeBSD `cargo check`, `cargo audit` - E2E mit zwei Daemons (Multicast auf ifb0/ifb1): - A-Record vor bekanntem SRV → bleibt lokal; nach SRV → kommt an; `printer.local` → bleibt lokal - B neu gestartet → A erkennt den Abbruch sofort, Reconnect nach ~1,5 s, Replay (SRV, dann A) wird auf B reinjiziert - SRV-Refresh nach dem A-Record → Replay-Reihenfolge trotzdem SRV vor A - nach Goodbye nur noch der A-Record im Cache; der neue B verwirft ihn korrekt (Dienst zurückgezogen) - Warnungen für `resync_interval_secs` und Tippfehler-Key erscheinen - **Nicht lokal testbar:** Keepalive bei still verschwundenem Peer (Loopback). Bitte beim OPNsense-Test einmal den Tunnel trennen und prüfen, dass nach ~1 min `peer connection lost` kommt. Danach: Plugin. 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp
Ported and reworked from the earlier ZIP version (branch `auth`):

- filter.rs: service_filters plus learned SRV targets. Hosts that SRV
  records of matching services point to are learned, and packets
  naming them (A/AAAA, address queries) pass too - on capture and on
  receive. Replaces always_forward_address_records, which let every
  address record of the LAN through and only on egress.
- replay.rs: locally captured packets are cached and pushed to a peer
  right after the handshake. Entries expire after their smallest TTL,
  a goodbye removes every entry with that record (goodbye packets are
  never cached), a newer packet replaces older ones it fully covers,
  SRV packets are replayed first so the receiver learns the targets
  before their address records arrive. Only fed after dedup, so our
  own reinjection (multicast_loop) never counts as local state.
- forward: the read half is watched for EOF/errors, so a restarted
  peer is noticed at once (and gets the replay), not on the next live
  packet. TCP keepalive (30 s / 10 s x 3) on both ends for peers that
  vanish silently. Replaces the periodic full resync.
- config: unknown keys are collected via serde_ignored and logged at
  startup; resync_interval_secs and always_forward_address_records get
  an explanation. Shipped examples are tested to have none.
- status: replayed counter, replay_cache_entries.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp
Config: warn about unknown keys; Cargo.lock; README
All checks were successful
build-freebsd / release (pull_request) Has been skipped
ci / rust (push) Successful in 2m54s
build-freebsd / freebsd (pull_request) Successful in 2m54s
ci / rust (pull_request) Successful in 2m57s
8602e66f87
- config: unknown keys collected via serde_ignored, warned at startup,
  with an explanation for removed options; shipped examples and the
  FreeBSD sample are tested to contain none
- Cargo.lock: serde_ignored
- README: SRV-target addresses, replay, dead-connection detection,
  unknown keys, new status fields

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp
jochen approved these changes 2026-11-10 20:38:51 +00:00
jochen merged commit a5e60d650c into master 2026-11-10 20:39:00 +00:00
jochen deleted branch feat/replay-addr 2026-11-10 20:39:00 +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!22
No description provided.