Introduction

Dans cet article, je vous montre comment accéder aux datasets de mon serveur TrueNAS depuis un PC Linux en utilisant le protocole NFS.

L’objectif est de monter proprement plusieurs partages TrueNAS dans le dossier /mnt/tn230/ du PC Linux, afin de pouvoir accéder facilement aux fichiers du NAS comme s’ils étaient présents localement.

Cette méthode est particulièrement pratique pour accéder à ses sauvegardes, documents, images, musiques ou vidéos depuis un poste Linux, tout en conservant le stockage centralisé sur TrueNAS.

Objectif

Le but est de monter les datasets TrueNAS suivants :

/mnt/raid1/backup
/mnt/raid1/document
/mnt/raid1/media/images
/mnt/raid1/media/musique
/mnt/raid1/media/video

vers les dossiers locaux suivants sur le PC Linux :

/mnt/tn230/backup
/mnt/tn230/documents
/mnt/tn230/images
/mnt/tn230/musique
/mnt/tn230/video

Dans mon exemple, l’adresse IP du NAS TrueNAS est :

192.168.0.230

À adapter bien sûr selon votre propre installation.

Prérequis côté TrueNAS

Avant de configurer le PC Linux, il faut vérifier que les partages NFS sont bien activés côté TrueNAS.

Dans l’interface TrueNAS, vérifiez que :

• le service NFS est activé ;
• les datasets à partager existent bien ;
• les partages NFS sont créés ;
• l’adresse IP du PC Linux est autorisée à accéder aux partages ;
• les permissions Unix ou ACL permettent bien l’accès aux fichiers.

Exemple de datasets côté TrueNAS :

/mnt/raid1/backup
/mnt/raid1/document
/mnt/raid1/media/images
/mnt/raid1/media/musique
/mnt/raid1/media/video

Si les permissions ne sont pas correctement configurées côté TrueNAS, le montage peut fonctionner, mais l’accès aux fichiers peut être refusé.

C’est souvent le cas lorsque le montage est visible mais que la création, la modification ou la suppression de fichiers échoue.

Installer le client NFS sur le PC Linux

Sur le PC Linux, commencez par installer le client NFS.

Pour une distribution basée sur Debian, Ubuntu ou Linux Mint :

sudo apt update
sudo apt install nfs-common

La commande suivante est possible, mais je préfère éviter de mélanger installation et mise à jour complète du système dans un tutoriel :

sudo apt update && sudo apt upgrade

La mise à jour complète avec apt upgrade reste facultative ici. Pour monter un partage NFS, le paquet important est surtout :

nfs-common

Vérifier les partages NFS disponibles

Depuis le PC Linux, vérifiez les exports NFS visibles sur le NAS :

showmount -e 192.168.0.230

Vous devriez obtenir une sortie ressemblant à ceci :

Export list for 192.168.0.230:
/mnt/raid1/backup        192.168.0.0/24
/mnt/raid1/document      192.168.0.0/24
/mnt/raid1/media/images  192.168.0.0/24
/mnt/raid1/media/musique 192.168.0.0/24
/mnt/raid1/media/video   192.168.0.0/24

Si rien ne s’affiche, il faut vérifier côté TrueNAS :

• que le service NFS est démarré ;
• que les partages sont bien créés ;
• que l’adresse IP du PC est autorisée ;
• qu’aucun pare-feu ne bloque l’accès.

Créer les dossiers de montage

Sur le PC Linux, créez les dossiers qui recevront les montages NFS.

sudo mkdir -p /mnt/tn230/backup
sudo mkdir -p /mnt/tn230/documents
sudo mkdir -p /mnt/tn230/images
sudo mkdir -p /mnt/tn230/musique
sudo mkdir -p /mnt/tn230/video

On peut vérifier la création des dossiers avec :

ls -l /mnt/tn230

Tester les montages manuellement

Avant de modifier le fichier /etc/fstab, il est préférable de tester les montages manuellement.

sudo mount -t nfs 192.168.0.230:/mnt/raid1/backup /mnt/tn230/backup
sudo mount -t nfs 192.168.0.230:/mnt/raid1/document /mnt/tn230/documents
sudo mount -t nfs 192.168.0.230:/mnt/raid1/media/images /mnt/tn230/images
sudo mount -t nfs 192.168.0.230:/mnt/raid1/media/musique /mnt/tn230/musique
sudo mount -t nfs 192.168.0.230:/mnt/raid1/media/video /mnt/tn230/video

Vérifiez ensuite que les montages sont actifs :

df -h | grep tn230

ou :

findmnt | grep tn230

Vous pouvez aussi tester l’accès à un dossier :

ls -l /mnt/tn230/documents

Si les fichiers apparaissent, le montage fonctionne.

Tester les droits d’écriture

Si le partage doit être accessible en écriture, testez la création d’un fichier :

touch /mnt/tn230/documents/test-nfs.txt

Puis supprimez-le :

rm /mnt/tn230/documents/test-nfs.txt

Si cette commande échoue avec une erreur de permission, le problème ne vient pas forcément du montage Linux.

Il faut alors contrôler côté TrueNAS :

• le propriétaire du dataset ;
• le groupe associé ;
• les ACL ;
• le mapping utilisateur ;
• les options du partage NFS ;
• les UID/GID entre TrueNAS et le PC Linux.

Sur NFS, les droits dépendent beaucoup des identifiants numériques des utilisateurs et groupes. Deux utilisateurs ayant le même nom mais pas le même UID peuvent ne pas avoir les mêmes droits.

Démonter les partages de test

Avant de passer à la configuration permanente, vous pouvez démonter les partages montés manuellement :

sudo umount /mnt/tn230/backup
sudo umount /mnt/tn230/documents
sudo umount /mnt/tn230/images
sudo umount /mnt/tn230/musique
sudo umount /mnt/tn230/video

Si un dossier refuse de se démonter parce qu’il est occupé, vérifiez qu’aucun terminal ou gestionnaire de fichiers n’est ouvert dedans.

Vous pouvez identifier les processus qui utilisent un montage avec :

sudo lsof +f -- /mnt/tn230/documents

ou :

sudo fuser -vm /mnt/tn230/documents

Ajouter les montages permanents

Pour rendre les montages automatiques au démarrage, éditez le fichier /etc/fstab.

sudo nano /etc/fstab

Ajoutez les lignes suivantes :

192.168.0.230:/mnt/raid1/backup         /mnt/tn230/backup      nfs4  _netdev,nofail,x-systemd.automount,x-systemd.idle-timeout=60,noatime  0  0
192.168.0.230:/mnt/raid1/document       /mnt/tn230/documents   nfs4  _netdev,nofail,x-systemd.automount,x-systemd.idle-timeout=60,noatime  0  0
192.168.0.230:/mnt/raid1/media/images   /mnt/tn230/images      nfs4  _netdev,nofail,x-systemd.automount,x-systemd.idle-timeout=60,noatime  0  0
192.168.0.230:/mnt/raid1/media/musique  /mnt/tn230/musique     nfs4  _netdev,nofail,x-systemd.automount,x-systemd.idle-timeout=60,noatime  0  0
192.168.0.230:/mnt/raid1/media/video    /mnt/tn230/video       nfs4  _netdev,nofail,x-systemd.automount,x-systemd.idle-timeout=60,noatime  0  0

Les options utilisées ont leur importance :

_netdev

Indique que le montage dépend du réseau.

nofail

Évite de bloquer le démarrage du PC si le NAS est éteint ou inaccessible.

x-systemd.automount

Active le montage automatique à la demande. Le partage n’est réellement monté que lorsqu’on y accède.

x-systemd.idle-timeout=60

Démonte automatiquement le partage après 60 secondes d’inactivité.

noatime

Évite de mettre à jour la date d’accès des fichiers à chaque lecture, ce qui limite les écritures inutiles.

Recharger systemd et activer les montages

Après modification de /etc/fstab, rechargez systemd :

sudo systemctl daemon-reload

Puis testez la configuration :

sudo mount -a

Avec x-systemd.automount, il est possible que les dossiers ne soient pas montés immédiatement. Ils se monteront automatiquement au premier accès.

Par exemple :

ls /mnt/tn230/documents

Vérifier les montages actifs

Pour afficher les montages NFS actifs :

nfsstat -m

Vous pouvez aussi utiliser :

findmnt -t nfs,nfs4

ou :

mount | grep nfs

Pour vérifier l’espace disponible :

df -h | grep tn230

Vérifier le fonctionnement de l’automount

Avec l’option x-systemd.automount, systemd crée des unités de montage automatique.

Vous pouvez les afficher avec :

systemctl list-units --type=automount | grep tn230

Pour vérifier un montage précis :

systemctl status mnt-tn230-documents.automount

Le nom de l’unité dépend du chemin local. Par exemple :

/mnt/tn230/documents

devient généralement :

mnt-tn230-documents.automount

Démonter les partages NFS si besoin

Pour démonter un partage précis :

sudo umount /mnt/tn230/documents

Pour démonter tous les partages NFS actifs :

sudo umount -a -t nfs,nfs4

Si un montage est occupé, utilisez :

sudo fuser -vm /mnt/tn230/documents

Puis fermez les applications qui utilisent ce dossier.

En dernier recours, il existe le démontage paresseux :

sudo umount -l /mnt/tn230/documents

Cette commande est pratique, mais elle doit rester exceptionnelle.

Résoudre les erreurs courantes

Erreur access denied by server

Cette erreur indique généralement que le PC Linux n’est pas autorisé à accéder au partage NFS.

À vérifier côté TrueNAS :

• l’adresse IP du client ;
• le réseau autorisé, par exemple 192.168.0.0/24 ;
• les options du partage NFS ;
• le service NFS ;
• le chemin exact du dataset.

Erreur permission denied

Le montage fonctionne, mais les droits d’accès aux fichiers sont insuffisants.

À vérifier :

• propriétaire du dataset ;
• groupe du dataset ;
• ACL TrueNAS ;
• UID/GID de l’utilisateur Linux ;
• droits Unix sur les dossiers.

Pour voir l’UID et le GID de l’utilisateur Linux :

id

Exemple :

uid=1000(remy) gid=1000(remy)

Ces valeurs peuvent être importantes pour aligner les permissions côté TrueNAS.

Le PC bloque au démarrage

Si le PC met longtemps à démarrer ou reste bloqué lorsque le NAS est éteint, il manque probablement des options dans /etc/fstab.

Assurez-vous d’avoir au minimum :

_netdev,nofail,x-systemd.automount

Ces options évitent que le démarrage du PC dépende directement de la disponibilité du NAS.

Les dossiers semblent vides

Si les dossiers de /mnt/tn230/ sont vides, plusieurs causes sont possibles :

• le partage n’est pas monté ;
• le NAS est inaccessible ;
• le chemin du dataset est incorrect ;
• l’automount ne s’est pas encore déclenché ;
• les droits ne permettent pas de lister le contenu.

Testez avec :

findmnt -t nfs,nfs4
ls -l /mnt/tn230/documents
showmount -e 192.168.0.230

Exemple de configuration complète

Voici un exemple final propre pour /etc/fstab :

# TrueNAS 192.168.0.230 - Montages NFS
192.168.0.230:/mnt/raid1/backup         /mnt/tn230/backup      nfs4  _netdev,nofail,x-systemd.automount,x-systemd.idle-timeout=60,noatime  0  0
192.168.0.230:/mnt/raid1/document       /mnt/tn230/documents   nfs4  _netdev,nofail,x-systemd.automount,x-systemd.idle-timeout=60,noatime  0  0
192.168.0.230:/mnt/raid1/media/images   /mnt/tn230/images      nfs4  _netdev,nofail,x-systemd.automount,x-systemd.idle-timeout=60,noatime  0  0
192.168.0.230:/mnt/raid1/media/musique  /mnt/tn230/musique     nfs4  _netdev,nofail,x-systemd.automount,x-systemd.idle-timeout=60,noatime  0  0
192.168.0.230:/mnt/raid1/media/video    /mnt/tn230/video       nfs4  _netdev,nofail,x-systemd.automount,x-systemd.idle-timeout=60,noatime  0  0

Bonnes pratiques

Quelques conseils utiles :

• testez toujours un montage manuel avant de modifier /etc/fstab ;
• ajoutez nofail pour éviter les blocages au démarrage ;
• utilisez x-systemd.automount pour monter les partages uniquement à la demande ;
• évitez de monter des partages réseau critiques sans option _netdev ;
• vérifiez les droits côté TrueNAS avant d’accuser le client Linux ;
• gardez une nomenclature claire pour vos points de montage ;
• documentez les chemins TrueNAS et les chemins locaux.

Dans mon cas, j’utilise le dossier local :

/mnt/tn230/

pour identifier facilement les montages issus du NAS TrueNAS situé en 192.168.0.230.

Conclusion

Le PC Linux peut maintenant accéder proprement aux datasets TrueNAS via NFS.

Les montages sont déclarés dans /etc/fstab, mais grâce à x-systemd.automount, ils ne sont activés que lorsqu’on y accède réellement. C’est une solution plus souple et plus fiable qu’un montage réseau classique au démarrage.

Cette configuration permet de profiter du stockage centralisé TrueNAS tout en gardant un accès simple depuis Linux pour les sauvegardes, les documents, les images, la musique ou les vidéos.