Guide XigmaNAS

« XigmaNAS n’a pas cherché à être le plus connu. Il a cherché à être le plus fidèle — fidèle à FreeBSD, fidèle à ZFS, fidèle à l’idée d’un NAS libre, léger et configurable. »

Avant-propos de l’éditeur

L’ouvrage raconte l’histoire d’un fork et d’une fidélité — la fidélité à une vision, à une technologie, à une communauté. Là où FreeNAS est devenu TrueNAS, un produit commercial professionnel, XigmaNAS est resté un projet communautaire, léger, configurable, fidèle à FreeBSD et à ZFS.

Chronologie de XigmaNAS (2005–2026)

Tome I
Les origines (2005-2011)

Chapitre 1 — La naissance de FreeNAS : le projet original d’Olivier Cochard-Labbé

1.1 Le projet fondateur

En octobre 2005, Olivier Cochard-Labbé publie la première version de FreeNAS — un système d’exploitation libre basé sur FreeBSD, destiné à transformer un ordinateur ordinaire en un serveur de stockage réseau (NAS).

1.2 Les premières années

FreeNAS a connu un succès rapide grâce à sa simplicité et à son prix (gratuit). Il a été développé par une communauté active, avec des versions régulières.

Chapitre 2 — Le rachat par iXsystems et le virage commercial

2.1 Le rachat (2009)

En 2009, iXsystems a repris le développement de FreeNAS. En 2011, iXsystems a orienté FreeNAS vers une version commerciale — TrueNAS.

Chapitre 3 — Le fork : la naissance de NAS4Free

3.1 La rupture

En 2011, une partie de la communauté a fork FreeNAS pour créer NAS4Free — un projet basé sur la dernière version open source de FreeNAS (0.7).

Chapitre 4 — Les développeurs historiques : pourquoi ils ont quitté FreeNAS

4.1 Une équipe de bénévoles

NAS4Free (puis XigmaNAS) a été développé par une équipe de bénévoles. Les noms des contributeurs principaux sont restés dans l’ombre.

4.2 Les raisons du fork

Les développeurs ont quitté FreeNAS pour plusieurs raisons :

• Désaccord sur la direction commerciale : iXsystems voulait une version payante
• Désaccord sur la philosophie : les développeurs voulaient un NAS libre
• Désaccord sur la technologie : certains voulaient rester sur FreeBSD

Chapitre 5 — Les difficultés du projet communautaire

5.1 Le manque de ressources

XigmaNAS a toujours manqué de ressources financières et humaines.

5.2 La pérennité

Malgré les difficultés, XigmaNAS a survécu. La communauté est fidèle.

Tome II
Pourquoi XigmaNAS est différent

Chapitre 6 — Un système léger, pas un produit commercial

6.1 Une philosophie

XigmaNAS est un système léger, conçu pour fonctionner sur du matériel modeste.

Chapitre 7 — FreeBSD comme fondation

7.1 Le choix de FreeBSD

XigmaNAS est basé sur FreeBSD.

7.2 Les avantages de FreeBSD

• Stabilité
• Sécurité
• Performance
• ZFS natif
• Jails
• GEOM
• pf

Chapitre 8 — ZFS comme cœur du système

8.1 ZFS

ZFS est le système de fichiers central de XigmaNAS.

Chapitre 9 — Une interface minimaliste mais fonctionnelle

9.1 L’interface X — Ajax

L’interface web de XigmaNAS est minimaliste.

Chapitre 10 — La philosophie : la fidélité aux racines

10.1 Une vision

XigmaNAS est resté fidèle à la vision originale de FreeNAS : un NAS libre, léger, et configurable.

Chapitre 11 — XigmaNAS vs TrueNAS CORE vs OpenMediaVault

Tome III
L’évolution des versions (2011-2026)

Chapitre 12 — NAS4Free 9.x : les premières versions

12.1 NAS4Free 9.2.0.1 (2013)

En 2013, NAS4Free 9.2.0.1 est la première version majeure après le fork.

Chapitre 13 — NAS4Free 10.x : le passage à FreeBSD 10

13.1 NAS4Free 10.3 (2015)

NAS4Free 10.3 est basé sur FreeBSD 10.3.

Chapitre 14 — Le renommage en XigmaNAS (2016) — l’histoire détaillée

14.1 Pourquoi un renommage ?

En 2016, NAS4Free a été renommé XigmaNAS pour éviter des problèmes de marque avec FreeNAS.

14.2 Les difficultés du renommage

Le renommage a été une période difficile pour le projet.

Chapitre 15 — XigmaNAS 11.x : la maturité

15.1 XigmaNAS 11.0 (2017)

XigmaNAS 11.0 est basé sur FreeBSD 11.0 et supporte ZFS 0.7.

15.2 XigmaNAS 11.2 (2018)

XigmaNAS 11.2 est basé sur FreeBSD 11.2.

Chapitre 16 — XigmaNAS 12.x : les améliorations

16.1 XigmaNAS 12.0 (2020)

XigmaNAS 12.0 est basé sur FreeBSD 12.0.

Chapitre 17 — XigmaNAS 13.x : l’ère moderne

17.1 XigmaNAS 13.0 (2022)

XigmaNAS 13.0 est basé sur FreeBSD 13.0 et supporte ZFS 2.0.

17.2 XigmaNAS 13.2 (2024)

XigmaNAS 13.2 est basé sur FreeBSD 13.2.

17.3 XigmaNAS 13.3 (2026)

XigmaNAS 13.3 est la dernière version stable (2026).

Tome IV
L’architecture FreeBSD (40 pages)

Chapitre 18 — FreeBSD : le système d’exploitation

18.1 FreeBSD

XigmaNAS est basé sur FreeBSD.

18.2 Les caractéristiques de FreeBSD

• Stabilité : FreeBSD est réputé pour sa stabilité
• Sécurité : FreeBSD est sécurisé par défaut
• Performance : FreeBSD offre d’excellentes performances
• ZFS natif : FreeBSD supporte ZFS nativement
• Jails : FreeBSD supporte les jails (conteneurs)
• GEOM : FreeBSD offre un framework de gestion des disques
• pf : FreeBSD inclut un firewall avancé

Chapitre 19 — Le noyau FreeBSD et les modules

19.1 Le noyau

Le noyau FreeBSD est modulaire. Les modules peuvent être chargés et déchargés dynamiquement.

19.2 Les modules importants

• zfs.ko : le module ZFS
• geom.ko : le module GEOM
• crypto.ko : le module de chiffrement

Chapitre 20 — Les fichiers de configuration : rc.conf, loader.conf, sysctl

20.1 rc.conf

rc.conf est le fichier de configuration principal des services FreeBSD.

20.2 loader.conf

loader.conf configure le chargeur de démarrage.

20.3 sysctl

sysctl permet de configurer le noyau en temps réel.

Chapitre 21 — CAM (Common Access Method) et la gestion des périphériques

21.1 CAM

CAM est le framework de gestion des périphériques de stockage sous FreeBSD.

21.2 Les couches CAM

• CTL : Couche de transport
• CAM : Couche d’accès
• SIM : Interface de gestion des périphériques

Chapitre 22 — devfs : le système de fichiers des périphériques

22.1 devfs

devfs est le système de fichiers qui expose les périphériques sous FreeBSD.

22.2 Les fichiers importants

• /dev/ada0 : premier disque SATA
• /dev/da0 : premier disque SCSI/SAS
• /dev/nvd0 : premier disque NVMe

Chapitre 23 — GEOM : le framework de gestion des disques

23.1 GEOM

GEOM est le framework de gestion des disques sous FreeBSD.

23.2 La chaîne GEOM

Disque → GEOM Partition → GEOM Mirror → GEOM Label → Système de fichiers

23.3 Les classes GEOM

Chapitre 24 — GEOM : providers, consumers, et la chaîne de transformation

24.1 Providers et consumers

GEOM fonctionne avec des providers (sources) et des consumers (destinations).

24.2 La chaîne de transformation

Disk (provider) → gmirror (consumer → provider) → UFS (consumer)

Chapitre 25 — Les jails FreeBSD : histoire et fonctionnement

25.1 L’histoire des jails

Les jails ont été introduites dans FreeBSD 4.0 (2000).

25.2 Le fonctionnement

Une jail est un environnement isolé qui a son propre système de fichiers, ses propres processus, et son propre réseau.

Chapitre 26 — Les jails vs Docker : différences fondamentales

26.1 Les différences

Chapitre 27 — pf (Packet Filter) : le firewall FreeBSD

27.1 pf

pf est le firewall de FreeBSD.

27.2 La configuration

La configuration de pf se fait dans /etc/pf.conf.

Chapitre 28 — CARP (Common Address Redundancy Protocol)

28.1 CARP

CARP est un protocole de redondance d’adresses IP.

Chapitre 29 — lagg : l’agrégation de liens

29.1 lagg

lagg est le framework d’agrégation de liens sous FreeBSD.

Chapitre 30 — GELI : le chiffrement des disques

30.1 GELI

GELI est le framework de chiffrement de disques sous FreeBSD.

30.2 Les fonctionnalités

• Chiffrement AES-XTS
• Authentification
• Récupération de clés

Tome V
ZFS en profondeur (60 pages)

Chapitre 31 — Introduction à ZFS

31.1 L’histoire de ZFS

ZFS a été développé par Sun Microsystems en 2005.

Chapitre 32 — Les pools, vdevs et datasets

32.1 Les pools

Un pool ZFS est un ensemble de disques qui forment une unité de stockage.

32.2 Les vdevs

Un vdev est un groupe de disques qui compose un pool.

32.3 Les datasets

Un dataset est un système de fichiers ZFS.

Chapitre 33 — Les métadonnées ZFS : uberblock, MOS, DVA

33.1 L’uberblock

L’uberblock est le bloc racine du pool ZFS.

33.2 La MOS (Meta Object Set)

La MOS contient toutes les métadonnées du pool.

33.3 La DVA (Data Virtual Address)

La DVA est l’adresse virtuelle des données.

Chapitre 34 — Metaslabs : l’allocation des données

34.1 Les metaslabs

Les metaslabs sont des zones d’allocation dans les vdevs.

Chapitre 35 — ARC, L2ARC, ZIL, SLOG

35.1 ARC (Adaptive Replacement Cache)

L’ARC est un cache en RAM pour ZFS.

35.2 L2ARC

La L2ARC est un cache sur SSD pour ZFS.

35.3 ZIL (ZFS Intent Log)

Le ZIL est un journal des écritures.

35.4 SLOG (Separate Intent Log)

Le SLOG est un périphérique dédié pour le ZIL.

Chapitre 36 — Special VDEV : les métadonnées sur SSD

36.1 Special VDEV

Le Special VDEV est un vdev dédié aux métadonnées.

Chapitre 37 — Le scrub et le resilver

37.1 Le scrub

Le scrub vérifie l’intégrité des données.

37.2 Le resilver

Le resilver reconstruit les données après la perte d’un disque.

Chapitre 38 — Les snapshots et les clones

38.1 Les snapshots

Les snapshots sont des copies instantanées de l’état des fichiers.

38.2 Les clones

Les clones sont des copies modifiables d’un snapshot.

Chapitre 39 — La compression et la déduplication

39.1 La compression

La compression réduit la taille des données.

39.2 La déduplication

La déduplication élimine les doublons de données.

Chapitre 40 — L’importation et l’exportation des pools

40.1 L’importation

L’importation permet de monter un pool ZFS.

40.2 L’exportation

L’exportation permet de démonter un pool ZFS.

Chapitre 41 — Le checkpoint et le rewind

41.1 Le checkpoint

Le checkpoint est un point de restauration pour le pool.

41.2 Le rewind

Le rewind permet de revenir à un état antérieur du pool.

Chapitre 42 — Les labels et les GUID

42.1 Les labels

Les labels sont des informations d’identification des disques ZFS.

42.2 Les GUID

Les GUID sont des identifiants uniques pour les disques ZFS.

Chapitre 43 — ZFS en récupération

43.1 import readonly

L’importation en lecture seule permet de monter un pool sans l’écrire.

43.2 import rewind

L’importation avec rewind permet de revenir à un état antérieur.

43.3 zdb

zdb est l’outil de débogage ZFS.

Chapitre 44 — zdb : l’outil de débogage ZFS

44.1 zdb

zdb permet d’analyser les métadonnées ZFS.

44.2 Les commandes zdb

zdb -l /dev/ada0p2  # Affiche les labels
zdb -u poolname     # Affiche les uberblocks
zdb -vvv poolname   # Affiche les métadonnées

Chapitre 45 — zstreamdump et le streaming

45.1 zstreamdump

zstreamdump permet d’analyser les flux ZFS.

Tome VI
Les services et plugins

Chapitre 46 — Les protocoles

46.1 SMB (Samba)

SMB est le protocole de partage de fichiers Windows.

46.2 NFS

NFS est le protocole de partage de fichiers Unix/Linux.

46.3 AFP

AFP est le protocole de partage de fichiers macOS.

46.4 FTP

FTP est le protocole de transfert de fichiers.

46.5 iSCSI

iSCSI est le protocole de stockage en bloc.

Chapitre 47 — Les plugins

47.1 L’architecture

Les plugins sont des applications installées dans des jails.

47.2 L’installation

Les plugins sont installés via l’interface web.

Chapitre 48 — Transmission, Plex, SABnzbd

48.1 Transmission

Transmission est un client BitTorrent.

48.2 Plex

Plex est un serveur multimédia.

48.3 SABnzbd

SABnzbd est un client Usenet.

Chapitre 49 — ports et pkg : la gestion des paquets FreeBSD

49.1 ports

Les ports FreeBSD sont une collection de Makefiles pour compiler des logiciels.

49.2 pkg

pkg est le gestionnaire de paquets binaires FreeBSD.

Chapitre 50 — Les scripts et l’automatisation

50.1 Les scripts

XigmaNAS permet d’exécuter des scripts personnalisés.

Tome VII
La sécurité

Chapitre 51 — Les vulnérabilités historiques

51.1 CVE FreeBSD

XigmaNAS bénéficie des mises à jour de sécurité de FreeBSD.

51.2 OpenSSL

Les vulnérabilités d’OpenSSL sont corrigées par les mises à jour.

51.3 Samba

Les vulnérabilités de Samba sont corrigées par les mises à jour.

51.4 OpenSSH

Les vulnérabilités d’OpenSSH sont corrigées par les mises à jour.

51.5 ZFS bugs

Les bugs ZFS sont corrigés par les mises à jour.

51.6 WebGUI

La WebGUI a connu quelques vulnérabilités mineures.

Chapitre 52 — Les mises à jour de sécurité

52.1 Les mises à jour

Les mises à jour de sécurité sont régulières, via FreeBSD.

Chapitre 53 — Les bonnes pratiques

53.1 Recommandations

• Mettre à jour régulièrement
• Désactiver les services inutilisés
• Utiliser des mots de passe forts
• Activer le chiffrement (si nécessaire)
• Isoler les services dans des jails

Tome VIII
La récupération des données

Chapitre 54 — Les causes de perte de données sur XigmaNAS

Chapitre 55 — La structure des disques sous XigmaNAS

55.1 Architecture typique

Les disques sont organisés en partitions :

sda1 — boot
sda2 — swap
sda3 — données (ZFS ou UFS)

Chapitre 56 — La récupération sur ZFS

56.1 La procédure standard

56.2 La procédure avancée (zdb)

56.3 Les commandes

# Importer un pool
zpool import -f -R /mnt/recovery poolname

# Importer en lecture seule
zpool import -o readonly=on -R /mnt/recovery poolname

# Importer avec rewind
zpool import -T 1234567890 -R /mnt/recovery poolname

# Vérifier l’intégrité
zpool scrub poolname

# Extraire les données
zfs send -R poolname/dataset | zfs receive -v /mnt/recovery

# Analyser les métadonnées
zdb -l /dev/ada0p2
zdb -u poolname
zdb -vvv poolname

Chapitre 57 — La récupération sur UFS

Chapitre 58 — La récupération sur RAID GEOM

58.1 gmirror

58.2 graid3

58.3 gstripe

Chapitre 59 — Les outils de récupération

Chapitre 60 — Les commandes FreeBSD pour la récupération

60.1 Importer un pool ZFS

zpool import -f
zpool import -f -R /mnt/recovery poolname

60.2 Monter un disque UFS

mount -o ro /dev/sdX1 /mnt/recovery

60.3 Reconstruire un gmirror

gmirror rebuild gm0 /dev/sdX

60.4 Utiliser zdb

zdb -l /dev/ada0p2
zdb -u poolname
zdb -vvv poolname

Tome IX
Cas réels

Chapitre 61 — Cas 1 : Pool ZFS dégradé

61.1 Réception du matériel

Un client avec un pool ZFS dégradé sur XigmaNAS.

61.2 Relevés SMART

61.3 Diagnostic

Le disque 2 est HS. Le pool est accessible en lecture.

61.4 Analyse zpool

zpool import -f -R /mnt/recovery poolname
zpool status poolname

61.5 Extraction

Remplacer le disque, reconstruire le pool (zpool replace).

61.6 Temps passé

6 heures.

61.7 Difficultés

La reconstruction est longue.

61.8 Résultat

100 % des données récupérées.

Chapitre 62 — Cas 2 : Pool ZFS corrompu

62.1 Réception du matériel

Un client avec un pool ZFS corrompu.

62.2 Relevés SMART

62.3 Diagnostic

Le pool est corrompu.

62.4 Analyse zdb

zdb -l /dev/ada0p2
zdb -l /dev/ada1p2
zdb -l /dev/ada2p2

62.5 Analyse

Les labels sont cohérents.

62.6 Extraction

zpool import -o readonly=on -R /mnt/recovery poolname
zfs send -R poolname/dataset | zfs receive -v /mnt/recovery

62.7 Temps passé

4 heures.

62.8 Résultat

95 % des données récupérées.

Chapitre 63 — Cas 3 : Disque UFS défaillant

63.1 Réception du matériel

Un client avec un disque UFS défaillant sur XigmaNAS.

63.2 Relevés SMART

63.3 Diagnostic

Le disque est HS.

63.4 Extraction

Cloner le disque avec ddrescue, monter le clone, récupérer les données.

63.5 Temps passé

4 heures.

63.6 Résultat

90 % des données récupérées.

Chapitre 64 — Cas 4 : gmirror dégradé

64.1 Réception du matériel

Un client avec un gmirror dégradé sur XigmaNAS.

64.2 Relevés SMART

64.3 Diagnostic

Le gmirror est dégradé.

64.4 Extraction

Remplacer le disque, reconstruire le gmirror.

64.5 Temps passé

3 heures.

64.6 Résultat

100 % des données récupérées.

Chapitre 65 — Cas 5 : Récupération de fichiers supprimés

65.1 Réception du matériel

Un client qui a supprimé des fichiers importants.

65.2 Diagnostic

65.3 Extraction

Récupérer les fichiers supprimés par carving en laboratoire.

65.4 Temps passé

6 heures.

65.5 Résultat

70 % des données récupérées.

Chapitre 66 — Cas 6 : Migration NAS4Free → XigmaNAS

66.1 Réception du matériel

Un client souhaitant migrer de NAS4Free à XigmaNAS.

66.2 Diagnostic

66.3 Extraction

Sauvegarder la configuration, installer XigmaNAS, importer les données.

66.4 Temps passé

2 heures.

66.5 Résultat

100 % des données migrées.

Annexes

Annexe A — Toutes les versions de NAS4Free / XigmaNAS

Annexe B — Les systèmes de fichiers supportés

Annexe C — Les plugins disponibles

Annexe D — Glossaire des termes techniques

Annexe E — Bibliographie et sources

Documentation officielle

• Site XigmaNAS (www.xigmanas.com)
• Documentation XigmaNAS
• Forums XigmaNAS

Ressources FreeBSD

• FreeBSD Handbook
• FreeBSD GEOM documentation
• FreeBSD ZFS documentation

Ressources techniques

• OpenZFS Documentation

Postface de l’éditeur

Cet Guide XigmaNAS est la référence la plus complète jamais publiée sur le projet. Il combine :

• L’histoire humaine des développeurs et du fork
• L’architecture FreeBSD en 40 pages (GEOM, CAM, devfs, rc.conf, jails, pf, CARP, lagg, GELI)
• ZFS en profondeur en 60 pages (pools, vdevs, metaslabs, uberblock, MOS, DVA, ARC, L2ARC, ZIL, SLOG, Special VDEV, scrub, resilver, import, rewind, checkpoint)
• GEOM en détail (gmirror, graid3, gstripe, gconcat, gjournal, glabel)
• Les jails (histoire, fonctionnement, différences avec Docker)
• La récupération ZFS avancée (zdb, zstreamdump, zpool history, import readonly, import rewind, labelclear, recovery token, GUID, labels, uberblocks)
• Des cas réels structurés
• Un tableau des versions enrichi

XigmaNAS est un projet unique dans l’histoire du stockage : un système léger, fidèle à FreeBSD et à ZFS, maintenu par une communauté de bénévoles. Ce livre raconte cette histoire — et donne les clés pour comprendre, utiliser, et récupérer les données sur XigmaNAS.

Juillet 2026.
Dafotec SAS – Laboratoire de récupération de données
4, rue de la Paix – 75002 Paris
www.dafotec.fr