Sauvegarder un partage réseau

Ce que fait la fonction

Un agent BaaStide lit un partage SMB ou NFS d'un NAS ou d'un serveur de fichiers, et il le sauvegarde dans le dépôt de sa machine. Rien n'est installé sur le NAS.

Vous déclarez le partage sur l'agent, avec son adresse et son compte. Vous l'ajoutez ensuite à une politique de fichiers. L'agent se connecte au partage seulement pendant une sauvegarde, une restauration ou un test.

Un partage porte un nom court. Ce nom court fait partie des chemins des points de restauration : /@shares/<nom court>/…. Il ne change jamais. L'adresse du serveur, elle, peut changer : les chemins des points de restauration restent les mêmes.

Prérequis

• Une machine avec un agent enrôlé, en version 0.5.0 ou plus récente. Voir Versions d'agent minimales par fonction.
• Le rôle Technicien ou Administrateur. Le rôle Lecture seule voit la liste des partages sans la changer. Voir Rôles et droits.
• Un agent en ligne pour tester un partage.
• Sur le NAS : un compte de service réservé à BaaStide, qui peut lire tout le partage.
• Pour l'API : une clé API avec la portée operate.

Le protocole dépend du système de la machine.

Système de l'agent	Protocoles lus
Linux	SMB et NFS
Windows	SMB seulement

Un agent Windows ne lit pas un export NFS. Sauvegardez ce NAS en SMB depuis Windows, ou en NFS depuis un agent Linux.

Ce que le NAS doit permettre

Protocole	Ce que le NAS doit donner	Ce qui arrive sinon
SMB	SMB 3 au moins, sur le port 445.	share_unsupported
SMB	Une connexion signée, ou chiffrée.	share_signing_unavailable
SMB	Un compte qui lit tous les fichiers du partage.	Une erreur par fichier illisible
NFS	Un export v4.1, v4.0 ou v3, sur le port 2049.	share_unsupported
NFS	L'accès root pour l'adresse de l'agent (no_root_squash).	Les fichiers privés ne sont pas lus

Sur un Synology, le réglage « Signature du serveur : Forcer » répond à la ligne de la signature. Le réglage « Mappage : Aucun mappage » d'un export NFS répond à la ligne de l'accès root.

Un export NFS passe les données en clair sur le réseau, et le NAS fait confiance à l'adresse de l'agent. Le portail l'écrit sous le formulaire. Sur un réseau qui n'est pas sûr, utilisez SMB avec le chiffrement.

Déclarer un partage SMB

1. Ouvrez le portail.
2. Ouvrez Endpoints, puis la machine.
3. Ouvrez l'onglet Partages réseau.
4. Cliquez Ajouter un partage.
5. Gardez le Protocole SMB.
6. Collez l'Adresse du partage. Le portail accepte \\nas\compta, \\nas\compta\dossier et smb://nas/compta. Il écrit sous le champ ce qu'il a lu : « Serveur : nas · Partage : compta ».
7. Vérifiez le Nom affiché. Le portail propose le nom du partage. Ce nom reste modifiable, de 1 à 100 caractères.
8. Vérifiez le Nom court. Le portail en propose un. Il accepte 1 à 32 caractères : lettres minuscules, chiffres et -. Le premier caractère n'est pas -. Après l'ajout, ce nom ne change plus.
9. Saisissez le Nom d'utilisateur du compte du NAS, de 1 à 256 caractères, sans ,, sans = et sans caractère de contrôle.
10. Saisissez le Domaine ou groupe de travail, ou laissez le champ vide.
11. Saisissez le Mot de passe, de 1 à 256 caractères.
12. Cochez Exiger le chiffrement SMB quand le réseau n'est pas sûr. Sans cette option, l'agent exige au moins une connexion signée.
13. Cliquez Tester, puis lisez le résultat. Voir Tester un partage.
14. Cliquez Ajouter le partage.

Le partage apparaît dans la liste de l'onglet, avec son nom, son nom court, son protocole, son adresse, son compte et la date du dernier changement d'identifiants.

Un agent ne porte qu'un seul compte par serveur. Un deuxième partage du même agent vers le même serveur avec un autre compte est refusé : le client Windows ne permet pas deux comptes vers un même serveur dans une session. Utilisez le même compte pour tous les partages d'un serveur.

Déclarer un partage NFS

Un export NFS se déclare sur un agent Linux. Il ne demande ni compte ni mot de passe.

1. Ouvrez l'onglet Partages réseau de la machine.
2. Cliquez Ajouter un partage.
3. Choisissez le Protocole NFS.
4. Collez l'Adresse de l'export. Le portail accepte nas:/volume1/data et nfs://nas/volume1/data.
5. Vérifiez le Nom affiché et le Nom court.
6. Choisissez la Version NFS : NFS 4.1, NFS 4.0 ou NFS 3. La valeur proposée est 4.1.
7. Lisez l'avertissement sur les données en clair.
8. Cliquez Tester, puis lisez le résultat.
9. Cliquez Ajouter le partage.

Sur un agent Windows, le choix NFS n'est pas proposé. Le portail écrit « NFS n'est pas disponible sur un agent Windows. Utilisez SMB, ou sauvegardez l'export NFS depuis un agent Linux. »

Tester un partage

Le bouton Tester demande à l'agent de se connecter au partage et de lire son dossier racine. Le test prend au plus 30 secondes. Il ne lit aucun fichier et il ne garde aucun nom de fichier.

1. Ouvrez le formulaire d'ajout ou de modification d'un partage.
2. Vérifiez l'adresse, le compte et les options.
3. Cliquez Tester.
4. Lisez le résultat.

Résultat	Ce que vous faites
« Partage accessible, 12 entrées à la racine. »	Enregistrez le partage.
« Le NAS donne à root un accès limité à cet export (root_squash)… »	Donnez l'accès root à l'adresse de l'agent sur le NAS.
Un message d'erreur de partage	Corrigez la cause, puis testez de nouveau. Voir Causes des partages réseau.

Le test compte au plus 1 000 entrées à la racine.

Le bouton est grisé quand l'agent est hors ligne. Le portail écrit alors « L'agent est hors ligne : le test n'est pas possible. »

Le test est limité à un appel toutes les 10 secondes, et à 20 appels par heure et par machine. Au-delà, le portail écrit « Réessayez dans », suivi d'un nombre de secondes.

Un test sur une adresse ou un compte différents de ceux enregistrés demande le mot de passe. Le portail écrit « Pour tester ces valeurs, tapez le mot de passe. »

Ajouter un partage à une politique

Un partage ne se sauvegarde pas tout seul. Il entre dans une politique de fichiers de la même machine. Voir Politique de sauvegarde de fichiers.

1. Ouvrez l'onglet Politiques de la machine.
2. Ouvrez la politique de fichiers, ou créez-la.
3. Cliquez Ajouter un partage, sous le champ Chemins.
4. Choisissez le partage dans la liste. Chaque ligne donne le nom et l'adresse du partage.
5. Pour ne sauvegarder qu'un dossier du partage, saisissez son chemin dans Dossier du partage (facultatif), par exemple Factures/2026. Un champ vide prend tout le partage.
6. Lisez le chemin que le portail écrit sous le champ, par exemple /@shares/compta/Factures/2026.
7. Cliquez Ajouter à la politique.
8. Vérifiez le champ Chemins et le champ Exclus.
9. Cliquez Enregistrer ou Créer la politique.

Le portail ajoute quatre exclusions avec le partage :

Exclusion ajoutée	Ce qu'elle laisse de côté
/@shares/<nom court>/**/#snapshot	Les dossiers de snapshots du NAS
/@shares/<nom court>/**/.snapshot	Les dossiers de snapshots du NAS
/@shares/<nom court>/**/~snapshot	Les dossiers de snapshots du NAS
/@shares/<nom court>/**/@eaDir	Les fichiers techniques Synology

Sans ces exclusions, chaque sauvegarde lirait toutes les copies gardées par le NAS. Vous pouvez les retirer.

Quand la machine n'a encore aucun partage, la fenêtre écrit « Cet agent n'a encore aucun partage réseau. » et propose Ajouter un partage à l'agent.

Un chemin écrit directement en UNC (\\nas\compta), en smb://, en nfs:// ou en nas:/export est refusé dans une politique. Déclarez toujours le partage d'abord.

Changer l'adresse, le compte ou les options

1. Ouvrez l'onglet Partages réseau de la machine.
2. Cliquez Modifier sur la ligne du partage.
3. Changez les champs.
4. Cliquez Enregistrer.

Le Nom court et le Protocole ne changent pas. Le portail écrit « Le nom court ne peut pas changer : il fait partie des chemins des points de restauration. »

Le mot de passe enregistré suit l'adresse et le compte :

• Quand vous changez l'adresse, le partage, le nom d'utilisateur ou le domaine, le mot de passe devient obligatoire. Le portail écrit « L'adresse ou le compte a changé : tapez de nouveau le mot de passe. »
• Quand vous changez seulement le nom affiché ou les options, laissez le champ vide. Le portail écrit « Vide : le mot de passe enregistré ne change pas. Le mot de passe n'est jamais affiché. »

Pour changer le mot de passe du compte, changez-le d'abord sur le NAS, puis dans le portail. Entre les deux, une sauvegarde du partage échoue avec share_auth_failed.

Un changement d'adresse garde les points de restauration et le lien avec la sauvegarde précédente : les chemins ne dépendent pas du serveur.

Retirer un partage

1. Ouvrez l'onglet Partages réseau de la machine.
2. Cliquez Supprimer sur la ligne du partage.
3. Lisez la fenêtre de confirmation : « Les données sauvegardées de ce partage restent dans le dépôt. Le nom court », suivi du nom court, « ne pourra plus être utilisé sur cet agent. »
4. Cliquez Supprimer le partage.

Un partage utilisé par une politique de la machine, ou lu par une sauvegarde en cours, n'est pas supprimé. Retirez d'abord son chemin de la politique, ou attendez la fin de la sauvegarde.

La suppression ne touche pas aux points de restauration. Le nom court du partage supprimé ne sert plus jamais sur cette machine.

Déclarer un partage par l'API

1. Appelez POST /endpoints/{id}/shares. L'identifiant du chemin est celui de la machine.
2. Donnez key, label, protocol, host et share.
3. Pour un partage SMB, donnez aussi username, domain, password et options.
4. Pour un export NFS, donnez options avec la version.
5. Lisez la réponse 201. Elle ne porte jamais le mot de passe : elle donne has_password et credential_updated_at.
6. Ajoutez ensuite le chemin /@shares/<nom court> aux chemins de la politique.

L'API ne rend jamais un mot de passe de partage, ni dans une réponse, ni dans le journal d'audit.

Limites et précautions

• Une machine porte au plus 32 partages.
• Un agent Windows ne lit pas un export NFS.
• L'agent lit un partage avec le compte que vous donnez. Ce compte doit lire tous les fichiers du partage. Un fichier illisible donne une erreur par fichier, et la tâche finit en Partielle.
• Un partage que l'agent ne peut pas atteindre est sauté. Les autres sources de la même tâche sont sauvegardées, et la tâche finit en Partielle. Quand aucune source n'est lisible, la tâche finit en Échec.
• Une erreur de partage ouvre l'alerte Partage injoignable. Elle se ferme à la première sauvegarde qui lit de nouveau le partage. Voir Alertes.
• Il n'y a pas d'instantané sur un partage. Un fichier modifié pendant sa lecture peut partir dans un état mélangé, comme un fichier local sans instantané.
• Un fichier qu'un autre client du NAS garde ouvert sans partage de lecture donne une erreur par fichier.
• Les droits gardés dépendent du couple système et protocole :

Cas	Gardé dans le point de restauration	Non gardé
Agent Windows, partage SMB	Le contenu, les dates, les attributs, le propriétaire, le groupe et les droits d'accès (ACL) du serveur.	L'audit (SACL).
Agent Linux, export NFS	Le contenu, les dates, le propriétaire, le groupe et le mode.	Les ACL NFSv4 et les ACL POSIX.
Agent Linux, partage SMB	Le contenu et les dates.	Les ACL NTFS. Le propriétaire, le groupe et le mode n'ont aucune valeur utile.

Pour garder les ACL d'un partage Windows ou Synology, sauvegardez-le depuis un agent Windows.

• Sur un partage SMB, l'agent relit un fichier quand sa taille ou sa date change. Un fichier remplacé par un autre de même taille et de même date n'est pas relu.
• Un NAS qui s'arrête pendant une sauvegarde donne une erreur après quelques dizaines de secondes. L'agent arrête alors de lire ce partage et continue les autres sources.
• Sur une machine Linux, le noyau doit porter les systèmes de fichiers cifs et nfs. Quand ils sont absents, la tâche porte le code share_unsupported et le message nomme le module à installer. Aucun autre paquet n'est nécessaire.
• Sur une machine Windows, l'agent avertit quand SMB 1 est actif sur la machine (share_smb1_enabled). La sauvegarde n'est pas bloquée. L'agent n'utilise jamais SMB 1.
• Un administrateur de la machine peut couper les partages réseau sur place, avec shares à false dans le fichier d'identité de l'agent (/etc/baastide/agent.conf sur Linux, %ProgramData%\BaaStide\agent.conf sur Windows). L'agent répond alors shares_disabled à tout ordre qui touche un partage, et la tâche finit en Échec. L'agent relit ce réglage à chaque ordre : aucun redémarrage n'est nécessaire. La plateforme ne change pas ce réglage.
• Le chemin /run/baastide est réservé à l'agent. Une politique qui le contient est refusée.
• Sur une machine Linux qui porte un vrai dossier /@shares, une sauvegarde de / laisse ce dossier de côté et la tâche porte l'avertissement local_shares_dir_excluded.
• Après un changement de la liste des chemins d'une politique, la sauvegarde suivante relit tous les fichiers. Elle ne les renvoie pas : les données déjà dans le dépôt ne repartent pas sur le réseau.
• Le mot de passe d'un partage n'est jamais affiché, ni rendu par l'API, ni écrit dans un journal. Le journal d'audit garde la création, la modification, la suppression et le test d'un partage, sans le mot de passe. Voir Journal d'audit.
• La plateforme garde les mots de passe des partages chiffrés avec une clé de l'instance. Quand cette clé est perdue, saisissez de nouveau les mots de passe.
• Un partage ne se parcourt pas depuis le formulaire de la politique. Saisissez le dossier voulu.

Référence

• API : List agent shares, Create agent share, Update agent share, Delete agent share et Check agent share.
• Codes de cause : Causes des partages réseau.
• Pour rendre les fichiers d'un point de restauration sur un partage, voir Restaurer sur un partage réseau.