Tutos 10 min de lecture

Configurer un cache ZFS sur son NAS pour booster les performances en 2026

Optimisez votre NAS TrueNAS ou Proxmox avec un cache ZFS (ARC, L2ARC, ZIL) pour des lectures et écritures plus rapides tout en conservant la fiabilité des disques mécaniques

S Par Selfhostr · sans contenu sponsorisé
Configurer un cache ZFS sur son NAS pour booster les performances en 2026
Cet article peut contenir des liens affiliés (sans surcoût pour toi, ça finance le site). En tant que Partenaire Amazon, Selfhostr réalise un bénéfice sur les achats remplissant les conditions requises. Voir la disclosure.

👍 On aime

  • Amélioration significative des performances de lecture grâce au L2ARC
  • Réduction de la charge sur les disques mécaniques en utilisant des caches multi-niveaux
  • Flexibilité de configuration adaptée à différents workloads (lecture/écriture)
  • Compatibilité avec TrueNAS et Proxmox pour une intégration facile

👎 On regrette

  • Les SSD pour le cache doivent être de qualité pour éviter la saturation rapide
  • Configuration avancée nécessite des connaissances en ligne de commande et en administration système
  • Surveillance régulière indispensable pour maintenir les performances
  • Risque de perte de données en cas de panne si le ZIL n'est pas backed par supercondensateurs
📑 Sommaire ▾

ZFS est un système de fichiers open source qui excelle dans la gestion des caches multi-niveaux. Le premier niveau, l’ARC (Adaptive Replacement Cache), utilise la mémoire vive du système pour accélérer les lectures et écritures les plus fréquentes. Lorsque l’ARC est saturé, ZFS peut utiliser un cache de deuxième niveau, le L2ARC, qui stocke les données sur un disque SSD dédié. Ce cache est particulièrement efficace pour les lectures aléatoires fréquentes, car il évite de solliciter les disques mécaniques lents. Enfin, le ZIL (ZFS Intent Log) permet d’accélérer les écritures synchrones en les commettant temporairement sur un support non volatile. Ce guide explique comment configurer ces caches pour maximiser les performances de votre NAS sous TrueNAS ou Proxmox. Vous apprendrez à optimiser l’ARC, à ajouter un L2ARC pour les lectures aléatoires, et à configurer un ZIL pour les écritures synchrones. Ces optimisations permettent d’obtenir des performances proches de celles d’un SSD tout en utilisant des disques mécaniques pour le stockage principal, ce qui réduit les coûts et améliore la fiabilité. La configuration est adaptable à la taille de votre jeu de données actif, généralement entre 10% et 20% de la capacité totale du pool ZFS.

Prérequis

Pour configurer un cache ZFS sur votre NAS, vous aurez besoin de :

  • Un système TrueNAS ou Proxmox déjà installé avec ZFS
  • Un disque SSD compatible (format M.2 ou 2,5 pouces) pour le cache L2ARC
  • Un disque SSD compatible pour le ZIL (idéalement SLC ou backed par supercondensateurs)
  • La dernière version stable de TrueNAS ou Proxmox
  • Accès root au système pour les commandes en terminal
  • Un jeu de données ZFS déjà créé
  • Connaître la taille approximative de votre jeu de données actif (working set size)

Installation pas à pas

Étape 1 : Estimer la taille du jeu de données actif

Le cache ZFS est efficace uniquement si sa taille correspond à votre working set (jeu de données actif). Une taille trop petite ne servira à rien, tandis qu’une taille excessive gaspillera de la mémoire SSD.

Pour estimer votre working set, utilisez :

zpool iostat -v

Cette commande affiche l’utilisation de chaque vdev. Notez les valeurs de lecture et écriture sur les disques mécaniques. En pratique, un working set représente environ 20% de la capacité totale du pool ZFS. Pour une estimation plus précise, analysez les statistiques d’utilisation des fichiers :

zfs list -t all -o name,used,referenced

Vérifiez que la colonne referenced correspond à la taille active de vos datasets. Si vous utilisez TrueNAS, consultez les rapports d’utilisation dans l’interface web sous System > Analytics > Reporting.

Vérification : Si vous voyez que la majorité de vos données sont concentrées sur quelques datasets, cela confirme que votre working set est bien inférieur à la taille totale du pool. Passez à l’étape suivante.

Étape 2 : Préparer le disque SSD pour le L2ARC

Le L2ARC est un cache de lecture qui stocke les données les plus récemment et fréquemment utilisées. Il ne nécessite pas un SSD haut de gamme, mais doit être suffisamment rapide pour accélérer les accès aux données déjà présentes sur vos HDD.

Si votre SSD est au format M.2, assurez-vous qu’il est inséré dans un slot compatible PCIe 4.0. Pour un SSD au format 2,5 pouces, vérifiez qu’il est connecté sur un port SATA libre.

Identifiez le SSD destiné au L2ARC. Il ne faut ni le formater ni le monter : ZFS l’utilise directement, et toutes ses données seront effacées.

# Identifiez le périphérique SSD
lsblk
ls -l /dev/disk/by-id/

Vérification : Dans la sortie de lsblk, le SSD (par exemple /dev/sdX) doit apparaître sans point de montage et ne doit appartenir à aucun pool (zpool status).

Étape 3 : Configurer l’ARC (Adaptive Replacement Cache)

L’ARC est le cache de première ligne de ZFS, utilisant la RAM du système. Il est déjà configuré par défaut, mais vous pouvez optimiser ses paramètres pour votre matériel.

Pour TrueNAS, modifiez les paramètres dans System > Tunables :

# Valeur en octets (TrueNAS SCALE : à appliquer via un script d'initialisation)
echo 13421772800 > /sys/module/zfs/parameters/zfs_arc_max

Pour Proxmox, éditez le fichier /etc/modprobe.d/zfs.conf :

# Ajoutez ces lignes pour optimiser l'ARC
# Taille maximale de l'ARC, en octets
options zfs zfs_arc_max=13421772800

# Régénérez l'initramfs puis redémarrez pour appliquer
update-initramfs -u -k all
reboot

Vérification : Vérifiez avec cat /sys/module/zfs/parameters/zfs_arc_max et grep c_max /proc/spl/kstat/zfs/arcstats que la valeur c_max correspond à votre configuration.

Étape 4 : Configurer le L2ARC (cache de lecture SSD)

Le L2ARC est un cache de lecture qui utilise un SSD dédié. Il est particulièrement efficace pour les lectures aléatoires fréquentes.

Pour TrueNAS, ajoutez le disque SSD comme cache dans Storage > Pools > Add Cache Device. Sélectionnez le pool cible et le SSD à utiliser comme cache (L2ARC).

Pour Proxmox, utilisez la commande suivante pour ajouter le cache :

# Ajoutez le cache L2ARC à votre pool ZFS
zpool add <poolname> cache /dev/sdX

# Vérifiez la configuration du cache
zpool status <poolname>

Vérification : Exécutez zpool iostat -v 2 pour voir l’activité du L2ARC. Si les valeurs de lecture augmentent, le cache fonctionne correctement.

Étape 5 : Configurer le ZIL (cache d’écriture synchrone)

Le ZIL est utilisé pour accélérer les écritures synchrones en les commettant temporairement sur un support non volatile. Il est particulièrement important pour les performances des services NFS ou les écritures synchrones fréquentes.

Pour TrueNAS, ajoutez le disque SSD comme log dans Storage > Pools > Add Log Device. Sélectionnez le pool cible et le second SSD à utiliser comme log (SLOG).

Pour Proxmox, utilisez la commande suivante pour ajouter le ZIL :

# Ajoutez le ZIL à votre pool ZFS
zpool add <poolname> log /dev/sdY

# Vérifiez la configuration du ZIL
zpool status <poolname>

Vérification : Exécutez zpool iostat -v 2 et surveillez les valeurs de write sur le ZIL. Si elles augmentent, le cache fonctionne correctement.

Étape 6 : Optimiser les paramètres de cache

Après avoir configuré l’ARC, le L2ARC et le ZIL, vous pouvez optimiser les paramètres de cache pour maximiser les performances.

Pour TrueNAS, modifiez les paramètres dans System > Tunables :

# Valeurs en octets (TrueNAS SCALE : à appliquer via un script d'initialisation)
echo 104857600 > /sys/module/zfs/parameters/l2arc_write_max
echo 2 > /sys/module/zfs/parameters/l2arc_headroom

Pour Proxmox, éditez le fichier /etc/modprobe.d/zfs.conf :

# Ajoutez ces lignes pour optimiser le L2ARC
options zfs l2arc_write_max=104857600
options zfs l2arc_write_boost=104857600
options zfs l2arc_headroom=2

# Régénérez l'initramfs puis redémarrez pour appliquer
update-initramfs -u -k all
reboot

Vérification : Exécutez cat /sys/module/zfs/parameters/l2arc_write_max pour vérifier les paramètres de cache. Les valeurs doivent correspondre à votre configuration.

Étape 7 : Surveiller l’activité du cache

Surveillez régulièrement l’activité de votre cache pour vous assurer qu’il fonctionne comme prévu et qu’il n’est pas saturé.

Pour TrueNAS, utilisez les rapports d’utilisation sous System > Analytics > Reporting.

Pour Proxmox, utilisez la commande suivante :

# Affichez les statistiques du cache
arc_summary

Vérification : Si le taux de succès (hit ratio) affiché par arc_summary est élevé (par exemple > 80%), votre cache est efficace. Si elles sont basses, vous devrez peut-être ajuster la taille du cache ou les paramètres d’utilisation.

Vérifications

Pour vérifier que votre cache ZFS est correctement configuré et fonctionne, exécutez les commandes suivantes dans l’ordre :

# Vérifiez l'état du pool ZFS
zpool status <poolname>

# Affichez les statistiques de l'ARC
cat /proc/spl/kstat/zfs/arcstats | grep -E "c_max|c_min|hits"

# Affichez les statistiques du L2ARC
zpool iostat -v 2

Résultat attendu :

  • La commande zpool status doit afficher les disques SSD configurés comme cache et log dans la liste des vdevs.
  • Les valeurs c_max et c_min dans arcstats doivent correspondre à votre configuration.
  • Le taux de succès (hit ratio) affiché par arc_summary doit être élevé (par exemple > 80%) si votre cache est efficace.
  • Le L2ARC doit montrer une activité de lecture non nulle dans zpool iostat.

Sécurité et bonnes pratiques

La sécurité de votre cache ZFS est essentielle pour éviter les pertes de données ou les problèmes de performances. Pour le ZIL, privilégiez les SSD SLC ou les solutions backed par supercondensateurs si disponibles, car ils garantissent la persistance des écritures synchrones en cas de panne électrique. Les SSD TLC ou MLC standard ne sont pas recommandés pour le ZIL, car ils peuvent perdre des données en cas de coupure de courant. Pour le L2ARC, utilisez un SSD de qualité avec une endurance suffisante pour éviter la saturation prématurée du cache. Enfin, surveillez régulièrement l’état de santé de vos SSD via les commandes smartctl -a /dev/sdX ou zpool status. Si un disque SSD montre des signes de défaillance, remplacez-le immédiatement pour éviter des problèmes de cache.

Dépannage : erreurs courantes

Cause : Le SSD n’a pas été ajouté au pool comme vdev cache, ou le cache n’est pas encore rempli.

Correctif : Vérifiez avec zpool status <poolname> que le SSD apparaît sous cache (il ne doit être ni formaté ni monté). Le L2ARC se remplit progressivement, au fil des lectures : laissez-lui le temps de se charger.

Symptôme : L’ARC est saturé trop rapidement

Cause : La taille de votre jeu de données actif dépasse la capacité de l’ARC.

Correctif : Augmentez la taille de l’ARC en ajoutant plus de RAM ou en augmentant le paramètre zfs_arc_max dans /etc/modprobe.d/zfs.conf. Si le problème persiste, réduisez la taille de votre working set ou limitez les accès aléatoires.

Symptôme : Le ZIL ne montre aucune activité

Cause : Le ZIL est configuré sur un disque non approprié ou les écritures synchrones ne sont pas utilisées.

Correctif : Vérifiez que le disque SSD est bien configuré comme log avec zpool status. Si votre workload ne contient pas d’écritures synchrones, le ZIL ne sera pas sollicité. Pour forcer des écritures synchrones, utilisez zfs set sync=always <poolname>/<dataset>.

Symptôme : Le système devient lent après l’ajout du cache

Cause : Le cache SSD est saturé ou le disque SSD est trop lent.

Correctif : Vérifiez l’état du cache avec arc_summary ou zpool iostat -v. Si le cache est saturé, augmentez la taille du SSD ou retirez-le du pool avec zpool remove <poolname> /dev/sdX. Si le SSD est trop lent, remplacez-le par un modèle plus performant ou vérifiez sa connexion.

FAQ

Comment choisir la taille du L2ARC ?

La taille du L2ARC dépend de votre jeu de données actif. En pratique, un L2ARC de 10% à 20% de la taille totale du pool ZFS est souvent suffisant pour les workloads typiques. Pour un pool de 10 To, un SSD de 2 To est une taille courante. Si vous utilisez TrueNAS ou Proxmox, consultez les statistiques d’utilisation pour ajuster cette taille. Une taille excessive consomme de la RAM pour les en-têtes du L2ARC, au détriment de l’ARC, ce qui peut réduire les performances.

Quelle est la différence entre L2ARC et ZIL ?

Le L2ARC est un cache de lecture qui accélère les accès aux données déjà stockées sur les HDD. Le ZIL est un cache d’écriture qui stocke temporairement les écritures synchrones avant qu’elles ne soient commitées sur le pool. Le ZIL est crucial pour les performances des services NFS ou les écritures synchrones fréquentes. En pratique, le ZIL doit être sur un support non volatile pour éviter les pertes de données en cas de panne.

Peut-on utiliser le même SSD pour L2ARC et ZIL ?

Oui, c’est possible, mais ce n’est pas recommandé. Le L2ARC et le ZIL ont des rôles différents et des exigences de performance distinctes. Utiliser deux SSD séparés permet d’optimiser les performances pour chaque cache. Si vous n’avez qu’un seul SSD, configurez-le comme L2ARC et utilisez un supercondensateur-backed ZIL pour maximiser la sécurité.

Comment nettoyer le cache L2ARC ?

Pour vider le cache L2ARC, retirez le périphérique cache avec zpool remove <poolname> /dev/sdX, puis ajoutez-le de nouveau avec zpool add <poolname> cache /dev/sdX. Le L2ARC étant persistant par défaut (l2arc_rebuild_enabled), un simple redémarrage ne le vide pas. Enfin, vérifiez l’état du cache avec zpool status pour confirmer que le nettoyage a bien fonctionné.

A lire aussi

Chiffres-clés

~45 minutes
Durée
Intermédiaire
Difficulté
Gratuit (logiciel libre)
Coût
TrueNAS ou Proxmox avec ZFS configuré
Prérequis clé

Notre sélection

Liens affiliés · prix identique pour toi
Recommandé
📦

Sabrent Rocket 4 Plus 8 To

Voir sur Amazon

Amazon · prix et disponibilité sur la fiche

Recommandé
📦

Samsung 870 EVO 2 To

Voir sur Amazon

Amazon · prix et disponibilité sur la fiche

Retrouve tout notre matériel recommandé dans la boutique.

Tags : zfscachenasperformanceshomelabssd

Sur le même sujet

Tutos

Recycler un vieux PC en serveur maison en 2026

Recycler un vieux PC en serveur maison en 2026 : quel PC garder (64 bits, RAM, SSD), réglages BIOS, Ubuntu Server LTS, Docker officiel, Nextcloud, MariaDB et Caddy en HTTPS.

Lire
Tutos

Montage rack métallique pour homelab 2026 : guide étape par étape

Découvrez notre tutoriel complet et détaillé pour installer un rack métallique en 2026. Guidez-vous avec nos conseils pratiques, fichiers de configuration complets et commandes exactes.

Lire
Tutos

Créer un NAS Raspberry Pi 5 en 2026 : Guide Complet

Guide 2026 pour transformer un Raspberry Pi 5 en NAS performant. Boîtier NVMe, Docker, Samba et sécurité pas à pas pour un self-hosting fiable.

Lire