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:
parent
c4a15799dd
commit
7c521f8d1f
21 changed files with 1106 additions and 137 deletions
85
docs/mesh.md
85
docs/mesh.md
|
|
@ -24,38 +24,78 @@ Soner som får samme melding starter innen ~1 s av hverandre. Fint for
|
|||
adskilte rom. Lekker rommene inn i hverandre hører man det; synkron start
|
||||
mot NTP er en påbygging som ikke finnes ennå.
|
||||
|
||||
## Sonene melder seg selv
|
||||
|
||||
Du trenger ikke skrive inn sonene på sentralen. En sone sender et hjerteslag
|
||||
til sentralen hvert 30. sekund (`POST /api/mesh/register` med navn, egen
|
||||
adresse og mesh-nøkkelen). Riktig nøkkel er godkjenningen: sonen dukker opp i
|
||||
lista med en gang og kan krysses av. Slutter den å slå – strøm, nett, flyttet
|
||||
– tas den ut etter 90 sekunder. Starter den igjen, er den tilbake innen fem.
|
||||
|
||||
Det eneste en sone må vite er hvor sentralen er, og det løses lagvis:
|
||||
|
||||
| Nett | Hvordan sonen finner sentralen |
|
||||
|---|---|
|
||||
| Samme LAN/VLAN | **mDNS.** Sentralen annonserer `_announcer._tcp`, sonen finner den selv. Null config |
|
||||
| NetBird | `ANNOUNCER_SENTRAL=http://<sentralens navn>.skynet.corp:8090` – multicast går ikke gjennom tunnelen, men NetBird-DNS gjør navnet stabilt |
|
||||
| Begge satt | `ANNOUNCER_SENTRAL` vinner; mDNS brukes bare når den er tom |
|
||||
|
||||
Faste adresser i `[zones]` virker fortsatt, og vinner over et navn som
|
||||
melder seg – en skrivefeil i config skal ikke kunne overstyres av en boks
|
||||
på nettet.
|
||||
|
||||
## Sette opp
|
||||
|
||||
### Sentralen
|
||||
|
||||
```toml
|
||||
# data/config.toml
|
||||
[zones]
|
||||
her = "local" # eget anlegg. Utelat hvis sentralen ikke har høyttalere
|
||||
hovedscene = "http://10.20.70.11:8090"
|
||||
resepsjon = "http://10.20.70.12:8090"
|
||||
crew = "http://10.20.70.13:8090"
|
||||
```
|
||||
|
||||
```bash
|
||||
# .env
|
||||
ANNOUNCER_MESH_SECRET=<openssl rand -hex 24>
|
||||
ANNOUNCER_ROLE=sentral
|
||||
ANNOUNCER_NAME=her # navnet på sentralens eget anlegg i lista
|
||||
```
|
||||
|
||||
`docker compose restart`. Loggen sier `mesh: sentral for her, hovedscene, …`.
|
||||
`docker compose restart`. Loggen sier `mesh: sentral «her», soner nå: her`
|
||||
og `mDNS: annonserer her som sentral`. Sonene kommer etter hvert som de
|
||||
melder seg. Har sentralen ikke eget anlegg: `ANNOUNCER_LOCAL=0`.
|
||||
|
||||
### Hver sone
|
||||
### Hver sone, på samme LAN
|
||||
|
||||
```bash
|
||||
git clone https://git.1x1.no/kent/announcer.git && cd announcer
|
||||
ANNOUNCER_MESH_SECRET=<samme nøkkel> ./install.sh
|
||||
ANNOUNCER_MESH_SECRET=<samme nøkkel> ANNOUNCER_NAME=hovedscene ./install.sh
|
||||
```
|
||||
|
||||
Loggen sier `mesh: sone, tar imot fra sentralen`. Ingen `[zones]` på sonen.
|
||||
Det er alt. Loggen sier `mDNS: fant sentral her på http://…` og
|
||||
`meldt hos sentralen … som hovedscene`.
|
||||
|
||||
Sonen må nås fra sentralen på adressen i `[zones]`. Med NetBird setter
|
||||
`install.sh` `BIND_IP` til sonens NetBird-adresse – bruk den i `[zones]`.
|
||||
Uten NetBird: sett `BIND_IP=0.0.0.0` (eller LAN-adressen) i sonens `.env`.
|
||||
### Hver sone, over NetBird
|
||||
|
||||
Lag én setup-nøkkel i NetBird (Setup Keys → reusable, auto-gruppe
|
||||
`announcer`), og én policy `announcer → announcer, TCP 8090`, så sentral og
|
||||
soner når hverandre. Så, på hver boks:
|
||||
|
||||
```bash
|
||||
NETBIRD_SETUP_KEY=<nøkkel> \
|
||||
ANNOUNCER_MESH_SECRET=<samme nøkkel> \
|
||||
ANNOUNCER_NAME=resepsjon \
|
||||
ANNOUNCER_SENTRAL=http://announcer-her.skynet.corp:8090 \
|
||||
./install.sh
|
||||
```
|
||||
|
||||
`install.sh` installerer NetBird om den mangler, melder maskina inn som
|
||||
`announcer-resepsjon`, venter på `wt0`, og binder appen til
|
||||
NetBird-adressen. Sentralen heter `announcer-<navn>` i NetBird av samme
|
||||
regel, så `ANNOUNCER_SENTRAL` kan stå fast fra arrangement til arrangement.
|
||||
Selvhostet management-server leses fra `/etc/netbird/config.json` hvis den
|
||||
finnes fra før; ellers `NETBIRD_MANAGEMENT_URL=…`.
|
||||
|
||||
### Vertens nett
|
||||
|
||||
Containeren bruker `network_mode: host`. Det er det som gjør at mDNS når
|
||||
LAN-et, at `wt0` er synlig, og at **ufw styrer porten igjen** – det gamle
|
||||
Docker-smutthullet er borte. `BIND_IP` i `.env` avgrenser i tillegg hvilke
|
||||
adresser appen svarer på; `127.0.0.1` er alltid med, så helsesjekken virker.
|
||||
|
||||
### Raspberry Pi uten skjerm
|
||||
|
||||
|
|
@ -89,6 +129,10 @@ Planlagte sendinger husker sonene sine og overlever omstart av sentralen.
|
|||
| | Hva du ser | Hva det betyr |
|
||||
|---|---|---|
|
||||
| Sone nede ved sending | `✗ nede` på den sonen, `✓` på resten | nådde ikke fram innen 5 s. Resten gikk |
|
||||
| Sonen står ikke i lista | sonens egen side sier «ingen sentral funnet» | mDNS når ikke fram (annet VLAN, eller `ANNOUNCER_MDNS=0`), og `ANNOUNCER_SENTRAL` er tom. Sett den |
|
||||
| Sonen sier «401 Feil mesh-nøkkel» | i sonens logg, hvert 5. s | nøkkelen er ulik. Sentralen avviser, og sonen kommer aldri i lista |
|
||||
| Sonen forsvant fra lista | `sone x har ikke meldt seg på 90 s – tatt ut` i sentralens logg | strøm, nett, eller sonen fikk ny IP og melder seg på nytt derfra om et øyeblikk |
|
||||
| Sentralen ser sonen, men `✗ nede` | adressen sonen meldte er ikke nåbar fra sentralen | sonen regnet ut feil egen adresse (to nett). Sett `ANNOUNCER_URL` på sonen |
|
||||
| `✗ avvist` | `401 Feil mesh-nøkkel` i merket | `ANNOUNCER_MESH_SECRET` er ulik på sentral og sone |
|
||||
| Rød prikk på en sone | «nede: …» i sonelista | statuspollingen når den ikke. Sjekk adresse i `[zones]` og `BIND_IP` på sonen |
|
||||
| Alle soner `✗ feilet` | feilmelding på fordelingen | syntesen feilet på sentralen (nettet nede og nevral stemme valgt). Velg en lokal stemme |
|
||||
|
|
@ -101,6 +145,15 @@ sones logg som `play`.
|
|||
|
||||
## Protokoll, for den som vil skrive sin egen sone
|
||||
|
||||
Melde seg: `POST /api/mesh/register`, header `X-Mesh-Key`, JSON
|
||||
`{"name": "resepsjon", "url": "http://100.75.12.3:8090", "version": "0.3"}`
|
||||
hvert 30. sekund. Svar `200 {"ok": true, "stale_seconds": 90}`. `409` hvis
|
||||
navnet er opptatt av config på sentralen. Sentralen kaller så `url` tilbake
|
||||
for lyd og status – den må altså være nåbar *fra sentralen*.
|
||||
|
||||
mDNS: tjenestetypen er `_announcer._tcp.local.`, TXT `role=sentral`,
|
||||
`name=<navn>`, `version=<v>`. Soner trenger ikke annonsere; de melder seg.
|
||||
|
||||
`POST /api/play`, header `X-Mesh-Key: <hemmelighet>`, multipart:
|
||||
|
||||
| felt | |
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue