← Torna alla panoramica

Architettura

Confini chiari. Dall’intento alla connessione.

Come il piano di controllo, i confini delle organizzazioni e gli agenti dei nodi collaborano per gestire gli accessi senza trasportare il traffico degli utenti.

Un piano di controllo. Responsabilità esplicite.

L’amministrazione degli accessi e la gestione del traffico hanno compiti diversi. Il piano di controllo gestisce organizzazioni, membri, servizi di accesso e cicli di vita degli accessi. I nodi eseguono quell’intento su un’infrastruttura controllata dall’operatore. Il traffico passa attraverso i nodi, mai attraverso il processo del piano di controllo.

Le organizzazioni delimitano i dati

I dati di ogni organizzazione sono memorizzati in un database separato. L’autenticazione e la risoluzione attendibile dell’organizzazione selezionano l’organizzazione prima dell’esecuzione della sua logica applicativa. Identità globali, sessioni e instradamento verso le organizzazioni risiedono nel database del piano di controllo.

Ogni nodo appartiene a una sola organizzazione. Questa possiede i propri servizi, gli accessi assegnati ai membri, i record delle connessioni e i dati operativi. Si tratta di una separazione applicativa e dei database, non di una garanzia di host fisici distinti o di protezione dalla compromissione dell’host del piano di controllo.

Ogni accesso ha un proprietario e un ciclo di vita

Un membro può possedere più accessi (entità Access). Ogni accesso configurato ha una connessione corrente (entità Connection), fornita da un servizio di accesso su un nodo. La sospensione è reversibile. La revoca è definitiva e conserva lo storico.

I membri recuperano esplicitamente la propria configurazione di connessione. Gli amministratori gestiscono il ciclo di vita e vedono i risultati del rilascio iniziale, ma i normali flussi di amministrazione non consentono loro di recuperare i segreti esistenti di un altro membro.

I nodi recuperano l’intento e comunicano l’esito

L’agente del nodo avvia le comunicazioni di gestione. Interroga il piano di controllo, verifica la firma Ed25519 dello stato desiderato, riconcilia la configurazione locale e comunica la revisione applicata e lo stato di salute. Non serve alcuna porta di gestione in ingresso. Il piano di controllo non richiede credenziali SSH o root per l’host del nodo.

L’adattatore di runtime attuale applica un’istantanea combinata della configurazione. Validazione locale, sostituzione atomica, ricaricamento e controlli di salute proteggono il processo. In caso di errore viene tentato il ripristino della configurazione precedente, quando possibile. Il risultato del ripristino va comunque verificato.

Una revisione salvata non prova che sia stata applicata. Una revisione applicata non è un test di connettività esterna. Distinguere queste osservazioni aiuta gli amministratori a diagnosticare le modifiche senza sopravvalutarne l’esito.

L’integrazione dei motori appartiene al nodo

WireGuard e Shadowsocks sono attualmente implementati tramite sing-box. Il piano di controllo descrive l’intento relativo al protocollo, mentre l’agente gestisce l’integrazione con il motore di rete. WireGuard nativo, shadowsocks-rust, l’individuazione generale dei motori e i trasporti avanzati restano sviluppi futuri.

La disponibilità comporta un compromesso

I nodi conservano l’ultima configurazione valida durante le interruzioni del piano di controllo. Questo permette alla configurazione locale esistente di continuare a funzionare, ma un nodo offline può anche conservare un’autorizzazione precedente. La revoca immediata sui nodi disconnessi e l’applicazione locale delle scadenze offline non sono implementate. Verifica lo stato di applicazione sui nodi dopo una modifica agli accessi.

Segnali operativi, non contenuti dei pacchetti

Il piano di controllo può memorizzare dati di identità, accesso, audit, salute, versione e contatori aggregati di byte necessari per amministrare il servizio. Il normale funzionamento non richiede contenuti dei pacchetti, cronologia di navigazione, query DNS o cronologia delle destinazioni. Questa descrizione del modello di dati attuale non costituisce una certificazione né una garanzia generale di anonimato.

Scegli dove eseguire il piano di controllo

La stessa architettura supporta un piano di controllo ospitato con nodi remoti, un piano di controllo gestito dal cliente con nodi remoti oppure un singolo VPS gestito dal cliente con un nodo sullo stesso host. La disponibilità di un servizio ospitato e l’assistenza commerciale richiedono un’offerta separata. Il percorso guidato su un singolo VPS è attualmente in alpha.

Approfondisci

Consulta la documentazione aggiornata su compatibilità e sicurezza prima del deployment.

Accesso alla documentazione

Inizia dall’architettura. Poi prova l’alpha.

Guarda più da vicino.

Leggi i requisiti di deployment, comprendi i limiti attuali e scegli il passo successivo adatto alla tua infrastruttura.