Documentazione del homelab savethemall.eu

Traduzione automatica dell'originale francese.

Questa documentazione descrive il parco come funziona: sei host Docker, circa trecento container (dati del 2026-10-06), un reverse proxy a due livelli e un servizio di autenticazione che gestisce gli accessi.

Cosa è questa documentazione, e cosa non lo è

È la versione rivista e pubblicabile della conoscenza del parco: ciò che è necessario sapere per agire senza causare problemi.

Non è la memoria di lavoro. I rapporti sugli incidenti, i log delle decisioni per stack e le FAQ risiedono nel vault Obsidian, e sono consultabili sul wiki. Una pagina pubblicata qui è una pagina che è stata giudicata stabile; una nota nel vault è uno stato della conoscenza in un determinato momento.

La condivisione precisa dei ruoli, e il test che risolve in una frase: Dove scrivere cosa.

Da dove iniziare

• Infrastruttura

  Gli host, i loro indirizzi, cosa gira su di essi, e dove risiedono i dati.

• Stack

  Le convenzioni Compose del parco e il ciclo di vita di uno stack, dalla creazione alla dismissione.

• Rete

  Il percorso di una richiesta da Internet, la risoluzione DNS e il suo orizzonte di validità.

• Procedure

  Le istruzioni passo passo: pubblicare un servizio, patchare un host, leggere una chiave.

I cinque principi che evitano gli errori

1. L'edge WAN è il NAS, non vm-docker. Un filtro L3 applicato a vm-docker non blocca nulla: la sorgente che vede è sempre nas. Vedi Reverse proxy.
2. curl https://<fqdn> dal LAN non testa il WAN. Il DNS è in horizon doppio. Vedi DNS e risoluzione.
3. Nel vault, 10-stacks/<nom>/compose.yml è un collegamento simbolico inattivo. Il file reale risiede sull'host. Vedi Convenzioni.
4. Su vm-docker e vm-compute-01, restart: on-failure:5 e non always. docker-staggered.service è l'unica autorità di avvio all'avvio.
5. Due vault: OpenBao per i segreti delle macchine, Vaultwarden per i segreti umani. Vaultwarden è già sbloccato: non mai eseguire bw unlock. Vedi Leggere un segreto dal vault.

Modificare questa documentazione

Il contenuto è scritto a mano in docs/ del repository homelab-docs. La procedura da seguire è nel README.md del repository, e la meccanica è in Integrazione continua.

Questo sito non ha una frequenza di aggiornamento

Si ricostruisce solo in seguito a un push su main: evento, mai periodico. Nessun cron, nessun ricostruzione programmata.

Questo è diverso dal wiki (Wiki.js), che viene sincronizzato ogni notte perché deriva dal vault — il vault si muove da solo, quindi il wiki deve ripartire. Qui nulla può cambiare senza commit, e una ricostruzione oraria ricostruirebbe esattamente come prima.

Conseguenza: modificare una nota nel vault non aggiorna questa documentazione. I due non sono collegati — vedere la condivisione dei ruoli di seguito.

Dernière vérification de cette page : 2026-10-06