Debian Cockpit
⚠️ Avertissement Important : Debian 13 est en version "Testing".
Les mises à jour sont fréquentes (quasi quotidiennes).
Le dépôt 45Drives n'existe pas officiellement pour "Trixie". J'ai modifié la commande ci-dessous pour forcer l'utilisation des paquets "Bookworm" (Debian 12), ce qui fonctionne généralement, mais c'est du bricolage.
GUIDE D'INSTALLATION NAS 36 BAIES (Debian 13 "Trixie")
Architecture : MergerFS + SnapRAID (3 Parités) Matériel : 1 SSD (OS) + 33 Disques Données (6TB) + 3 Disques Parité (6TB)
🛠️ PHASE 0 : RÉSEAU, SÉCURITÉ & LOGICIELS
Objectif : Fixer l'IP, sécuriser le SSD et installer les outils.
Démarrage : Serveur allumé. Connecté en root.
🌐 CONFIGURATION RÉSEAU (IP STATIQUE)
Identifier l'interface : Tapez ip link. Repérez celle qui n'est pas lo (ex: ens18, enp3s0). Prenons enp3s0 pour l'exemple.
Éditer le fichier :
Modifier : Remplacez la section dhcp par ceci (ajustez selon votre réseau) :
Sauvegardez (Ctrl+O, Entrée) et Quittez (Ctrl+X).
Appliquez : systemctl restart networking ou attendez le redémarrage à la fin de cette phase.
Bash
# Démarrage automatique
auto enp3s0
allow-hotplug enp3s0
# Configuration Statique
iface enp3s0 inet static
address 192.168.1.50/24 # Votre IP désirée
gateway 192.168.1.1 # Votre routeur
dns-nameservers 1.1.1.1 8.8.8.8
Bash
nano /etc/network/interfaces
1. Ajouter Pablo au groupe sudo
Tapez ceci dans votre terminal root :
Bash
usermod -aG sudo pablo
(Note : Si cette commande ne fonctionne pas pour une raison quelconque, vous pouvez utiliser l'alternative Debian : adduser pablo sudo)
2. Vérifier que c'est fait
Pour confirmer que Pablo fait bien partie du groupe, tapez :
Bash
groups pablo
Vous devriez voir une réponse ressemblant à : pablo : pablo sudo
3. Appliquer les changements
Pour que Cockpit prenne en compte ce changement, il faut souvent se déconnecter et se reconnecter.
Dans Cockpit : Déconnectez-vous (Log out) et reconnectez-vous avec l'utilisateur Pablo.
Si cela ne fonctionne toujours pas immédiatement, redémarrez simplement le service Cockpit ou le serveur :
Bash
systemctl restart cockpit
Objectif : Installer l'OS "Testing" et forcer la compatibilité des outils.
Matériel : Connecter UNIQUEMENT le SSD. Débrancher tous les autres disques.
OS : Télécharger et installer Debian 13 (Daily Build).: https://www.debian.org/distrib/netinst
Choix logiciels : "SSH Server" et "Standard System Utilities" uniquement.
Premier Démarrage : Se connecter en root (su -).
Identification de la racine :
lsblk -f
lsblk -o NAME,LABEL
lsblk -d -n -o NAME | xargs
# Repérer la partition montée sur / (ex: sda2 ou nvme0n1p2)
Sécurisation du nom SSD (Label) :
Si ext4 : e2label /dev/sda2 DISKSSD
Si xfs : xfs_admin -L DISKSSD /dev/sda2
Si lvm: e2label /dev/mapper/noe01--vg-root DISKSSD
e2label /dev/mapper/noe01--vg-root DISKSSD
(Attention: mon serveur s'appelle noe01)
Explication
Au lieu de viser /dev/sda2 (qui est juste le conteneur), on vise le volume logique précis où Debian est installé.
/dev/mapper/noe01--vg-root est le chemin complet vers ton volume racine.
Vérification
blkid /dev/mapper/noe01--vg-root
lsblk -f
Installation des Logiciels :
apt update && apt upgrade -y
# Ajout de 'screen' pour les transferts longs et 'samba'
apt install -y xfsprogs curl vim git mergerfs snapraid smartmontools samba screen rsync
# 1. Installer Cockpit
apt install -y cockpit udisks2-lvm2
# 2. ACTIVATION VIA SOCKET (Crucial sur Debian 13)
systemctl enable --now cockpit.socket
# 3. Installation MANUELLE des outils 45Drives (Contourne l'erreur 404 du dépôt)
# On télécharge les versions universelles (.deb) directement depuis GitHub
cd /tmp
wget https://github.com/45Drives/cockpit-navigator/releases/download/v0.5.10/cockpit-navigator_0.5.10-1focal_all.deb
wget https://github.com/45Drives/cockpit-file-sharing/releases/download/v3.3.4/cockpit-file-sharing_3.3.4-1focal_all.deb
wget https://github.com/45Drives/cockpit-identities/releases/download/v0.1.12/cockpit-identities_0.1.12-1focal_all.deb
# 4. Installation des paquets téléchargés
apt install -y ./cockpit-*.deb
# Nettoyage
rm cockpit-*.deb
Arrêt : poweroff
🏗️ PHASE 1 : L'ARMÉE DES 33 (DONNÉES)
Objectif : Préparer les 33 disques de stockage.
Matériel : Insérer les 33 disques de données. (Laisser 3 slots vides).
Démarrage : Allumer et se connecter en root.
Repérage des périphériques :
lsblk -d -n -o NAME | grep -v "sda" | xargs
# Copier la liste affichée (ex: sdb sdc ... sdah)
Script de Préparation (Batch) :
Créer le fichier : nano /root/preparer_data.sh
Coller le contenu ci-dessous en modifiant la variable DISQUES :
#!/bin/bash
# --- LISTE SPÉCIFIQUE (33 Disques) ---
# EXCLUT : sdaf (Ton SSD LVM)
# INCLUT : sda->sdae (31) + sdag->sdah (2)
DISQUES="/dev/sda /dev/sdb /dev/sdc /dev/sdd /dev/sde /dev/sdf /dev/sdg /dev/sdh /dev/sdi /dev/sdj /dev/sdk /dev/sdl /dev/sdm /dev/sdn /dev/sdo /dev/sdp /dev/sdq /dev/sdr /dev/sds /dev/sdt /dev/sdu /dev/sdv /dev/sdw /dev/sdx /dev/sdy /dev/sdz /dev/sdaa /dev/sdab /dev/sdac /dev/sdad /dev/sdae /dev/sdag /dev/sdah"
compteur=1
echo "Démarrage du formatage des DONNÉES (XFS)..."
echo "Le disque système (sdaf) est en sécurité."
for disque in $DISQUES; do
label=$(printf "DISK%02d" $compteur)
echo "Traitement : $disque -> Label : $label"
# -f force l'écrasement des anciennes partitions
mkfs.xfs -f -L $label $disque
if [ $? -ne 0 ]; then
echo "ERREUR sur $disque !"
exit 1
fi
((compteur++))
done
echo "Terminé."
Exécution : chmod +x /root/preparer_data.sh && /root/preparer_data.sh
Arrêt : poweroff
🛡️ PHASE 2 : LA GARDE ROYALE (PARITÉ)
Objectif : Ajouter manuellement les 3 disques de protection.
Matériel : Insérer les 3 derniers disques.
Démarrage : Allumer le serveur.
Repérage :
lsblk -o NAME,LABEL
# Repérer les 3 disques SANS label (ex: sdai, sdaj, sdak).
Formatage Manuel : (Remplacer sdX par les vrais identifiants)
mkfs.xfs -f -L PARITY1 /dev/sdX
mkfs.xfs -f -L PARITY2 /dev/sdY
mkfs.xfs -f -L PARITY3 /dev/sdZ
💡 PHASE 3 : IDENTIFICATION PHYSIQUE
Objectif : Identifier visuellement les disques.
#!/bin/bash
if [ -z "$1" ]; then echo "Usage: ./trouver_disque.sh [LABEL]"; exit 1; fi
LABEL=$1
DEV=$(blkid -L "$LABEL")
if [ -z "$DEV" ]; then echo "Introuvable"; exit 1; fi
echo "Fait clignoter $LABEL ($DEV). CTRL+C pour arrêter."
while true; do
dd if="$DEV" of=/dev/null iflag=direct bs=1M count=100 status=none
sleep 0.1
done
Création du Script Lumière : nano /root/trouver_disque.sh
Rendre exécutable : chmod +x /root/trouver_disque.sh
Procédure :
Lancer : ./trouver_disque.sh DISK01
Repérer le caddy qui clignote.
Coller l'étiquette "DISK01".
Faire CTRL+C.
Répéter pour les 36 disques.
⚙️ PHASE 4 : ARCHITECTURE & CONFIGURATION
Objectif : Générer fstab et snapraid.conf automatiquement.
Création du Script Config : nano /root/generer_config.sh
#!/bin/bash
echo "--- Création dossiers ---"
for i in $(seq -w 01 33); do mkdir -p /mnt/disk$i; done
for i in $(seq 1 3); do mkdir -p /mnt/parity$i; done
mkdir -p /mnt/storage
echo "--- Config fstab ---"
cp /etc/fstab /etc/fstab.bak
# Data & Parity
for i in $(seq -w 01 33); do echo "LABEL=DISK$i /mnt/disk$i xfs defaults 0 0" >> /etc/fstab; done
for i in $(seq 1 3); do echo "LABEL=PARITY$i /mnt/parity$i xfs defaults 0 0" >> /etc/fstab; done
# MergerFS
echo "/mnt/disk* /mnt/storage fuse.mergerfs defaults,allow_other,use_ino,cache.files=partial,dropcacheonclose=true,category.create=mfs,minfreespace=100G 0 0" >> /etc/fstab
echo "--- Config SnapRAID ---"
mv /etc/snapraid.conf /etc/snapraid.conf.bak 2>/dev/null
cat <<EOF > /etc/snapraid.conf
parity /mnt/parity1/snapraid.parity
2-parity /mnt/parity2/snapraid.2-parity
3-parity /mnt/parity3/snapraid.3-parity
content /mnt/disk01/snapraid.content
content /mnt/disk02/snapraid.content
content /mnt/disk03/snapraid.content
content /mnt/disk04/snapraid.content
exclude *.unrecoverable
exclude /tmp/
exclude /lost+found/
EOF
for i in $(seq -w 01 33); do
id=$(echo $i | sed 's/^0*//')
echo "data d$id /mnt/disk$i" >> /etc/snapraid.conf
done
Exécution :
chmod +x /root/generer_config.sh
/root/generer_config.sh
mount -a
🩺 PHASE 5 : SCRIPTS DE MAINTENANCE
Objectif : Outils pour la gestion mensuelle.
A. Dashboard de Santé
Fichier : nano /root/check_sante.sh
Bash
#!/bin/bash
printf "%-10s %-10s %-10s %-8s %-15s\n" "LABEL" "DEVICE" "TEMP" "SANTÉ" "MODÈLE"
echo "-------------------------------------------------------------"
for label in $(lsblk -o LABEL -n | grep -E "DISK|PARITY|SSD" | sort); do
dev=$(blkid -L $label)
disk_dev=$(echo $dev | sed 's/[0-9]*$//')
temp=$(smartctl -A $disk_dev | grep -E "^19[04]" | awk '{print $10}')
[ -z "$temp" ] && temp="N/A" || temp="${temp}°C"
health=$(smartctl -H $disk_dev | grep "overall-health" | awk -F: '{print $2}' | xargs)
[ "$health" == "PASSED" ] && color="\e[32mOK\e[0m" || color="\e[31m$health\e[0m"
model=$(smartctl -i $disk_dev | grep "Device Model" | cut -d: -f2 | xargs)
printf "%-10s %-10s %-10s %-16b %-15s\n" "$label" "$disk_dev" "$temp" "$color" "$model"
done
chmod +x /root/check_sante.sh
B. Script Mensuel (Backup)
Fichier : nano /root/maintenance.sh
Bash
#!/bin/bash
LOG="/var/log/snapraid_maintenance.log"
echo "========================================" | tee -a $LOG
echo " MAINTENANCE MENSUELLE - $(date)" | tee -a $LOG
echo "========================================" | tee -a $LOG
# 1. SYNC
echo "" | tee -a $LOG
echo ">>> ÉTAPE 1/3 : SYNC (Mise à jour de la parité)" | tee -a $LOG
echo " Calcul des changements... (Regardez la progression ci-dessous)" | tee -a $LOG
# Le | tee -a permet de voir la barre de progression native de SnapRAID
snapraid sync | tee -a $LOG
# 2. SCRUB
echo "" | tee -a $LOG
echo ">>> ÉTAPE 2/3 : SCRUB (Vérification de 5% des données)" | tee -a $LOG
echo " Recherche d'erreurs (Bitrot)..." | tee -a $LOG
snapraid scrub -p 5 | tee -a $LOG
# 3. SANTÉ
echo "" | tee -a $LOG
echo ">>> ÉTAPE 3/3 : RAPPORT DE SANTÉ (SMART)" | tee -a $LOG
/root/check_sante.sh | tee -a $LOG
echo "" | tee -a $LOG
echo "========================================" | tee -a $LOG
echo " TERMINÉ : $(date)" | tee -a $LOG
echo "========================================" | tee -a $LOG
chmod +x /root/maintenance.sh
Mergefs
1. La méthode "Preuve par les chiffres" (Terminal)
Tape cette commande :
Bash
df -h /mnt/storage
Tu devrais voir une ligne impressionnante avec une taille totale d'environ 198 To (33 disques x 6 To).
2. La méthode "Navigation" (Terminal)
Pour aller dedans et voir tes fichiers, c'est comme n'importe quel dossier :
Bash
cd /mnt/storage
ls -la
Tout ce que tu copieras ici sera automatiquement réparti sur tes disques physiques par MergerFS.
3. La méthode "Visuelle" (Cockpit)
Puisque tu as installé Cockpit + le plugin 45Drives :
Ouvre ton navigateur : https://[TON-IP]:9090
Va dans l'onglet Storage (ou "File Sharing").
Tu devrais voir ton point de montage /mnt/storage apparaître comme un énorme volume unique.
C'est ce dossier /mnt/storage que tu devras partager sur le réseau (SMB/NFS) pour y accéder depuis ton PC Windows ou Mac.
NFS
Rajouter la ligne suivnate:
rw,sync,no_subtree_check,fsid=1

SAMBA
Le partage Samba (SMB) est le standard pour que ton NAS soit visible facilement sous Windows et Mac. C'est souvent plus simple et plus stable que NFS pour un usage domestique.
Voici la procédure pas-à-pas, en utilisant Cockpit (puisque tu as le plugin 45Drives installé) mais avec une petite sécurité en ligne de commande pour le mot de passe.
1. Prérequis : Installer Samba et définir le mot de passe
Même si l'utilisateur pablo existe dans Linux, Samba a sa propre base de données de mots de passe. Il faut l'activer.
Ouvre le Terminal (dans Cockpit ou directement) et tape :
Bash
# 1. Installe Samba (au cas où ce n'est pas fait)
apt install -y samba
# 2. Définit le mot de passe Samba pour pablo
# (Tu peux mettre le même que ton mot de passe Linux)
smbpasswd -a pablo
2. Créer le partage dans Cockpit
Va dans l'onglet File Sharing (partage de fichiers).
Clique sur l'onglet Samba (ou SMB).
Clique sur le bouton "+" (Add Share).
Remplis les cases comme ceci :
Share Name : Stockage (ou Media, c'est le nom que tu verras sous Windows).
Path : /mnt/storage (Ton gros disque MergerFS).
Description : (Optionnel).
Dans les réglages (Settings/Permissions) :
Read Only : Décoché (Non).
Browsable : Coché (Oui).
Guest Access : Décoché (Non, pour la sécurité).
Valid Users : pablo (Si tu veux que tout le monde y accède sans mot de passe, tu peux cocher Guest Access, mais c'est moins sécurisé).
Clique sur Apply ou Save.
3. Accéder depuis Windows
Ouvre ton explorateur de fichiers Windows.
Dans la barre d'adresse en haut, tape : \\192.168.1.50 (Remplace par ton IP si tu l'as changée).
Il va te demander un nom d'utilisateur et un mot de passe.
Utilisateur : pablo
Mot de passe : (Celui que tu as défini avec la commande smbpasswd).
Tu devrais voir ton dossier Stockage.

🚀 PHASE 7 : MIGRATION DES DONNÉES (Rsync)
Objectif : Copier les données de l'ancien serveur (Unraid) vers le nouveau.
Observation : Lors de cette étape, vous verrez les disques s'activer un par un ou en alternance. C'est l'effet du mode "Most Free Space" expliqué en Phase 4. C'est normal et sain.
Préparer les dossiers et les droits :
Lancer une session persistante (Screen) :
Lancer les commandes Rsync (Optimisées) : On utilise --chown pour corriger les droits immédiatement.
Transfert TVShows :
Transfert Anime :
(Raccourcis Screen : CTRL+A puis D pour détacher. screen -r pour revenir).
Vérification finale des droits (Après transfert) :
Bash
chown -R pablo:pablo /mnt/storage/Media
chmod -R 775 /mnt/storage/Media
Bash
rsync -avP --chown=pablo:pablo root@10.10.10.81:/mnt/user/Media/Anime/ /mnt/storage/Media/Anime/
Bash
rsync -avP --chown=pablo:pablo root@10.10.10.81:/mnt/user/Media/TVShows/ /mnt/storage/Media/TVShows/
Bash
screen -S transfert_data
Bash
mkdir -p /mnt/storage/Media/TVShows
mkdir -p /mnt/storage/Media/Anime
chown -R pablo:pablo /mnt/storage/Media
Bash
chmod +x /root/generer_config.sh
/root/generer_config.sh
mount -a
Bash
#!/bin/bash
echo "--- Création dossiers ---"
for i in $(seq -w 01 33); do mkdir -p /mnt/disk$i; done
for i in $(seq 1 3); do mkdir -p /mnt/parity$i; done
mkdir -p /mnt/storage
echo "--- Config fstab ---"
cp /etc/fstab /etc/fstab.bak
# Data & Parity
for i in $(seq -w 01 33); do echo "LABEL=DISK$i /mnt/disk$i xfs defaults 0 0" >> /etc/fstab; done
for i in $(seq 1 3); do echo "LABEL=PARITY$i /mnt/parity$i xfs defaults 0 0" >> /etc/fstab; done
# MergerFS
echo "/mnt/disk* /mnt/storage fuse.mergerfs defaults,allow_other,use_ino,cache.files=partial,dropcacheonclose=true,category.create=mfs,minfreespace=100G 0 0" >> /etc/fstab
echo "--- Config SnapRAID ---"
mv /etc/snapraid.conf /etc/snapraid.conf.bak 2>/dev/null
cat <<EOF > /etc/snapraid.conf
parity /mnt/parity1/snapraid.parity
2-parity /mnt/parity2/snapraid.2-parity
3-parity /mnt/parity3/snapraid.3-parity
content /var/snapraid.content
content /mnt/disk01/snapraid.content
content /mnt/disk02/snapraid.content
exclude *.unrecoverable
exclude /tmp/
exclude /lost+found/
EOF
for i in $(seq -w 01 33); do
id=$(echo $i | sed 's/^0*//')
echo "data d$id /mnt/disk$i" >> /etc/snapraid.conf
done
Bash
#!/bin/bash
if [ -z "$1" ]; then echo "Usage: ./trouver_disque.sh [LABEL]"; exit 1; fi
LABEL=$1
DEV=$(blkid -L "$LABEL")
if [ -z "$DEV" ]; then echo "Introuvable"; exit 1; fi
echo "Fait clignoter $LABEL ($DEV). CTRL+C pour arrêter."
while true; do
dd if="$DEV" of=/dev/null iflag=direct bs=1M count=100 status=none
sleep 0.1
done
Bash
mkfs.xfs -f -L PARITY1 /dev/sdX
mkfs.xfs -f -L PARITY2 /dev/sdY
mkfs.xfs -f -L PARITY3 /dev/sdZ
Bash
lsblk -o NAME,LABEL
# Repérer les 3 disques SANS label (ex: sdai, sdaj, sdak).
Bash
chmod +x /root/preparer_data.sh
/root/preparer_data.sh
Bash
lsblk -d -n -o NAME | grep -v "sda" | xargs
# Copier la liste affichée (ex: sdb sdc ... sdah)
Bash
apt update && apt upgrade -y
apt install -y xfsprogs curl vim git mergerfs snapraid smartmontools
# Cockpit (Version Trixie)
apt install -y cockpit udisks2-lvm2
systemctl enable --now cockpit
# --- ASTUCE DEBIAN 13 pour 45Drives ---
# Le script auto échoue souvent sur Testing. On force l'ajout manuel du repo Bookworm.
wget -qO - https://repo.45drives.com/key/gpg.asc | gpg --dearmor -o /usr/share/keyrings/45drives-archive-keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/45drives-archive-keyring.gpg] https://repo.45drives.com/debian bookworm main" > /etc/apt/sources.list.d/45drives.list
apt update
# Si des dépendances cassent ici, c'est dû à Trixie. Sinon, ça passera :
apt install -y cockpit-navigator cockpit-file-sharing cockpit-identities
Bash
lsblk -f
# Repérer la partition montée sur / (ex: sda2 ou nvme0n1p2)