strumento
Netmap
Una pagina in sola lettura per i membri di una rete ZeroTier privata gestita con ZTNET. Mostra a ogni membro se è connesso e come: una mappa di tutti i dispositivi attorno all'hub, collegamenti diretti o via relay con la loro latenza, disponibilità nelle ultime 24 ore, cosa è cambiato e quando, e i servizi raggiungibili all'interno della rete.
- Stelle GitHub
- 0


Perché l’ho creato
ZTNET rende facile amministrare una rete ZeroTier, ma non offre agli altri membri alcuna visione della rete. Netmap è una pagina che ogni membro può aprire da qualsiasi dispositivo all’interno della rete: indica in linguaggio semplice se il dispositivo è connesso e come, direttamente o tramite relay, con latenza, indirizzi IP e versioni del client disponibili su richiesta. Non richiede alcun account e non può modificare la rete.
La versione 0.1.0 è riscritta da zero: una nuova mappa, una nuova impaginazione e un nuovo server.
La mappa
L’hub sta al centro, i dispositivi di chi guarda sono evidenziati e ogni persona con due o più dispositivi ha la sua isola. Ogni collegamento è disegnato come diretto, via relay oppure a senso unico; selezionando un dispositivo se ne vedono la posizione, la qualità del collegamento e la disponibilità nelle ultime 24 ore.
Dispositivi e storico
- Statistiche di latenza: mediana, 95° percentile e jitter, e ogni dispositivo confrontato con sé stesso la settimana prima.
- Configurato, ricevuto, applicato: DNS, rotte e indirizzi seguiti dal controller fino all’hub, così vedi dove si interrompe la catena.
- Cosa è cambiato: disconnessioni, cambi di percorso e picchi di latenza. Tre dispositivi che cadono nello stesso controllo sono un solo incidente, di solito la connessione dell’hub, non tre.
- Disponibilità nelle 24 ore in intervalli da 24 minuti, e un istogramma della latenza a 30 giorni per ogni dispositivo. Finché lo storico non si riempie, gli slot vuoti restano vuoti: la pagina non mostra mai dati che non ha.
- Elenco dei servizi: cosa puoi raggiungere all’interno della rete, come collegarti e se risponde in questo momento.
Come funziona
Un piccolo server Node.js interroga l’API REST di ZTNET per i membri e la configurazione della rete, e il servizio
ZeroTier locale per latenza, tipi di percorso, versioni del client e cosa è arrivato all’hub. Ogni controllo viene
confrontato con il precedente per generare gli eventi, e una nuova istantanea viene inviata a ogni pagina aperta
tramite Server-Sent Events. Il server è un unico bundle senza node_modules, e il front end SvelteKit è statico,
con font e librerie inclusi, così funziona anche senza accesso a internet. Parla inglese e italiano, da computer
o da telefono.
Gira come container che condivide la rete del container ZeroTier: è raggiungibile solo dall’interno della rete ZeroTier e non pubblica nessuna porta sull’host. Lo storico sopravvive ai riavvii in un file scritto in modo atomico.

Privacy
Chiunque nella rete può aprire la pagina, quindi il token di ZTNET resta sul server, gli indirizzi IP pubblici dei dispositivi sono usati solo lato server per distinguere la rete locale da internet e non vengono mai inviati al browser, e la pagina è in sola lettura: l’autorizzazione dei membri resta in ZTNET.

Progetto successivo
MineSync
Sincronizzazione versionata di server Minecraft per gruppi che li ospitano sui propri PC.