Costruire un NAS per l'homelab con OpenZFS, Samba, Jenkins e GitLab — completamente automatizzato con Ansible

Illustrazione di un NAS per l'homelab con OpenZFS, Samba, Jenkins e GitLab

🌐 Anche in: English · Deutsch · Français · Español · Português · Nederlands · Polski

📦 Quello che doveva essere un veloce “dai, questo weekend mi monto un NAS” si è trasformato in una settimana di tane del bianconiglio, yak shaving e un numero irragionevole di commit git. Ma ehi — l’homelab ne è uscito migliore, e ora tutto è automatizzato e documentato. Come al solito, l’intero codice Ansible vive qui:

👉 github.com/aptupgrademe/www_k3s

Prima di arrivare al NAS e a OpenZFS — che sono il vero piatto forte — lasciami scaricare velocemente le missioni secondarie capitate lungo la strada. Salta alla sezione su ZFS se sei impaziente. Non ti giudico.


Indice

🐿️ Missioni secondarie: tutto ciò che non era il NAS

Sai com’è. Cominci a configurare un NAS e tre giorni dopo stai sistemando le regole di alert di Grafana e scrivendo una guida operativa in francese. Ecco cosa è successo:

🔒 Correzioni di sicurezza (l’edizione “aspetta, era aperto?!”)

  • rpcbind era in ascolto sulla porta 111 — pubblicamente. NFS non si usa da nessuna parte. Sistemato. 😬
  • rkhunter mandava ogni mattina mail “infected!” — perché SourceForge era passato ai redirect HTTPS e curl non li seguiva. Aggiunto curl -L. Ho anche automatizzato rkhunter --propupd dopo dnf-automatic, così gli aggiornamenti di sicurezza notturni non sembrano rootkit.
  • Le regole di alert di Grafana avevano le soglie infilate nel PromQL, il che causava errori “condition must not be empty” quando le metriche erano sotto soglia. Ho spostato le soglie nell’evaluator. Ora funziona davvero.
  • Drop-in di hardening systemd distribuiti: sshd è passato da un exposure score di 9.6 → 7.8, node_exporter e prometheus da 9.2 → 4.4 ciascuno.
  • Servizi superflui eliminati: rpcbind, gssproxy, sssd — nessuno necessario, tutti in esecuzione.

⚡ Prestazioni

  • Autoptimize installato su WordPress: i tag JS/CSS sono scesi da 40 a 6. Dimensione della pagina giù di ~18%.
  • robots.txt restituiva 404. Yoast SEO lo genera dinamicamente via PHP, ma nginx lo trattava come file statico. Una direttiva try_files dopo — sistemato.
  • tcp_max_syn_backlog alzato da 512 a 4096 per allinearlo a somaxconn.
  • Transparent Huge Pages passate da always a madvise — il default causa picchi di latenza nei pod K3s, in MariaDB e in Redis.

🎨 Design & SEO

  • L’header del blog ha avuto un restyling: il logo dell’admin volante ora sta a destra (specchiato, così guarda verso l’interno invece di volare fuori dalla pagina), il titolo del sito a sinistra, sfondo scuro in tinta con le barre di navigazione. Piccole cose, grande differenza.
  • 165 immagini non avevano testo alternativo. Sistemato con uno script WP-CLI che ricava automaticamente le descrizioni dai nomi dei file. Questo ha richiesto più tempo del setup del NAS.
  • robots.txt ora espone correttamente ai motori di ricerca la sitemap generata da Yoast.
  • Aggiunto “Home” come prima voce del menu di navigazione. A quanto pare non era ovvio come tornare alla pagina iniziale. Ops.

📚 Documentazione

Perché a quanto pare scrivere documentazione mi piace più di quanto sia sano: le guide operative ora sono disponibili in tedesco, inglese e francese per WordPress, Nextcloud e il nuovo NAS. Sì, francese. La cartella docs/ del repo contiene tutti e sei i file HTML.


🗄️ Il piatto forte: un NAS OpenZFS su Debian 13

Bene. La cosa che volevo davvero fare.

Perché ZFS? Un po’ di storia

ZFS è stato sviluppato originariamente da Sun Microsystems ed è uscito per la prima volta con Solaris 10 nel 2005. Il nome stava per “Zettabyte File System” — Sun non peccava di modestia. È stato progettato da zero per risolvere problemi che i filesystem UNIX tradizionali avevano tappato alla meglio per decenni: corruzione silenziosa, stato incoerente dopo i crash, l’orrore generale di fsck su volumi grandi.

Quando Oracle ha acquisito Sun nel 2010, lo sviluppo di ZFS sul lato open source si è separato in OpenZFS — oggi il progetto comunitario mantenuto attivamente che gira su Linux, FreeBSD, macOS e altri. È quello che usiamo.

Una cosa che ho dato per scontata a lungo: ZFS è roba da FreeBSD. A quanto pare non è proprio così. OpenZFS è nei repository di Debian 13 e si installa senza problemi. Lo uso per la prima volta, quindi non ho ancora numeri dal mondo reale. La mia ipotesi è che il throughput grezzo possa essere leggermente inferiore a un setup ext4/mdadm ottimizzato — ma il compromesso fatto di checksum, rilevamento della corruzione silenziosa e snapshot rende i dati decisamente più sicuri. Vedremo come regge. 🧪

✅ Cosa rende grande ZFS

  • Checksum end-to-end — ogni blocco riceve un checksum in scrittura, verificato in lettura. La corruzione silenziosa (“bit rot”) viene rilevata e, in un pool ridondante, riparata automaticamente.
  • Copy-on-Write (CoW) — i dati non vengono mai sovrascritti sul posto. Questo rende gli snapshot praticamente gratuiti ed elimina il problema del write hole del RAID-5.
  • Snapshot — copie di un dataset in un dato istante, create all’istante e memorizzate in modo efficiente. Rollback in pochi secondi.
  • RAID integrato (RAIDZ) — nessun controller RAID separato, nessuna corruzione silenziosa dei metadati. RAIDZ1/2/3 sono nativi di ZFS.
  • Compressione — trasparente, per dataset. zstd dà un risparmio di spazio del 30–50% su documenti e backup con un costo di CPU trascurabile.
  • Cache ARC — ZFS gestisce la propria cache di lettura adattiva in RAM. Più RAM = letture più veloci.
  • Storage in pool — tutti i dataset condividono dinamicamente lo spazio del pool. Basta ritagliare partizioni fisse.

⚠️ I compromessi

  • Affamato di RAM — l’ARC è ingordo. Un vero NAS vuole 16–32 GB.
  • Ridimensionare un RAIDZ non è facile — non puoi semplicemente aggiungere un disco a un vdev RAIDZ esistente. ZFS 2.2+ ha aggiunto l’espansione, ma non è comunque istantanea.
  • RAM ECC fortemente consigliata — ZFS si fida della RAM. Se la RAM corrompe silenziosamente un bit prima della scrittura, ZFS calcola il checksum della corruzione come se fosse valida. L’ECC lo impedisce.
  • Curva di apprendimento — pool, vdev, dataset, proprietà. Un modello mentale diverso da quello dei filesystem tradizionali. Ne vale la pena, ma ci va un weekend.

🏗️ Il setup vero e proprio

Prima, gli stessi tre SSD facevano girare un classico RAID5 software di Linux (md) con ext4 sopra. Funzionava, ma non offriva nessuna delle garanzie di integrità, degli snapshot o della compressione di ZFS. Era ora di fare l’upgrade.

L’hardware è un HP MicroServer Gen10 Plus V2 — Intel Xeon E-2314, 31 GB di RAM. Disposizione dello storage:

  • sdb (SSD da 465 GB) → Debian 13, sistema operativo
  • sda + sdc + sdd (3× SSD WD Red SA500 da 1,8 TB) → ZFS RAIDZ1
  • sde (HDD Toshiba da 1,8 TB) → /mnt/usb backup esterno

Il ruolo Ansible crea il pool così:

zpool create -f
  -o ashift=12          # 4K sector alignment for modern SSDs
  -o autotrim=on        # TRIM commands for SSD health
  -O compression=zstd   # transparent compression
  -O atime=off          # no access-time writes on reads
  -O xattr=sa           # Samba xattrs in inodes (faster)
  -O recordsize=128k    # overridden to 1M per dataset
  -O mountpoint=/raid5
  data raidz /dev/disk/by-id/ata-WD_Red_SA500_...

📁 Samba — un’unica fonte di verità

La scelta di design chiave: le definizioni delle share Samba in vars.yml guidano tutto. Il ruolo Ansible ci gira sopra in un ciclo per creare i dataset ZFS, impostare i proprietari e scrivere smb.conf. Aggiungi una share in un solo posto — il resto segue automaticamente:

nas_samba_shares:
  - name: shared
    path: "{{ nas_zfs_mountpoint }}/shared"
    valid_users: user3
      force_user:  user3
  - name: user1
    path: "{{ nas_zfs_mountpoint }}/user1"
    valid_users: user3
      force_user:  user3

Samba gira con SMB3 con supporto multi-channel e I/O asincrono. La proprietà ZFS xattr=sa memorizza gli attributi estesi di Windows direttamente nell’inode invece che in file nascosti con il punto, il che rende i metadati sensibilmente più veloci. 🎛️


🤖 Jenkins, GitLab & Pi-hole

Il MicroServer fa un po’ di più che servire file:

Jenkins (porta 8090) esegue due job di backup notturni — backup basati su rsync di due istanze Nextcloud remote (instance-a e instance-b). La chiave SSH usata per queste connessioni è conservata cifrata in Ansible Vault e ripristinata in /home/user3/.ssh/ a ogni installazione da zero. Una reinstallazione completa del sistema operativo non rompe la connettività dei backup.

GitLab CE 19.1 (porta 80) fa da server Git locale. Avere un GitLab in casa per i progetti dell’homelab significa nessuna dipendenza da servizi esterni. Il ruolo Ansible gestisce l’intera configurazione post-installazione tramite l’API di GitLab: imposta la password di root, crea un utente standard, crea un gruppo homelab e un progetto www_k3s vuoto — tutto in modo idempotente.

Pi-hole v6 (porta 8000 per l’interfaccia web, porta 53 per il DNS) blocca la pubblicità a livello di rete. Sta sulla porta 8000 invece della 80 di default perché lì abita già GitLab. Il DNS upstream è 8.8.8.8/8.8.4.4.

E visto che è un server HP: HPE AMSD (Agentless Management Service) viene installato per primo — prima di tutto il resto. Senza, la BMC iLO non riceve i dati di temperatura dal sistema operativo e le ventole girano al massimo. Rumorose. Molto rumorose.


Tutto questo — NAS e server su Internet allo stesso modo — è a un solo comando ansible-playbook da una ricostruzione da zero:

👉 github.com/aptupgrademe/www_k3s

Prossimo passo: reinstallare davvero hp1 ed eseguire il playbook per la prima volta su una Debian 13 pulita. Vi farò sapere se ZFS su Linux è all’altezza dell’hype. 🤞

Alcuni testi e immagini di questo sito sono creati con l’aiuto dell’IA o generati dall’IA. Dettagli