Review-Fixes, Linux-Support und Forgejo-CI #16

Merged
jochen merged 3 commits from fix/review-findings-linux-support into master 2026-11-10 08:58:18 +00:00
Collaborator

Setzt die Befunde aus dem Review um, macht den Daemon Linux-tauglich und stellt die CI auf Forgejo Actions um.

Schließt

Closes #1, Closes #2, Closes #3, Closes #6, Closes #7, Closes #8, Closes #9, Closes #10, Closes #13

Teilweise / nur Doku

  • #5 – README und Code-Kommentare korrigiert (Neustart nach Adresswechsel nötig); Join per ifindex bleibt offen
  • #11 – cargo audit läuft in der CI, vorerst nicht blockierend; Dependency-Update bleibt offen
  • #14 – Workflow für den FreeBSD-Runner vorbereitet; Runner und Plugin fehlen noch

Änderungen

Sicherheit (#1)

  • Listener bindet an listen_addr → source_addr → 0.0.0.0 (mit Warnung)
  • Allowlist: aufgelöste Adressen aller [[peers]] + allowed_peers; leere Allowlist lehnt alles ab; allow_any_peer = true als expliziter Lab-Opt-out
  • service_filters wird auch auf empfangene Pakete angewandt
  • Neue Status-Zähler dropped_filter, rejected_peers

Korrektheit

  • Filter-Suffix nur an Label-Grenzen (#3)
  • SIGTERM-Handling, Status-Socket wird beim Beenden entfernt (#8)
  • Doku: Peer-Verbindungen sind unidirektional (#2), Beispiele ohne multicast_ttl = 1 (#9)

Linux (#6, #7, #13)

  • IP_MULTICAST_ALL/IPV6_MULTICAST_ALL = 0 → jeder Capture-Socket sieht nur sein Interface
  • Option multicast_loop pro Interface für Betrieb auf dem HA/Avahi-Host
  • OS-abhängige Defaults (/etc/mdns-bridge.toml, /run/mdns-bridged/…)
  • Gehärtete systemd-Unit (DynamicUser, keine Capabilities), examples/linux.toml

CI (#10)

  • .forgejo/workflows/ci.yml (runs-on: docker, wie certsmith): fmt, clippy -D warnings, Tests, FreeBSD-cargo check, cargo audit, statisches musl-Binary als Artefakt
  • .forgejo/workflows/build-freebsd.yml: nativer Build auf freebsd-14-Runner bei v*-Tags, Upload per forgejo-release
  • GitHub-Workflow entfernt, .gitignore ergänzt

Hinweis: cargo fmt lief einmal über das ganze Crate, daher reine Formatänderungen in capture.rs, forward.rs, reinject.rs, status.rs.

Getestet

  • cargo fmt --check, cargo clippy --all-targets -- -D warnings, cargo test (12 Tests, vorher 3)
  • cargo check --target x86_64-unknown-freebsd, statischer musl-Release-Build (2,8 MB)
  • systemd-analyze verify der Unit
  • End-to-End unter Linux mit zwei Daemons auf ifb0/ifb1:
    • ESPHome-Announcement an Standort A → kommt an Standort B per Multicast an; AirPlay wird am Capture gefiltert
    • Standort A sieht keinen Traffic von ifb1 (IP_MULTICAST_ALL wirkt)
    • multicast_loop = true an B: eigenes Echo per Dedup verworfen (dropped_dedup: 1)
    • Verbindung von nicht erlaubter Quell-IP abgewiesen (rejected_peers: 1)
    • Erlaubter Peer schickt nicht passenden Dienst → verworfen (dropped_filter: 1)
    • SIGTERM: sauberes Herunterfahren, Status-Socket entfernt

Nicht getestet: Lauf auf echter OPNsense und der FreeBSD-Workflow (Runner existiert noch nicht).

Achtung beim Ausrollen

Sites, die bisher nur empfangen und keinen [[peers]]-Eintrag für den Sender haben, lehnen nach dem Update dessen Verbindungen ab. Dort den Sender als Peer oder unter allowed_peers eintragen.

Setzt die Befunde aus dem Review um, macht den Daemon Linux-tauglich und stellt die CI auf Forgejo Actions um. ## Schließt Closes #1, Closes #2, Closes #3, Closes #6, Closes #7, Closes #8, Closes #9, Closes #10, Closes #13 ## Teilweise / nur Doku - #5 – README und Code-Kommentare korrigiert (Neustart nach Adresswechsel nötig); Join per ifindex bleibt offen - #11 – `cargo audit` läuft in der CI, vorerst nicht blockierend; Dependency-Update bleibt offen - #14 – Workflow für den FreeBSD-Runner vorbereitet; Runner und Plugin fehlen noch ## Änderungen **Sicherheit (#1)** - Listener bindet an `listen_addr` → `source_addr` → `0.0.0.0` (mit Warnung) - Allowlist: aufgelöste Adressen aller `[[peers]]` + `allowed_peers`; leere Allowlist lehnt alles ab; `allow_any_peer = true` als expliziter Lab-Opt-out - `service_filters` wird auch auf empfangene Pakete angewandt - Neue Status-Zähler `dropped_filter`, `rejected_peers` **Korrektheit** - Filter-Suffix nur an Label-Grenzen (#3) - SIGTERM-Handling, Status-Socket wird beim Beenden entfernt (#8) - Doku: Peer-Verbindungen sind unidirektional (#2), Beispiele ohne `multicast_ttl = 1` (#9) **Linux (#6, #7, #13)** - `IP_MULTICAST_ALL`/`IPV6_MULTICAST_ALL = 0` → jeder Capture-Socket sieht nur sein Interface - Option `multicast_loop` pro Interface für Betrieb auf dem HA/Avahi-Host - OS-abhängige Defaults (`/etc/mdns-bridge.toml`, `/run/mdns-bridged/…`) - Gehärtete systemd-Unit (`DynamicUser`, keine Capabilities), `examples/linux.toml` **CI (#10)** - `.forgejo/workflows/ci.yml` (`runs-on: docker`, wie certsmith): fmt, clippy `-D warnings`, Tests, FreeBSD-`cargo check`, `cargo audit`, statisches musl-Binary als Artefakt - `.forgejo/workflows/build-freebsd.yml`: nativer Build auf `freebsd-14`-Runner bei `v*`-Tags, Upload per `forgejo-release` - GitHub-Workflow entfernt, `.gitignore` ergänzt Hinweis: `cargo fmt` lief einmal über das ganze Crate, daher reine Formatänderungen in `capture.rs`, `forward.rs`, `reinject.rs`, `status.rs`. ## Getestet - `cargo fmt --check`, `cargo clippy --all-targets -- -D warnings`, `cargo test` (12 Tests, vorher 3) - `cargo check --target x86_64-unknown-freebsd`, statischer musl-Release-Build (2,8 MB) - `systemd-analyze verify` der Unit - End-to-End unter Linux mit zwei Daemons auf `ifb0`/`ifb1`: - ESPHome-Announcement an Standort A → kommt an Standort B per Multicast an; AirPlay wird am Capture gefiltert - Standort A sieht keinen Traffic von ifb1 (`IP_MULTICAST_ALL` wirkt) - `multicast_loop = true` an B: eigenes Echo per Dedup verworfen (`dropped_dedup: 1`) - Verbindung von nicht erlaubter Quell-IP abgewiesen (`rejected_peers: 1`) - Erlaubter Peer schickt nicht passenden Dienst → verworfen (`dropped_filter: 1`) - SIGTERM: sauberes Herunterfahren, Status-Socket entfernt **Nicht getestet:** Lauf auf echter OPNsense und der FreeBSD-Workflow (Runner existiert noch nicht). ## Achtung beim Ausrollen Sites, die bisher nur empfangen und keinen `[[peers]]`-Eintrag für den Sender haben, lehnen nach dem Update dessen Verbindungen ab. Dort den Sender als Peer oder unter `allowed_peers` eintragen.
- Listener binds to listen_addr/source_addr and only accepts peers from
  the allowlist (resolved [[peers]] + allowed_peers); allow_any_peer as
  explicit lab opt-out (#1)
- service_filters are applied to received packets as well (#1)
- Document that peer connections are one-directional (#2)
- Filter suffix match respects label boundaries (#3)
- Document that the interface address is only resolved at startup (#5)
- Linux: disable IP_MULTICAST_ALL / IPV6_MULTICAST_ALL so each capture
  socket only sees its own interface (#6)
- Per-interface multicast_loop option for co-located HA/Avahi (#7)
- Shut down cleanly on SIGTERM and remove the status socket (#8)
- OS-specific defaults for config path and status socket (#13)
- New status counters dropped_filter and rejected_peers
- cargo fmt over the whole crate; clippy -D warnings clean

Refs #1 #2 #3 #5 #6 #7 #8 #13
- dist/linux/mdns-bridged.service: unprivileged (DynamicUser) and
  hardened systemd unit with RuntimeDirectory for the status socket
- examples/linux.toml for sites without OPNsense
- examples: drop multicast_ttl = 1 (RFC 6762 requires 255), document
  listen_addr/allowed_peers and that both sites list each other (#2, #9)
- README: one-directional peers, ingress filter/allowlist, DHCP restart,
  Linux section, Forgejo CI section, open items linked to issues
- .gitignore for target/

Refs #2 #5 #9 #13
CI: replace GitHub workflow with Forgejo Actions
All checks were successful
ci / rust (push) Successful in 8m27s
ci / rust (pull_request) Successful in 8m14s
e8d22f2107
- ci.yml (runs-on: docker, rust:1-bookworm): fmt, clippy -D warnings,
  tests, cargo check for FreeBSD, cargo audit (non-blocking until #11),
  static Linux musl build as artifact
- build-freebsd.yml: native build on a FreeBSD host runner
  (runs-on: freebsd-14) on v* tags, upload via upload-artifact@v3 and
  forgejo-release instead of GitHub-only actions
- Remove .github/workflows/build-freebsd.yml

Refs #10 #14
jochen approved these changes 2026-11-10 08:43:48 +00:00
jochen merged commit 2af641bfed into master 2026-11-10 08:58:18 +00:00
jochen deleted branch fix/review-findings-linux-support 2026-11-10 08:58:18 +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!16
No description provided.