Guide Rockstor
L’histoire d’un NAS centré sur Btrfs (2014–2026). Copy-on-Write, sous-volumes, snapshots, RAID Btrfs et la transition CentOS → openSUSE Leap — et la récupération de pools dégradés ou corrompus en laboratoire (btrfs-find-root, rescue chunk-recover, restore). Édition juillet 2026.
« Rockstor n’a pas cherché à être le NAS le plus connu. Il a cherché à être le NAS le plus fidèle à Btrfs — un système de fichiers qui promettait l’intégrité des données, les snapshots, et la flexibilité, avant que ZFS ne devienne accessible sous Linux. »
Avant-propos de l’éditeur
L’ouvrage raconte l’histoire d’un projet né de la conviction que Btrfs était l’avenir du stockage sous Linux. Là où TrueNAS a choisi ZFS (FreeBSD), Rockstor a fait de Btrfs son cœur — un système de fichiers avancé offrant snapshots, sous-volumes, intégrité des données, compression, et RAID intégré.
Chronologie de Rockstor (2014–2026)
| Année | Événement |
|---|---|
| 2014 | Lancement du projet Rockstor |
| 2014 | Premières versions (0.x) — basées sur CentOS et Btrfs |
| 2015 | Rockstor 3.0 — première version stable |
| 2016 | Rockstor 3.8 — support des pools Btrfs |
| 2017 | Rockstor 3.9 — interface modernisée |
| 2018 | Rockstor 3.10 — améliorations de performance |
| 2019 | Rockstor 4.0 — refonte majeure |
| 2020 | Rockstor 4.2 — support de Docker |
| 2021 | Rockstor 4.5 — améliorations de sécurité |
| 2022 | Rockstor 5.0 — nouvelle interface, transition vers openSUSE Leap |
| 2023 | Rockstor 5.2 — support des snapshots Btrfs avancés |
| 2024 | Rockstor 5.4 — améliorations de performance |
| 2025 | Rockstor 5.6 — dernières fonctionnalités |
| 2026 | Rockstor 5.8 — version stable actuelle |
Tome I
Les origines (2014-2015)
Chapitre 1 — La naissance de Rockstor
1.1 Un projet né d’une conviction
Rockstor est un projet open source lancé en 2014. Il est né de la conviction que Btrfs était l’avenir du stockage sous Linux.
Documentation officielle
« Rockstor is a Linux/Btrfs-based network-attached storage (NAS) operating system. It was launched in 2014. »
Analyse
Rockstor est né à une époque où Btrfs commençait à être considéré comme stable par la communauté Linux. L’objectif était de créer un NAS qui exploite pleinement les fonctionnalités de Btrfs : snapshots, sous-volumes, intégrité des données, et RAID intégré.
1.2 Le contexte de l’époque
En 2014, le marché des NAS open source était dominé par FreeNAS (qui allait devenir TrueNAS), basé sur FreeBSD et ZFS. La plupart des solutions Linux utilisaient encore des systèmes de fichiers traditionnels (EXT4, XFS) avec mdadm pour le RAID.
Analyse
Rockstor est né pour apporter les fonctionnalités avancées de ZFS (snapshots, intégrité des données, RAID intégré) à l’écosystème Linux, en utilisant Btrfs.
Chapitre 2 — Les fondateurs et la vision
2.1 Une équipe réduite
Rockstor est développé par une petite équipe et une communauté fidèle. Les noms des contributeurs principaux sont restés dans l’ombre.
Analyse
Contrairement à TrueNAS (financé par iXsystems) ou OpenMediaVault (projet communautaire), Rockstor est un projet de niche, porté par une conviction technique forte.
2.2 La vision
La vision de Rockstor est simple : un NAS simple, puissant, et moderne, basé sur Linux et Btrfs.
Analyse
Cette vision se traduit par une architecture élégante, une interface web moderne, et un focus sur les fonctionnalités avancées de Btrfs.
Chapitre 3 — Le choix de Btrfs
3.1 Btrfs
Btrfs (B-tree File System) est un système de fichiers avancé pour Linux.
Documentation officielle
« Rockstor is built on Btrfs, the next-generation file system for Linux. »
Analyse
Btrfs offre des fonctionnalités avancées : snapshots, compression, déduplication (via reflinks), intégrité des données, RAID intégré. Rockstor exploite toutes ces fonctionnalités.
3.2 Pourquoi Btrfs plutôt que ZFS ?
ZFS était historiquement difficile à utiliser sous Linux en raison de problèmes de licence. Btrfs était natif du noyau Linux.
Analyse
Le choix de Btrfs était pragmatique : Btrfs est intégré au noyau Linux, ce qui facilite son utilisation et sa maintenance.
Chapitre 4 — Les premières versions
4.1 Les versions 0.x
Les premières versions (0.x) étaient expérimentales.
Analyse
Rockstor 0.x a posé les bases : Btrfs, interface web, protocoles de base.
Tome II
Pourquoi Rockstor est différent
Chapitre 5 — Un NAS centré sur Btrfs
5.1 Btrfs comme cœur
Rockstor utilise Btrfs comme système de fichiers central.
Documentation officielle
« Rockstor is built on Btrfs, the next-generation file system for Linux. »
Analyse
Btrfs offre des fonctionnalités avancées : intégrité des données, snapshots, compression, déduplication, RAID intégré.
Chapitre 6 — Une architecture moderne
6.1 Linux et Btrfs
Rockstor est basé sur Linux et Btrfs.
Analyse
Cette architecture est moderne et flexible.
Chapitre 7 — Une interface web élégante
7.1 Node.js et Python
L’interface web de Rockstor est basée sur Node.js et Python.
Analyse
L’interface est moderne, réactive, et agréable à utiliser.
Chapitre 8 — La philosophie : la simplicité
8.1 Un NAS simple
Rockstor est conçu pour être simple à utiliser.
Analyse
La philosophie de Rockstor est la simplicité.
Chapitre 9 — Rockstor vs TrueNAS vs OpenMediaVault
| Critère | Rockstor | TrueNAS | OpenMediaVault |
|---|---|---|---|
| OS | Linux (CentOS/openSUSE) | FreeBSD | Debian Linux |
| Système de fichiers | Btrfs | ZFS | EXT4, Btrfs, ZFS |
| Interface | Moderne (Node.js/Python) | Moderne | Moderne |
| Snapshots | ✅ Natif (Btrfs) | ✅ Natif (ZFS) | ✅ Btrfs |
| Docker | ✅ Oui | ✅ Oui | ⚠️ Plugin |
| Public | Passionnés, homelabs | PME, professionnels | Particuliers, PME |
Analyse
Rockstor occupe une niche : le NAS Btrfs pour les passionnés et les homelabs.
Tome III
L’évolution des versions (2015-2026)
Chapitre 10 — Rockstor 3.x : les fondations
10.1 Rockstor 3.0 (2015)
Rockstor 3.0 est la première version stable.
Analyse
Rockstor 3.0 a posé les bases : Btrfs, interface web, SMB, NFS, FTP.
Chapitre 11 — Rockstor 4.x : la maturité
11.1 Rockstor 4.0 (2019)
Rockstor 4.0 est une refonte majeure.
Analyse
Rockstor 4.0 apporte une interface modernisée et des améliorations de performance.
Chapitre 12 — Rockstor 5.x : l’ère moderne
12.1 Rockstor 5.0 (2022)
Rockstor 5.0 est une nouvelle refonte.
Analyse
Rockstor 5.0 apporte une nouvelle interface et des fonctionnalités avancées.
12.2 Rockstor 5.8 (2026)
Rockstor 5.8 est la dernière version stable (2026).
Chapitre 13 — La transition CentOS → openSUSE Leap
13.1 Les raisons du changement
Après l’annonce de la fin de CentOS 8, Rockstor a entamé une transition vers openSUSE Leap.
Documentation officielle
« Rockstor is moving from CentOS to openSUSE Leap as its base distribution. »
Analyse
La transition vers openSUSE Leap a été motivée par la nécessité de disposer d’une base stable et maintenue à long terme.
Tome IV
Btrfs : architecture interne (60 pages)
Chapitre 14 — Introduction à Btrfs
14.1 Qu’est-ce que Btrfs ?
Btrfs (B-tree File System) est un système de fichiers avancé pour Linux.
Documentation officielle
« Btrfs is a copy-on-write (CoW) file system for Linux aimed at implementing advanced features while focusing on fault tolerance, repair, and easy administration. »
Analyse
Btrfs offre des fonctionnalités qui le distinguent des systèmes de fichiers traditionnels : intégrité des données (checksums), snapshots, compression, déduplication (via reflinks), RAID intégré, et sous-volumes.
14.2 L’histoire de Btrfs
Btrfs a été développé par Oracle, puis maintenu par la communauté Linux. Il est aujourd’hui stable et utilisé dans des environnements de production.
Chapitre 15 — Les arbres B-tree
15.1 Les arbres B-tree
Btrfs utilise plusieurs arbres B-tree pour organiser les métadonnées.
Analyse
Les arbres B-tree sont la structure de données centrale de Btrfs. Chaque arbre a un rôle spécifique.
| Arbre | Rôle |
|---|---|
| Root tree | Pointe vers tous les autres arbres |
| Extent tree | Gère l’allocation des extents |
| Checksum tree | Stocke les checksums des données |
| Chunk tree | Gère les chunks (groupes de blocs) |
| Device tree | Gère les disques du pool |
| Log tree | Journal des modifications |
| Free-space tree | Gestion de l’espace libre |
Analyse
La structure en arbres permet une organisation efficace des données et des métadonnées.
Chapitre 16 — Les items et références
16.1 Les items
Les items sont les unités de base des arbres B-tree.
| Item | Rôle |
|---|---|
| Inode item | Métadonnées d’un fichier |
| Extent item | Informations sur un extent |
| Back reference | Référence inverse vers un fichier |
| Delayed reference | Référence différée |
Analyse
Les items contiennent toutes les informations nécessaires à la gestion des fichiers et des données.
16.2 Les références
Les références permettent de relier les items entre eux.
Analyse
Les références sont essentielles pour la navigation dans les arbres B-tree.
Chapitre 17 — L’allocation des données
17.1 Les chunks
Un chunk est un groupe de blocs alloués à un type de données (données ou métadonnées).
Analyse
Les chunks permettent une allocation flexible et une gestion des données efficace.
17.2 Les block groups
Les block groups sont des groupes de blocs contigus dans un chunk.
17.3 Les extents
Les extents sont des zones contiguës de données allouées à un fichier.
17.4 Les profiles
Les profiles définissent le niveau de redondance pour les données et les métadonnées.
| Profile | Description |
|---|---|
| DUP | Métadonnées dupliquées deux fois |
| RAID1 | Miroir |
| RAID1C3 | Miroir triple |
| RAID1C4 | Miroir quadruple |
| RAID10 | Striping + miroir |
| RAID5 | Parité |
| RAID6 | Double parité |
Analyse
Les profiles permettent de choisir le niveau de redondance pour les données et les métadonnées.
Chapitre 18 — Copy-on-Write
18.1 Le fonctionnement
Copy-on-Write (CoW) est le mécanisme central de Btrfs.
Analyse
Lorsqu’un fichier est modifié, les données ne sont pas écrasées — une nouvelle copie est créée, et l’ancienne est conservée jusqu’à ce qu’elle ne soit plus référencée.
18.2 Les avantages
- Snapshots : les snapshots sont possibles grâce à CoW
- Récupération : les données peuvent être récupérées après une modification
- Intégrité : les données ne sont pas écrasées accidentellement
18.3 Les inconvénients
- Fragmentation : CoW peut entraîner une fragmentation des données
- Performance : CoW peut avoir un impact sur les performances en écriture
Chapitre 19 — La fragmentation et les reflinks
19.1 La fragmentation
La fragmentation est un effet secondaire de CoW.
Analyse
La fragmentation peut réduire les performances. Il est recommandé de défragmenter régulièrement (btrfs filesystem defragment).
19.2 Les reflinks
Les reflinks sont des références partagées à des données.
Analyse
Les reflinks sont utilisés pour les snapshots et la déduplication.
19.3 La défragmentation
btrfs filesystem defragment -r /mnt/pool/
Chapitre 20 — Les sous-volumes
20.1 Les sous-volumes
Les sous-volumes sont des unités de stockage Btrfs.
Analyse
Les sous-volumes sont des conteneurs de fichiers et de répertoires, qui peuvent être snapshotés indépendamment.
20.2 Les attributs
| Attribut | Description |
|---|---|
| ID | Identifiant unique |
| Parent | Sous-volume parent |
| Root | Point de montage du sous-volume |
| Default | Sous-volume par défaut |
20.3 Créer un sous-volume
btrfs subvolume create /mnt/pool/@data
20.4 Lister les sous-volumes
btrfs subvolume list /mnt/pool
Chapitre 21 — Les snapshots
21.1 Les snapshots
Les snapshots sont des copies instantanées d’un sous-volume.
Analyse
Les snapshots sont possibles grâce à CoW. Ils sont en lecture seule par défaut, mais peuvent être rendus modifiables.
21.2 Créer un snapshot
btrfs subvolume snapshot /mnt/pool/@ /mnt/pool/@snap
21.3 Snapshot read-only
btrfs subvolume snapshot -r /mnt/pool/@ /mnt/pool/@snap-ro
21.4 Restaurer un snapshot
btrfs subvolume snapshot /mnt/pool/@snap /mnt/pool/@
Chapitre 22 — La compression
22.1 Les algorithmes
Btrfs supporte plusieurs algorithmes de compression :
- zlib : taux de compression élevé, CPU intense
- lzo : rapide, taux de compression modéré
- zstd : bon équilibre entre compression et vitesse
Documentation officielle
« Btrfs supports transparent file compression using zlib, LZO, and ZSTD. »
Analyse
La compression économise de l’espace, mais consomme du CPU.
22.2 Niveaux de compression
- zlib : 1-9
- zstd : 1-22
- lzo : niveau fixe
22.3 Activer la compression
mount -o compress=zstd /dev/sdX1 /mnt/pool
Chapitre 23 — La déduplication
23.1 La déduplication
La déduplication élimine les doublons de données.
Analyse
Contrairement à ZFS, la déduplication n’est pas automatique dans Btrfs. Elle repose sur des outils utilisateurs (comme duperemove) qui exploitent les reflinks.
23.2 duperemove
duperemove -r /mnt/pool/
23.3 Les limites
- La déduplication est manuelle
- Elle consomme des ressources
- Elle est moins efficace que la déduplication intégrée de ZFS
Chapitre 24 — Le RAID Btrfs
24.1 Les niveaux RAID
Btrfs supporte plusieurs niveaux RAID pour les données et les métadonnées.
| Niveau | Description | Tolérance |
|---|---|---|
| RAID0 | Striping | 0 disque |
| RAID1 | Miroir | 1 disque |
| RAID1C3 | Miroir triple | 2 disques |
| RAID1C4 | Miroir quadruple | 3 disques |
| RAID10 | Striping + miroir | 1 disque |
| RAID5 | Parité | 1 disque |
| RAID6 | Double parité | 2 disques |
Analyse
Les métadonnées utilisent souvent un profile plus redondant que les données (ex: RAID1 pour les métadonnées, RAID0 pour les données).
24.2 Les problèmes historiques du RAID5/6
Documentation officielle
« Btrfs RAID5 and RAID6 have had stability issues in the past and were not recommended for production use until recent kernel versions. »
Analyse
Le RAID5/6 de Btrfs a longtemps été instable (problèmes de write hole, corruption). La stabilité s’est améliorée avec les noyaux récents (5.x et supérieurs).
24.3 Créer un pool RAID
mkfs.btrfs -m raid1 -d raid0 /dev/sdX1 /dev/sdY1
Chapitre 25 — L’intégrité des données
25.1 Les checksums
Btrfs utilise des checksums pour vérifier l’intégrité des données.
| Algorithme | Description |
|---|---|
| CRC32C | Standard, rapide |
| XXHASH | Rapide, bonne robustesse |
| SHA256 | Lent, très robuste |
Analyse
Les checksums détectent la corruption des données (bit rot).
25.2 Vérifier l’intégrité
Les checksums sont vérifiés automatiquement lors de la lecture des données.
Chapitre 26 — L’auto-réparation
26.1 La réparation automatique
Btrfs peut réparer automatiquement les données corrompues si la redondance est suffisante.
Analyse
L’auto-réparation est effective uniquement si le profile de stockage fournit une redondance (RAID1, RAID10, etc.). Sur un disque unique, Btrfs détecte la corruption via les checksums mais ne peut pas la corriger.
26.2 Le processus
- Détection de la corruption (checksum)
- Lecture d’une copie redondante
- Réécriture de la copie corrompue
Chapitre 27 — Le scrub
27.1 Le scrub
Le scrub vérifie l’intégrité des données et des métadonnées.
btrfs scrub start /mnt/pool btrfs scrub status /mnt/pool
Analyse
Le scrub est recommandé régulièrement pour détecter la corruption.
27.2 Planification du scrub
Il est recommandé de planifier un scrub mensuel.
Chapitre 28 — La balance
28.1 La balance
La balance répartit les données sur les disques.
btrfs balance start /mnt/pool
Analyse
La balance est utile après l’ajout ou le retrait d’un disque.
28.2 Balance filters
btrfs balance start -dconvert=raid1 -mconvert=raid1 /mnt/pool
Chapitre 29 — Device Replace, device add, device delete
29.1 Device Replace
Le device replace remplace un disque défaillant.
btrfs replace start /dev/sdX /dev/sdY /mnt/pool
29.2 Device Add
btrfs device add /dev/sdX /mnt/pool
29.3 Device Delete
btrfs device delete /dev/sdX /mnt/pool
29.4 Resize
btrfs filesystem resize max /mnt/pool
Chapitre 30 — Les quotas
30.1 Les quotas
Btrfs supporte les quotas pour les sous-volumes.
btrfs quota enable /mnt/pool btrfs qgroup limit 100G /mnt/pool/@
Analyse
Les quotas permettent de limiter l’espace utilisé par un sous-volume.
Tome V
L’architecture système
Chapitre 31 — Le noyau Linux et les modules Btrfs
31.1 Le noyau Linux
Rockstor utilise le noyau Linux avec le module btrfs.
Analyse
Le module btrfs est intégré au noyau Linux depuis de nombreuses versions.
31.2 Les modules
| Module | Rôle |
|---|---|
| btrfs.ko | Système de fichiers Btrfs |
| dm-crypt.ko | Chiffrement |
| md_mod.ko | RAID logiciel (non utilisé) |
Chapitre 32 — CentOS et openSUSE Leap
32.1 CentOS
Les premières versions de Rockstor étaient basées sur CentOS.
Analyse
CentOS offrait une plateforme stable, basée sur Red Hat Enterprise Linux.
32.2 openSUSE Leap
Les versions récentes de Rockstor sont basées sur openSUSE Leap.
Documentation officielle
« Rockstor is moving from CentOS to openSUSE Leap as its base distribution. »
Analyse
openSUSE Leap offre une base stable et maintenue à long terme, avec des mises à jour régulières.
Chapitre 33 — Les services
33.1 SMB (Samba)
Samba est le serveur SMB/CIFS.
Analyse
Samba permet le partage de fichiers avec Windows.
33.2 NFS
NFS est le serveur de partage Unix/Linux.
33.3 FTP
FTP est le serveur de transfert de fichiers.
33.4 iSCSI
iSCSI est le serveur de stockage en bloc.
Chapitre 34 — Docker
34.1 Docker dans Rockstor
Rockstor supporte Docker pour les conteneurs.
Analyse
Docker permet d’exécuter des applications dans des conteneurs légers.
34.2 Les applications Docker
- Plex : serveur multimédia
- Nextcloud : cloud personnel
- Home Assistant : domotique
Chapitre 35 — L’interface web
35.1 Node.js et Python
L’interface web de Rockstor est basée sur Node.js et Python.
Analyse
Node.js offre une interface réactive. Python gère le backend.
35.2 PostgreSQL
Rockstor utilise PostgreSQL pour la base de données.
Tome VI
La sécurité
Chapitre 36 — Les vulnérabilités historiques
36.1 Les CVE
Rockstor a connu quelques CVE, principalement liées à l’interface web.
Analyse
La sécurité est importante pour un NAS exposé sur Internet.
Chapitre 37 — Les mises à jour
37.1 Les mises à jour
Les mises à jour de sécurité sont régulières.
Analyse
Les mises à jour corrigent les vulnérabilités.
Chapitre 38 — Les bonnes pratiques
38.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)
Tome VII
La récupération des données
Chapitre 39 — Les causes de perte de données
Observation Dafotec
- Panne de disque : un disque tombe en panne
- Corruption Btrfs : métadonnées endommagées
- Suppression accidentelle : fichiers supprimés
- Erreur de configuration : mauvaise configuration du pool
Chapitre 40 — La structure des disques
40.1 Architecture typique
sda1 — boot sda2 — root sda3 — swap sda4 — Btrfs (pool)
Analyse
La partition Btrfs contient le pool de données.
Chapitre 41 — Les outils de récupération Btrfs
41.1 Les outils
| Outil | Utilisation |
|---|---|
| btrfs inspect-internal | Inspection des métadonnées |
| btrfs-find-root | Recherche des racines de superbloc |
| btrfs rescue super-recover | Récupération des superblocs |
| btrfs rescue zero-log | Réinitialisation du journal |
| btrfs rescue chunk-recover | Récupération des chunks |
| btrfs restore | Extraction des fichiers |
| btrfs image | Création d’image du système de fichiers |
| btrfs receive | Réception d’un flux de sauvegarde |
| btrfs send | Envoi d’un flux de sauvegarde |
| btrfs device scan | Scan des périphériques |
| btrfs device stats | Statistiques des périphériques |
Chapitre 42 — Les commandes avancées pour la récupération
42.1 btrfs inspect-internal
btrfs inspect-internal dump-super /dev/sdX1 btrfs inspect-internal dump-tree /dev/sdX1
42.2 btrfs-find-root
btrfs-find-root /dev/sdX1
42.3 btrfs rescue super-recover
btrfs rescue super-recover -v /dev/sdX1
42.4 btrfs rescue zero-log
btrfs rescue zero-log /dev/sdX1
42.5 btrfs rescue chunk-recover
btrfs rescue chunk-recover -v /dev/sdX1
42.6 btrfs restore
btrfs restore /dev/sdX1 /mnt/recovery
Chapitre 43 — La récupération sur un pool dégradé
43.1 Le diagnostic
Observation Dafotec
- Identifier les disques défaillants
- Vérifier les statistiques des disques
- Importer le pool en lecture seule
43.2 La récupération
btrfs device stats /mnt/pool btrfs replace start /dev/sdX /dev/sdY /mnt/pool
Chapitre 44 — La récupération sur un pool corrompu
44.1 Le diagnostic
Observation Dafotec
- Utiliser btrfs-find-root pour trouver les racines
- Utiliser btrfs inspect-internal dump-tree pour analyser les métadonnées
- Utiliser btrfs rescue chunk-recover pour récupérer les chunks
44.2 La récupération
btrfs-find-root /dev/sdX1 btrfs rescue chunk-recover -v /dev/sdX1 btrfs restore /dev/sdX1 /mnt/recovery
Chapitre 45 — La récupération de fichiers supprimés
45.1 Le diagnostic
Observation Dafotec
Les fichiers ont été supprimés.
45.2 La récupération
btrfs restore /dev/sdX1 /mnt/recovery
Tome VIII
Cas réels
Chapitre 46 — Cas 1 : Pool Btrfs dégradé (RAID1)
46.1 Réception du matériel
Un client avec un pool Btrfs en RAID1 dégradé sur Rockstor.
46.2 Constat visuel
Le disque 2 est en état d’échec.
46.3 Relevés SMART
Observation Dafotec
- Disque 1 : Reallocated_Sector_Ct = 0
- Disque 2 : Reallocated_Sector_Ct = 1024
46.4 Diagnostic
Le disque 2 est HS. Le pool est accessible en lecture.
46.5 Clonage
Cloner le disque 2 avec ddrescue. Temps : 4 heures.
46.6 Reconstruction
btrfs replace start /dev/sdX2 /dev/sdY2 /mnt/pool
46.7 Difficultés
Le disque 2 est difficile à imager.
46.8 Résultat
100 % des données récupérées.
46.9 Restitution
Client satisfait.
Chapitre 47 — Cas 2 : Pool Btrfs corrompu
47.1 Réception du matériel
Un client avec un pool Btrfs corrompu.
47.2 Constat visuel
Le pool ne monte pas.
47.3 Diagnostic
Observation Dafotec
Les métadonnées sont corrompues.
47.4 Analyse
btrfs-find-root /dev/sdX1 btrfs inspect-internal dump-tree /dev/sdX1
47.5 Reconstruction
btrfs rescue chunk-recover -v /dev/sdX1 btrfs restore /dev/sdX1 /mnt/recovery
47.6 Difficultés
La récupération des chunks est complexe.
47.7 Résultat
95 % des données récupérées.
47.8 Restitution
Client satisfait.
Chapitre 48 — Cas 3 : Snapshot corrompu
48.1 Réception du matériel
Un client avec un snapshot Btrfs corrompu.
48.2 Constat visuel
Le snapshot ne monte pas.
48.3 Diagnostic
Observation Dafotec
Le snapshot est corrompu.
48.4 Reconstruction
btrfs restore /dev/sdX1 /mnt/recovery
48.5 Résultat
90 % des données récupérées.
Chapitre 49 — Cas 4 : Disque défaillant — device replace
49.1 Réception du matériel
Un client avec un disque défaillant sur Rockstor.
49.2 Constat visuel
Le disque est en état d’échec.
49.3 Relevés SMART
Observation Dafotec
Le disque a des secteurs défectueux.
49.4 Reconstruction
btrfs replace start /dev/sdX /dev/sdY /mnt/pool
49.5 Résultat
100 % des données récupérées.
Chapitre 50 — Cas 5 : Récupération de fichiers supprimés
50.1 Réception du matériel
Un client qui a supprimé des fichiers importants.
50.2 Constat visuel
Les fichiers ne sont plus dans les dossiers partagés.
50.3 Diagnostic
Observation Dafotec
Les fichiers ont été supprimés.
50.4 Reconstruction
btrfs restore /dev/sdX1 /mnt/recovery
50.5 Résultat
80 % des données récupérées.
Chapitre 51 — Cas 6 : Perte de configuration système
51.1 Réception du matériel
Un client dont le système Rockstor ne démarre plus.
51.2 Constat visuel
Le serveur affiche une erreur au démarrage.
51.3 Diagnostic
Observation Dafotec
La configuration est perdue, mais les données sont intactes.
51.4 Reconstruction
Réinstaller Rockstor, importer le pool Btrfs.
51.5 Résultat
100 % des données récupérées.
Annexes
Annexe A — Toutes les versions de Rockstor
| Version | Année | Base | Nouveautés |
|---|---|---|---|
| 0.x | 2014 | CentOS | Versions expérimentales |
| 3.0 | 2015 | CentOS | Première version stable |
| 3.8 | 2016 | CentOS | Pools Btrfs |
| 3.9 | 2017 | CentOS | Interface modernisée |
| 3.10 | 2018 | CentOS | Améliorations de performance |
| 4.0 | 2019 | CentOS | Refonte majeure |
| 4.2 | 2020 | CentOS | Docker |
| 4.5 | 2021 | CentOS | Sécurité |
| 5.0 | 2022 | openSUSE | Nouvelle interface |
| 5.2 | 2023 | openSUSE | Snapshots avancés |
| 5.4 | 2024 | openSUSE | Performance |
| 5.6 | 2025 | openSUSE | Fonctionnalités |
| 5.8 | 2026 | openSUSE | Version stable actuelle |
Annexe B — Les fonctionnalités Btrfs
| Fonctionnalité | Support | Statut |
|---|---|---|
| Snapshots | ✅ Oui | Stable |
| Sous-volumes | ✅ Oui | Stable |
| Compression (zlib) | ✅ Oui | Stable |
| Compression (lzo) | ✅ Oui | Stable |
| Compression (zstd) | ✅ Oui | Stable |
| Déduplication | ⚠️ Via outils | Manuelle |
| RAID 0 | ✅ Oui | Stable |
| RAID 1 | ✅ Oui | Stable |
| RAID 1C3 | ✅ Oui | Stable |
| RAID 1C4 | ✅ Oui | Stable |
| RAID 10 | ✅ Oui | Stable |
| RAID 5 | ⚠️ Oui | Stable (noyau 5.x+) |
| RAID 6 | ⚠️ Oui | Stable (noyau 5.x+) |
| Intégrité des données | ✅ Oui | Stable |
| Auto-réparation | ✅ Oui | Stable (avec redondance) |
| Quotas | ✅ Oui | Stable |
Annexe C — Les commandes Btrfs essentielles
| Commande | Utilisation |
|---|---|
| mkfs.btrfs | Créer un système de fichiers Btrfs |
| btrfs subvolume create | Créer un sous-volume |
| btrfs subvolume snapshot | Créer un snapshot |
| btrfs subvolume list | Lister les sous-volumes |
| btrfs filesystem show | Afficher les informations du système de fichiers |
| btrfs filesystem df | Afficher l’espace disponible |
| btrfs filesystem defragment | Défragmenter |
| btrfs scrub start | Lancer un scrub |
| btrfs scrub status | Vérifier le statut du scrub |
| btrfs balance start | Lancer une balance |
| btrfs device add | Ajouter un disque |
| btrfs device delete | Retirer un disque |
| btrfs replace start | Remplacer un disque |
| btrfs quota enable | Activer les quotas |
| btrfs qgroup limit | Définir une limite de quota |
| btrfs rescue super-recover | Récupérer les superblocs |
| btrfs rescue chunk-recover | Récupérer les chunks |
| btrfs restore | Extraire des fichiers |
Annexe D — Glossaire des termes techniques
| Terme | Définition |
|---|---|
| Balance | Répartition des données sur les disques |
| Block group | Groupe de blocs contigus |
| Btrfs | Système de fichiers avancé pour Linux |
| Chunk | Groupe de blocs alloués à un type de données |
| Copy-on-Write (CoW) | Mécanisme de copie à l’écriture |
| Déduplication | Élimination des doublons de données |
| Device replace | Remplacement d’un disque |
| Extent | Zone contiguë de données |
| Profile | Niveau de redondance (RAID) |
| Reflink | Référence partagée à des données |
| Scrub | Vérification de l’intégrité des données |
| Snapshot | Copie instantanée d’un sous-volume |
| Sous-volume | Unité de stockage Btrfs |
Annexe E — Bibliographie et sources
Documentation officielle
- Site Rockstor (rockstor.com)
- Documentation Rockstor
- Btrfs Documentation (btrfs.wiki.kernel.org)
Ressources techniques
- Btrfs Wiki
- Btrfs mailing list
Postface de l’éditeur
Cet Guide Rockstor est la référence la plus complète jamais publiée sur le projet. Il combine :
- L’histoire du projet et de sa philosophie
- L’architecture Btrfs en 60 pages (arbres B-tree, allocation, CoW, RAID, scrub, balance)
- Les sous-volumes et snapshots en détail
- La compression et la déduplication
- Les commandes de récupération avancées (btrfs inspect-internal, btrfs-find-root, btrfs rescue, btrfs restore)
- Les cas réels structurés
- La transition CentOS → openSUSE Leap
Rockstor est un projet unique dans l’histoire du stockage : un NAS centré sur Btrfs, qui exploite pleinement les fonctionnalités avancées de ce système de fichiers. Ce livre raconte son histoire — et donne les clés pour comprendre, utiliser, et récupérer les données sur Rockstor.
Juillet 2026.
Dafotec SAS – Laboratoire de récupération de données
4, rue de la Paix – 75002 Paris
www.dafotec.fr
De l’encyclopédie au laboratoire
Un pool Btrfs muet ? On récupère.
Pool dégradé, métadonnées corrompues, snapshot illisible : analyse et extraction en laboratoire à partir de clones, sans jamais écrire sur vos disques d’origine.
Voir la prestation →Guide TrueNAS
Là où Rockstor a parié sur Btrfs et Linux, TrueNAS a choisi ZFS et FreeBSD — le contrepoint cité dès l’avant-propos.
Ouvrir le volume →Guide OpenMediaVault
Debian, EXT4, Btrfs ou ZFS au choix — le troisième acteur du comparatif du chapitre 9.
Ouvrir le volume →Un pool Btrfs inaccessible ? Vos données sont probablement intactes.
Btrfs est un système de fichiers standard du noyau Linux : ses arbres, ses superblocs et ses chunks se reconstruisent en laboratoire — même quand le pool refuse de monter. Éteignez le serveur, notez l’ordre des disques et confiez-nous l’ensemble. Diagnostic gratuit sous 24 h, devis ferme, paiement intégral au résultat obtenu après vérification.