Pour la plupart des utilisateurs de NAS domestiques et de serveurs auto-hébergés, la meilleure option par défaut est une sauvegarde logique native de la base de données, créée pendant que celle-ci est en cours d’exécution, suivie d’une sauvegarde classique du dump avec la configuration du conteneur et les fichiers de l’application. Utilisez une copie rapide du conteneur arrêté si une interruption de service est acceptable, et un instantané coordonné du système de fichiers uniquement lorsque la base de données a été vidée, verrouillée, soumise à un point de contrôle ou préparée d’une autre manière pour l’instantané. Une simple copie d’un volume de base de données en cours d’utilisation n’est pas une méthode de sauvegarde cohérente.
Définir « cohérente » comme une restauration acceptée par la base de données
Une sauvegarde cohérente ne se résume pas à une arborescence de dossiers complète. Après la restauration, le moteur de base de données doit démarrer, récupérer correctement les transactions, réussir les contrôles d’intégrité et présenter un état à un instant donné que l’application peut utiliser. Sur un serveur domestique exécutant Immich, Nextcloud, Paperless-ngx, Home Assistant ou une autre application auto-hébergée, cela signifie que la base de données, les fichiers importés, la configuration et les secrets doivent être cohérents entre eux.
La persistance des conteneurs indique uniquement où se trouvent les fichiers. Elle ne permet pas de copier une base de données en cours d’exécution en toute sécurité. Une base de données peut avoir des transactions actives, des pages en cache, des journaux d’écriture anticipée, des fichiers temporaires ou des métadonnées qui changent pendant que le logiciel de sauvegarde du NAS lit le volume.
Méthode 1 : utiliser un dump logique natif de la base de données par défaut sur un NAS domestique
Un dump logique demande au moteur de base de données d’exporter une représentation cohérente des schémas et des enregistrements. Pour un conteneur PostgreSQL ou MariaDB de taille modeste sur un NAS familial, c’est généralement la méthode la plus simple à planifier, à examiner, à copier vers un emplacement distant et à restaurer dans un conteneur de remplacement vierge. Un guide récent sur la sauvegarde Docker présente cette méthode en exécutant des dumps natifs de la base de données depuis un conteneur de sauvegarde planifié.
Enregistrez le dump dans un répertoire de sauvegarde dédié, en dehors du volume de données en production. Configurez ensuite la tâche de sauvegarde du NAS pour protéger le dump, le fichier Compose, le modèle de variables d’environnement, la configuration de l’application et les données importées. N’exposez pas les mots de passe de production dans le nom du fichier dump ni dans des journaux non protégés.
| Base de données | Configuration par défaut pour un serveur domestique | Éléments à inclure dans la tâche de sauvegarde |
|---|---|---|
| PostgreSQL | Dump logique natif ou outil physique natif de la base de données | Dump, rôles ou paramètres globaux si nécessaire, fichier Compose, variables d’environnement, fichiers de l’application |
| MariaDB/MySQL | Dump logique natif avec des options de transaction cohérente | Dump SQL, utilisateurs ou droits si nécessaire, fichier Compose, secrets, fichiers de l’application |
| SQLite | Sauvegarde de l’application, sauvegarde à chaud de SQLite ou copie propre après arrêt | Copie cohérente de la base de données avec la configuration de l’application et les pièces jointes |
Méthode 2 : arrêter brièvement la base de données avant de copier son volume
La copie d’un conteneur arrêté est simple et complète sur le plan physique. Arrêtez d’abord les processus d’écriture de l’application, arrêtez proprement la base de données, vérifiez que le processus est terminé, copiez l’intégralité du volume persistant ou du répertoire de base de données monté sur l’hôte, puis redémarrez la pile. Un guide Docker et MariaDB décrit les copies de volumes physiques comme étant rapides, mais dépendantes de la version et généralement associées à une interruption de service.
Cette méthode convient bien à un petit NAS domestique où quelques minutes de maintenance sont acceptables et où la restauration utilisera une version de base de données compatible. Elle est moins portable qu’un export logique et peut prolonger l’interruption de service lorsque le volume est important. Conservez l’étiquette de l’image de la base de données et la disposition du stockage avec la sauvegarde afin de ne pas restaurer des fichiers physiques dans une version incompatible du moteur.
Méthode 3 : coordonner un instantané rapide avec la base de données
ZFS, Btrfs, LVM et les systèmes d’instantanés NAS peuvent capturer rapidement un grand volume de base de données, mais l’instantané doit être coordonné avec la base de données. Pour MariaDB ou MySQL, cela peut nécessiter une courte période de verrouillage ou de vidage ; pour PostgreSQL, le processus de sauvegarde ou de point de contrôle pris en charge par la base de données ; pour une base de données gérée par l’application, un hook avant l’instantané.
Une discussion sur les instantanés de bases de données explique que une copie du disque en cours d’utilisation peut être incohérente en interne, sauf si la base de données est figée ou si l’instantané est pris de manière atomique. La période de verrouillage ou de mise au repos doit être courte : préparer la base de données, créer l’instantané, autoriser à nouveau les écritures, puis copier l’instantané ultérieurement.
Cette méthode est utile lorsque la base de données est trop volumineuse pour des exports logiques fréquents ou lorsque vous avez besoin d’un intervalle de point de récupération plus court. Elle nécessite des scripts et des tests de restauration plus rigoureux qu’une procédure de sauvegarde classique pour un serveur domestique.
Ne considérez pas l’image Docker ni l’export du conteneur comme une sauvegarde de base de données
L’image du conteneur contient l’environnement d’exécution de l’application, mais pas nécessairement les données persistantes actives. L’export ou la validation du conteneur peut omettre les volumes nommés et ne demande pas à la base de données de créer un point de récupération cohérent. Un guide de sauvegarde des conteneurs PostgreSQL conclut que docker save et la validation ne remplacent pas les techniques de sauvegarde propres à PostgreSQL.
Sur un serveur domestique ZimaOS ou Docker, séparez la définition du déploiement du plan de protection des données : conservez les fichiers Compose et les balises d’image pour pouvoir reconstruire le service, et protégez la base de données avec une méthode qui en garantit la cohérence afin de pouvoir restaurer son état.
Ne copiez jamais simplement un volume de base de données en cours d’écriture
Un logiciel de sauvegarde de NAS peut lire différents fichiers de la base de données à des moments différents. L’archive obtenue peut contenir un fichier de données correspondant à l’état d’une transaction, un journal correspondant à un autre et des métadonnées correspondant à un troisième. Un aperçu des méthodes de sauvegarde SQL open source avertit qu’une base de données en cours d’utilisation peut être capturée à un instant incohérent, alors que des données importantes se trouvent encore en mémoire.
La récupération après un plantage peut réparer certains instantanés capturés de manière atomique, mais une simple copie récursive de fichiers n’est pas atomique. Si l’application ne peut pas tolérer une interruption de service, utilisez une exportation logique, un outil de sauvegarde physique pris en charge ou un instantané coordonné.
Traitez les conteneurs SQLite comme des bases de données, pas comme des fichiers ordinaires
De nombreuses applications pour serveur domestique utilisent SQLite, car cette solution est compacte et facile à déployer. Le risque est que les administrateurs voient un fichier .db et supposent qu’ils peuvent le copier pendant que l’application écrit des données. En mode WAL, les modifications récentes validées peuvent encore se trouver en dehors du fichier principal. Un article pratique sur la récupération de SQLite recommande d’utiliser le mécanisme de sauvegarde en ligne ou de faire une copie après l’arrêt propre de l’application, plutôt que de copier un fichier de base de données en cours d’utilisation.
Utilisez la fonction de sauvegarde intégrée de l’application, si elle en possède une. Sinon, utilisez la fonction de sauvegarde en ligne de SQLite ou arrêtez proprement l’application avant de copier l’ensemble du répertoire de la base de données. Ne copiez pas uniquement le fichier principal de la base de données en laissant derrière son journal ou son état WAL.
Choisissez la méthode selon l’interruption de service, la taille de la base de données et la portabilité de la restauration
| Cas d’un NAS domestique | Meilleure méthode pour commencer | Principal compromis |
|---|---|---|
| Petite base de données, sauvegarde quotidienne, migration facile | Exportation logique | Durée d’exportation plus longue à mesure que la base de données grossit |
| Petite base de données, fenêtre de maintenance disponible | Arrêt propre et copie du volume physique | Nécessite une interruption de service et une compatibilité des versions |
| Base de données volumineuse, fenêtre de sauvegarde courte | Instantané coordonné avec la base de données ou sauvegarde physique native | Hooks, politiques de rétention et tests de restauration plus complexes |
| Application SQLite avec fonction d’exportation intégrée | Exportation de l’application ou sauvegarde en ligne de SQLite | Une automatisation propre à l’application peut être nécessaire |
| Application de gestion de médias ou de documents avec base de données et fichiers téléversés | Sauvegarde cohérente de la base de données et sauvegarde synchronisée des fichiers | Les horodatages de la base de données et des fichiers doivent correspondre à la même fenêtre de récupération |
Sauvegardez l’application auto-hébergée entière, pas seulement la base de données
Un ensemble de récupération utilisable doit inclure la sauvegarde de la base de données, le fichier Docker Compose, les versions des images, les variables d’environnement ou un paquet de secrets récupérable, les paramètres du proxy inverse, la configuration de l’application, les fichiers téléversés et toutes les clés de chiffrement. La sauvegarde du seul export SQL peut restaurer les enregistrements, mais laisser l’application dans l’incapacité de retrouver les photos, les documents, les miniatures, les certificats ou les chemins de stockage.
Pour planifier la récupération d’un serveur domestique, le guide ZimaSpace sur les montages liés et les volumes nommés explique pourquoi des chemins de stockage visibles facilitent la récupération, sans toutefois remplacer une sauvegarde de base de données cohérente avec l’application.
Validez la méthode en restaurant la sauvegarde dans un nouveau conteneur
Créez une pile de test isolée avec un nouveau nom de projet, des ports hôte différents et un répertoire de données temporaire. Restaurez l’export ou l’instantané, démarrez la base de données, exécutez ses contrôles d’intégrité ou de cohérence, puis connectez une copie de test de l’application. Vérifiez que les utilisateurs, les enregistrements, les pièces jointes et les transactions récentes sont présents.
Mesurez à la fois le point de reprise et le temps de reprise. Si un export logique est cohérent mais prend trop de temps à restaurer, conservez-le comme solution de récupération portable et ajoutez un instantané coordonné plus rapide. Si une copie du volume à l’arrêt se restaure rapidement, mais uniquement avec la même version de la base de données, gardez un export logique comme solution de secours pour la migration.
FAQ
Mettre en pause un conteneur de base de données suffit-il avant de copier le volume ?
Pas en règle générale. La mise en pause fige le processus, mais ne prouve pas que la base de données a écrit l’état approprié pour une sauvegarde portable. Utilisez un export natif de la base de données, un arrêt propre ou une procédure documentée de mise au repos et de prise d’instantané.
Un instantané du NAS suffit-il à lui seul pour PostgreSQL ou MariaDB ?
Uniquement si l’instantané est atomique et coordonné avec le processus de cohérence pris en charge par la base de données. Un instantané non coordonné peut n’être cohérent qu’en cas de panne, et une copie de fichier non atomique peut être encore plus risquée.
Que dois-je sauvegarder pour une application de serveur domestique utilisant SQLite ?
Utilisez la fonction d’exportation de l’application ou la sauvegarde en ligne de SQLite lorsqu’elle est disponible. Conservez également la configuration de l’application, le fichier Compose, les secrets, les pièces jointes et le répertoire contenant la base de données, au lieu de supposer que le fichier principal .db constitue toute l’application.
Recommandation finale
Utilisez par défaut des sauvegardes logiques planifiées pour la plupart des conteneurs PostgreSQL et MariaDB sur un NAS domestique. Optez pour une copie propre du volume à l’arrêt si une courte interruption de service est acceptable, et utilisez des instantanés coordonnés ou des outils physiques natifs de la base de données si celle-ci est volumineuse ou si la fenêtre de perte de données acceptable est réduite. Quelle que soit la méthode choisie, restaurez la sauvegarde dans un nouveau conteneur avant de lui faire confiance.
Assistance et conseils
À lire aussi

Ce qu’il faut vérifier avant de charger un modèle communautaire dans Transformers
Utilisez la mise à jour du bac à sable Jinja de Transformers pour examiner la provenance des modèles, les modèles de conversation, le code...

Exécutez Mirage localement : OCR et détection d’objets à partir d’une seule image
Essayez le petit modèle de vision local de Cactus Compute, testez la reconnaissance optique de caractères et l’extraction d’objets à partir de données réelles,...

Comment planifier un agent de programmation dans Open WebUI sur un serveur domestique
Configurez une automatisation d’agent de codage en mode rapport uniquement dans Open WebUI, sélectionnez son terminal et son espace de travail, puis vérifiez les...



