Configurazione base

Under review — wording may still change.

Sette passi da un daemon appena installato a una rete filtrata come vuoi tu.

Warden è un binario singolo configurato da un unico file TOML in chiaro. Puoi modificarlo a mano, ma raramente serve: ogni passo qui sotto ha un comando e una schermata nell’interfaccia da terminale, ed entrambi scrivono lo stesso file.

La prima volta segui i passi in ordine. Ognuno ti lascia qualcosa che funziona, quindi puoi fermarti dopo uno qualsiasi e riprendere più tardi.

Il percorso di base

#	Passo	Cosa ottieni
1	Inizializza	Un utente di sistema, le directory e un primo `config.toml` con tre liste già sottoscritte
2	Importa le liste	Altri feed di domini, dal catalogo purge.cc o da qualunque URL di cui ti fidi
3	Crea i profili	Le policy vere e proprie — quali liste si applicano, e come
4	Crea le etichette	Un piccolo vocabolario che mantiene coerente il tuo inventario di dispositivi
5	Gestisci i dispositivi	Ogni macchina con un nome, e indirizzata al profilo che merita
6	Regole personalizzate	Le tue regole di allow e deny, un dominio alla volta o un file alla volta
7	Mappa le subnet	Un intero segmento di rete su un solo profilo, senza dare un nome a ogni dispositivo

Dei sette passi, per ora solo Inizializza è tradotto. Le altre sei guide sono aggiornate e puoi già seguirle: Import lists (in inglese), Create profiles (in inglese), Create labels (in inglese), Manage devices (in inglese), Custom rules (in inglese), Map subnets (in inglese). Le traduzioni arrivano quando la versione inglese è certificata.

I passi 3, 5 e 7 sono guide passo-passo. Quando vuoi ogni campo, ogni default e l’intera catena di precedenza, le pagine sulle entità sono il riferimento che sta dietro a quelle guide.

Dove Warden legge la configurazione

Senza --config, Warden scorre un elenco fisso e prende il primo file che riesce davvero ad aprire:

./config.toml — la directory di lavoro. Comodo in sviluppo.
$XDG_CONFIG_HOME/purge-warden/config.toml, oppure $HOME/.config/purge-warden/config.toml.
/etc/purge-warden/config.toml — il percorso di sistema standard.
/var/lib/purge-warden/config.toml — installazioni più vecchie, mantenute funzionanti.

Eseguire come root cambia la ricerca

Quando l’utente effettivo è root, Warden cerca solo nei due percorsi di sistema e ignora sia la directory di lavoro sia la tua home. Un ./config.toml che si trova nella directory da cui ti è capitato di lanciare sudo viene saltato con un avviso, ed è voluto: è scrivibile da un utente non root, e caricarlo permetterebbe a chiunque possa lasciare un file lì di far puntare altrove il tuo resolver upstream. Un --config esplicito vince sempre.

Chiedi al daemon in esecuzione quale file ha caricato davvero:

bash

warden status

Prima di ricaricare

Valida il file, poi ricarica. Una configurazione che non passa la validazione viene rifiutata e la precedente continua a servire traffico.

bash

warden config lint
warden reload

Le modifiche che fai da comando — warden device add, warden profile set, warden lists add — ricaricano il daemon al posto tuo. Non c’è altro da eseguire.

Oltre il percorso di base

Pianificazioni, SafeSearch, record DNS locali, resolver upstream e le impostazioni anti-bypass sono in fase di riscrittura sullo schema attuale e nel frattempo restano fuori dalla barra laterale. Finché non tornano, warden config show stampa la configurazione che il daemon ha caricato davvero, e warden config edit la apre nel tuo editor e valida ciò che salvi.

Vedi anche

Gerarchie delle entità — come si incastrano dispositivi, gruppi, subnet e profili
Processo di filtraggio — cosa succede a una query, in ordine
Riferimento CLI — tutti i comandi

Inizializzazione

→