Mesh: sonene melder seg selv; mDNS på LAN, NetBird-provisjonering

Sonene trenger ikke stå i [zones] på sentralen. En sone sender hjerteslag
hvert 30. s (POST /api/mesh/register med navn, egen adresse og
mesh-nøkkelen), dukker opp i lista med en gang, og tas ut etter 90 s uten
slag. Riktig nøkkel er godkjenningen. Statisk [zones] vinner over et navn
som melder seg (409) – en skrivefeil i config skal ikke kunne overstyres av
en boks på nettet.

Hvorfor push og ikke pull fra NetBird: netbird status --json gir navn, IP og
status per peer, men ikke grupper. Pull ville krevd en service-token mot
management-serveren og virket bare over NetBird. Push virker likt over
NetBird og LAN, uten token, og gir liveness gratis.

Sonen finner sentralen lagvis: ANNOUNCER_SENTRAL hvis satt (NetBird-DNS-navn,
konvensjon announcer-<navn>.skynet.corp), ellers mDNS (_announcer._tcp,
discovery.py). Egen adresse regnes ut som ruten mot sentralen – over NetBird
blir det wt0-adressen, på LAN LAN-adressen – med ANNOUNCER_URL som
overstyring. Hjerteslag hvert 5. s til første OK, så oppstart ikke tar et
halvt minutt.

Containeren bruker nå vertens nett. mDNS-multicast når ikke LAN-et fra
bridge-nettet, så det var ingen vei utenom – og det ga tilbake ufw: det
gamle Docker-smutthullet er borte, portregler virker igjen, og BIND_IP er
appens eget --host. Appen lytter alltid også på 127.0.0.1 for helsesjekken.

install.sh tar NETBIRD_SETUP_KEY: installerer NetBird, melder maskina inn
som announcer-<navn>, venter på wt0, binder til NetBird-adressen.
Management-URL leses fra /etc/netbird/config.json når den finnes.

Rollen avgjøres av config (Config.role): sentral hvis [zones] eller
ANNOUNCER_ROLE=sentral, sone hvis bare nøkkelen er satt, ellers som før.
Dispatcher og ZonePoller slår opp soner ved hver bruk, siden de kommer og
går. register følger, som play, aldri med «alt åpent». Flask sorterte
JSON-nøkler alfabetisk, så sonene kom i feil rekkefølge i /api/status –
app.json.sort_keys = False.

25 nye tester, 173 totalt. Verifisert i compose på host-nett: to soner
meldte seg innen 4 s uten noe [zones], fordeling til en av dem havnet i kø,
avahi-browse på verten ser sentralen, en stoppet sone ble tatt ut etter 90 s
og var tilbake 2 s etter start. Underveis fant live-testen at testkonfigen
fortsatt hadde statiske a/b – og sentralen avviste hjerteslagene med 409,
som den skal.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
This commit is contained in:
Kent 2026-10-09 02:50:25 +02:00
parent c4a15799dd
commit 7c521f8d1f
21 changed files with 1106 additions and 137 deletions

View file

@ -21,6 +21,7 @@ import queue
import re
import secrets
import shutil
import socket
import struct
import subprocess
import threading
@ -33,11 +34,13 @@ from flask import Flask, Response, abort, jsonify, request, send_file
import auth
import config
import discovery
import mesh
import schedule as sched
from auth import require
HERE = Path(__file__).resolve().parent
VERSION = "0.3"
CFG = config.load()
VOICE_DIR = CFG.path("voices")
CACHE_DIR = CFG.path("cache")
@ -90,6 +93,9 @@ app = Flask(__name__, static_folder=None)
# En WAV fra sentralen: et par MB for en normal melding. Grensen er romslig
# bare for å stoppe det som åpenbart ikke er lyd.
app.config["MAX_CONTENT_LENGTH"] = 64 * 1024 * 1024
# Rekkefølgen i dict-ene betyr noe her: soner vises i konfigurert rekkefølge,
# med sentralens eget anlegg først. Flask sorterer nøkler alfabetisk ellers.
app.json.sort_keys = False
AUTH = auth.install(app, CFG)
@ -542,8 +548,12 @@ try:
except ValueError as e:
raise SystemExit(f"config: {e}") from e
MESH_SECRET = str(CFG.get("mesh", "secret", "")).strip()
if ZONES and not MESH_SECRET and any(not z.local for z in ZONES.values()):
raise SystemExit("config: [zones] har eksterne soner, men ANNOUNCER_MESH_SECRET er ikke satt")
ROLE = CFG.role # sentral | sone | none
MESH_NAME = str(CFG.get("mesh", "name", "")).strip() or socket.gethostname().split(".")[0]
if ROLE == "sentral" and not MESH_SECRET and (any(not z.local for z in ZONES.values()) or not ZONES):
raise SystemExit("config: sentral uten ANNOUNCER_MESH_SECRET – sonene kan ikke melde seg")
if ROLE == "sone" and not MESH_SECRET:
raise SystemExit("config: sone uten ANNOUNCER_MESH_SECRET")
def _play_local(d: mesh.Dispatch, path: Path) -> int:
@ -567,12 +577,26 @@ def _dispatch_finished(d: mesh.Dispatch) -> None:
schedule.mark(d.schedule_id, "failed", d.error or d.summary())
REGISTRY: mesh.Registry | None = None
DISPATCHER: mesh.Dispatcher | None = None
POLLER: mesh.ZonePoller | None = None
if ZONES:
HEARTBEAT: mesh.Heartbeat | None = None
ADVERTISER: discovery.Advertiser | None = None
BROWSER: discovery.Browser | None = None
if ROLE == "sentral":
# Eget anlegg er en sone som alle andre. Navnet kommer fra [zones] hvis
# noen der står som "local" (gammel stil: her = "local"), ellers fra
# mesh.name. local = false på en sentral som bare fordeler.
_locals = [z for z in ZONES.values() if z.local]
_local = _locals[0] if _locals else (mesh.Zone(MESH_NAME) if CFG.get("mesh", "local", True) else None)
REGISTRY = mesh.Registry(
{n: z for n, z in ZONES.items() if not z.local},
local=_local,
stale_seconds=float(CFG.get("mesh", "stale_seconds", 90)),
)
_timeout = float(CFG.get("mesh", "timeout_seconds", 5))
DISPATCHER = mesh.Dispatcher(
ZONES,
REGISTRY.zones,
synthesize=lambda *a: synthesize(*a),
play_local=_play_local,
send=lambda zone, path, d: mesh.send_to_zone(zone, path, d, secret=MESH_SECRET, timeout=_timeout),
@ -580,7 +604,7 @@ if ZONES:
on_finished=_dispatch_finished,
)
POLLER = mesh.ZonePoller(
ZONES,
REGISTRY.zones,
fetch=lambda zone: mesh.fetch_zone_status(zone, secret=MESH_SECRET),
interval=float(CFG.get("mesh", "poll_seconds", 2)),
local_status=lambda: {
@ -652,6 +676,45 @@ def start_scheduler() -> None:
threading.Thread(target=_scheduler_loop, daemon=True, name="scheduler").start()
def _pruner_loop() -> None:
while True:
time.sleep(10)
try:
for name in REGISTRY.prune():
audit("zone_lost", zone=name)
except Exception: # noqa: BLE001
log.exception("pruneren feilet")
def start_mesh(host: str, port: int) -> None:
"""Trådene og annonseringen som trenger å vite hvor vi lytter."""
global HEARTBEAT, ADVERTISER, BROWSER
mdns = bool(CFG.get("mesh", "mdns", True))
if ROLE == "sentral":
DISPATCHER.start()
POLLER.start()
threading.Thread(target=_pruner_loop, daemon=True, name="pruner").start()
if mdns:
ADVERTISER = discovery.Advertiser(name=MESH_NAME, port=port, role="sentral",
ip=host, version=VERSION)
ADVERTISER.start()
log.info("mesh: sentral «%s», soner nå: %s", MESH_NAME, ", ".join(REGISTRY.zones()) or "ingen")
elif ROLE == "sone":
fixed = str(CFG.get("mesh", "sentral", "")).strip().rstrip("/")
if not fixed and mdns:
BROWSER = discovery.Browser(role="sentral")
BROWSER.start()
HEARTBEAT = mesh.Heartbeat(
name=MESH_NAME, port=port, secret=MESH_SECRET,
sentral=lambda: fixed or (BROWSER.current() if BROWSER else None),
url=str(CFG.get("mesh", "url", "")),
interval=float(CFG.get("mesh", "heartbeat_seconds", 30)),
version=VERSION,
)
HEARTBEAT.start()
log.info("mesh: sone «%s», sentral: %s", MESH_NAME, fixed or ("søker med mDNS" if BROWSER else "ikke satt"))
# --------------------------------------------------------------------------
# HTTP
# --------------------------------------------------------------------------
@ -840,6 +903,23 @@ def play() -> Response:
return jsonify({"id": item.id})
@app.post("/api/mesh/register")
def mesh_register() -> Response:
"""Hjerteslag fra en sone. Riktig nøkkel er godkjenningen."""
me = require("register")
if REGISTRY is None:
abort(404, "Denne maskina er ikke sentral")
data = request.get_json(silent=True) or {}
try:
zone = REGISTRY.register(data.get("name", ""), data.get("url", ""),
str(data.get("version", ""))[:40])
except ValueError as e:
msg = str(e)
abort(409 if ("er satt" in msg or "eget navn" in msg) else 400, msg)
return jsonify({"ok": True, "name": zone.name, "stale_seconds": REGISTRY.stale,
"sentral": MESH_NAME})
@app.post("/api/schedule")
def schedule_add() -> Response:
me = require("schedule")
@ -906,8 +986,11 @@ def status() -> Response:
"now": time.time(), # klienten regner «om 20 min» mot serverens klokke
}
if DISPATCHER is not None:
out["zones"] = POLLER.snapshot()
info = REGISTRY.info() if REGISTRY else {}
out["zones"] = {n: {**z, **info.get(n, {})} for n, z in POLLER.snapshot().items()}
out["dispatches"] = DISPATCHER.snapshot(show_ip=me.can("clear"))
out["mesh"] = {"role": ROLE, "name": MESH_NAME,
"heartbeat": HEARTBEAT.status() if HEARTBEAT else None}
return jsonify(out)
@ -931,6 +1014,11 @@ def forbidden(e): # noqa: ANN001
return jsonify({"error": e.description}), 403
@app.errorhandler(409)
def conflict(e): # noqa: ANN001
return jsonify({"error": e.description}), 409
@app.errorhandler(404)
def not_found(e): # noqa: ANN001
# Klienten snakker JSON med /api og /auth, og skal ikke få en HTML-side
@ -982,12 +1070,7 @@ def main() -> None:
venter = len(schedule.snapshot()["pending"])
player.start()
start_scheduler()
if DISPATCHER is not None:
DISPATCHER.start()
POLLER.start()
log.info("mesh: sentral for %s", ", ".join(ZONES))
elif MESH_SECRET:
log.info("mesh: sone, tar imot fra sentralen")
start_mesh(args.host, args.port)
log.info("klar på http://%s:%d (auth: %s, sink: %s, planlagt: %d)",
args.host, args.port, methods, SINK or "standard", venter)
# waitress, ikke Flask sin utviklingsserver – og ikke gunicorn med flere
@ -996,7 +1079,12 @@ def main() -> None:
# Én prosess, mange tråder.
from waitress import serve
serve(app, host=args.host, port=args.port, threads=8, ident="announcer")
# Alltid også 127.0.0.1, så helsesjekk og lokale verktøy virker selv når
# BIND_IP er NetBird-adressen.
listen = f"{args.host}:{args.port}"
if args.host not in ("0.0.0.0", "127.0.0.1", "::", "localhost"):
listen += f" 127.0.0.1:{args.port}"
serve(app, listen=listen, threads=8, ident="announcer")
if __name__ == "__main__":