From 68b94bfdf58b80435a1da3cc78457f7ba7e82000 Mon Sep 17 00:00:00 2001 From: Andrea Mazzoleni Date: Thu, 1 Oct 2026 19:55:23 +0200 Subject: [PATCH] Document interaction between filesystem snapshots and external backup tools --- doc/snapraid-de.1 | 31 +++++++++++++++++++++++++++++++ doc/snapraid-de.d | 32 ++++++++++++++++++++++++++++++++ doc/snapraid-de.txt | 34 ++++++++++++++++++++++++++++++++++ doc/snapraid-es.1 | 30 ++++++++++++++++++++++++++++++ doc/snapraid-es.d | 31 +++++++++++++++++++++++++++++++ doc/snapraid-es.txt | 33 +++++++++++++++++++++++++++++++++ doc/snapraid-fr.1 | 30 ++++++++++++++++++++++++++++++ doc/snapraid-fr.d | 31 +++++++++++++++++++++++++++++++ doc/snapraid-fr.txt | 33 +++++++++++++++++++++++++++++++++ doc/snapraid-it.1 | 28 ++++++++++++++++++++++++++++ doc/snapraid-it.d | 29 +++++++++++++++++++++++++++++ doc/snapraid-it.txt | 31 +++++++++++++++++++++++++++++++ doc/snapraid-ja.1 | 25 +++++++++++++++++++++++++ doc/snapraid-ja.d | 26 ++++++++++++++++++++++++++ doc/snapraid-ja.txt | 28 ++++++++++++++++++++++++++++ doc/snapraid-ko.1 | 22 ++++++++++++++++++++++ doc/snapraid-ko.d | 23 +++++++++++++++++++++++ doc/snapraid-ko.txt | 25 +++++++++++++++++++++++++ doc/snapraid-pl.1 | 30 ++++++++++++++++++++++++++++++ doc/snapraid-pl.d | 31 +++++++++++++++++++++++++++++++ doc/snapraid-pl.txt | 33 +++++++++++++++++++++++++++++++++ doc/snapraid-pt.1 | 30 ++++++++++++++++++++++++++++++ doc/snapraid-pt.d | 31 +++++++++++++++++++++++++++++++ doc/snapraid-pt.txt | 33 +++++++++++++++++++++++++++++++++ doc/snapraid-ro.1 | 30 ++++++++++++++++++++++++++++++ doc/snapraid-ro.d | 31 +++++++++++++++++++++++++++++++ doc/snapraid-ro.txt | 33 +++++++++++++++++++++++++++++++++ doc/snapraid-ru.1 | 28 ++++++++++++++++++++++++++++ doc/snapraid-ru.d | 29 +++++++++++++++++++++++++++++ doc/snapraid-ru.txt | 31 +++++++++++++++++++++++++++++++ doc/snapraid-sv.1 | 28 ++++++++++++++++++++++++++++ doc/snapraid-sv.d | 29 +++++++++++++++++++++++++++++ doc/snapraid-sv.txt | 31 +++++++++++++++++++++++++++++++ doc/snapraid-uk.1 | 28 ++++++++++++++++++++++++++++ doc/snapraid-uk.d | 29 +++++++++++++++++++++++++++++ doc/snapraid-uk.txt | 31 +++++++++++++++++++++++++++++++ doc/snapraid-zh.1 | 19 +++++++++++++++++++ doc/snapraid-zh.d | 20 ++++++++++++++++++++ doc/snapraid-zh.txt | 22 ++++++++++++++++++++++ doc/snapraid.1 | 27 +++++++++++++++++++++++++++ doc/snapraid.d | 28 ++++++++++++++++++++++++++++ doc/snapraid.txt | 30 ++++++++++++++++++++++++++++++ 42 files changed, 1214 insertions(+) diff --git a/doc/snapraid-de.1 b/doc/snapraid-de.1 index f2714b9f..a64fdd51 100644 --- a/doc/snapraid-de.1 +++ b/doc/snapraid-de.1 @@ -2075,6 +2075,37 @@ Wenn ein \`sync\` jedoch unterbrochen wird, vermeiden Sie es, Dateien zu die aus dem vom unterbrochenen Sync verwendeten Snapshot berechnet wurden. Ein späterer Sync könnte diesen Snapshot ersetzen, wodurch Zwischenversionen von Dateien für die Wiederherstellung nicht mehr verfügbar sind. +.SS Externe Sicherungen mit Dateisystem\-Snapshots (External backups with filesystem snapshots) +Wenn Dateisystem\-Snapshots aktiviert sind, greift SnapRAID auf Snapshots +an der Wurzel jedes Daten\-Subvolumes, Volumes oder Datasets zu oder erstellt +diese dort. +.PP +Ein einfacher Weg, um jegliche Beeinträchtigung durch externe Tools zu +vermeiden, besteht darin, die \`data\`\-Konfiguration auf ein reguläres +Unterverzeichnis innerhalb des Subvolumes oder Volumes verweisen zu lassen +(beispielsweise \`/mnt/subvol/data\` statt \`/mnt/subvol\`). SnapRAID erstellt +das Snapshot\-Verzeichnis immer an der Wurzel des Subvolumes (beispielsweise +\`/mnt/subvol/.snapraid/\`), wodurch das Datenunterverzeichnis sauber bleibt +und Snapshots außerhalb und unsichtbar für Sicherungswerkzeuge bleiben, die +darin arbeiten. +.PP +Wenn das konfigurierte \`data\`\-Verzeichnis hingegen selbst die Wurzel des +Subvolumes oder Volumes ist, erstellt SnapRAID ein \`.snapraid/\`\-Verzeichnis +direkt darin (auf Btrfs, Bcachefs und NTFS). Während SnapRAID dieses +Verzeichnis bei seinen eigenen Scans automatisch ausschließt, werden +externe Sicherungs\- oder Synchronisationswerkzeuge darauf stoßen. Wenn es +nicht ausgeschlossen wird, könnten sie in die Snapshots oder Verknüpfungen +eindringen und den gesamten eingefrorenen Datenbaum kopieren, was Daten +dupliziert und den Sicherungsspeicherplatz erschöpfen kann. Konfigurieren +Sie externe Sicherungswerkzeuge immer so, dass sie das Verzeichnis +\`.snapraid/\` ausschließen. +.PP +Bei ZFS werden Snapshots über das standardmäßige virtuelle Verzeichnis +\`.zfs/snapshot/\` anstelle von \`.snapraid/\` bereitgestellt. Standardmäßig +(\`snapdir=hidden\`) blendet ZFS dieses Verzeichnis in Verzeichnislisten aus, +sodass externe Sicherungswerkzeuge es nicht durchlaufen. Wenn Sie +\`snapdir=visible\` aktiviert haben, stellen Sie sicher, dass Ihre +Sicherungswerkzeuge das Verzeichnis \`.zfs/\` ausschließen. .SH MUSTER (PATTERN) Muster bieten eine flexible Möglichkeit, Dateien für die Einbeziehung oder den Ausschluss zu filtern. Durch die Verwendung von Globbing\-Zeichen können Sie Regeln definieren, diff --git a/doc/snapraid-de.d b/doc/snapraid-de.d index 70c33437..3371c773 100644 --- a/doc/snapraid-de.d +++ b/doc/snapraid-de.d @@ -1669,6 +1669,38 @@ Lebenszyklus von Snapshots (Snapshots Lifecycle) Ein späterer Sync könnte diesen Snapshot ersetzen, wodurch Zwischenversionen von Dateien für die Wiederherstellung nicht mehr verfügbar sind. + Externe Sicherungen mit Dateisystem-Snapshots (External backups with filesystem snapshots) + Wenn Dateisystem-Snapshots aktiviert sind, greift SnapRAID auf Snapshots + an der Wurzel jedes Daten-Subvolumes, Volumes oder Datasets zu oder erstellt + diese dort. + + Ein einfacher Weg, um jegliche Beeinträchtigung durch externe Tools zu + vermeiden, besteht darin, die `data`-Konfiguration auf ein reguläres + Unterverzeichnis innerhalb des Subvolumes oder Volumes verweisen zu lassen + (beispielsweise `/mnt/subvol/data` statt `/mnt/subvol`). SnapRAID erstellt + das Snapshot-Verzeichnis immer an der Wurzel des Subvolumes (beispielsweise + `/mnt/subvol/.snapraid/`), wodurch das Datenunterverzeichnis sauber bleibt + und Snapshots außerhalb und unsichtbar für Sicherungswerkzeuge bleiben, die + darin arbeiten. + + Wenn das konfigurierte `data`-Verzeichnis hingegen selbst die Wurzel des + Subvolumes oder Volumes ist, erstellt SnapRAID ein `.snapraid/`-Verzeichnis + direkt darin (auf Btrfs, Bcachefs und NTFS). Während SnapRAID dieses + Verzeichnis bei seinen eigenen Scans automatisch ausschließt, werden + externe Sicherungs- oder Synchronisationswerkzeuge darauf stoßen. Wenn es + nicht ausgeschlossen wird, könnten sie in die Snapshots oder Verknüpfungen + eindringen und den gesamten eingefrorenen Datenbaum kopieren, was Daten + dupliziert und den Sicherungsspeicherplatz erschöpfen kann. Konfigurieren + Sie externe Sicherungswerkzeuge immer so, dass sie das Verzeichnis + `.snapraid/` ausschließen. + + Bei ZFS werden Snapshots über das standardmäßige virtuelle Verzeichnis + `.zfs/snapshot/` anstelle von `.snapraid/` bereitgestellt. Standardmäßig + (`snapdir=hidden`) blendet ZFS dieses Verzeichnis in Verzeichnislisten aus, + sodass externe Sicherungswerkzeuge es nicht durchlaufen. Wenn Sie + `snapdir=visible` aktiviert haben, stellen Sie sicher, dass Ihre + Sicherungswerkzeuge das Verzeichnis `.zfs/` ausschließen. + Muster (Pattern) Muster bieten eine flexible Möglichkeit, Dateien für die Einbeziehung oder den Ausschluss zu filtern. Durch die Verwendung von Globbing-Zeichen können Sie Regeln definieren, diff --git a/doc/snapraid-de.txt b/doc/snapraid-de.txt index 4793db60..75776832 100644 --- a/doc/snapraid-de.txt +++ b/doc/snapraid-de.txt @@ -1779,6 +1779,40 @@ die aus dem vom unterbrochenen Sync verwendeten Snapshot berechnet wurden. Ein späterer Sync könnte diesen Snapshot ersetzen, wodurch Zwischenversionen von Dateien für die Wiederherstellung nicht mehr verfügbar sind. +9.1 Externe Sicherungen mit Dateisystem-Snapshots (External backups with filesystem snapshots) +---------------------------------------------------------------------------------------------- + +Wenn Dateisystem-Snapshots aktiviert sind, greift SnapRAID auf Snapshots +an der Wurzel jedes Daten-Subvolumes, Volumes oder Datasets zu oder erstellt +diese dort. + +Ein einfacher Weg, um jegliche Beeinträchtigung durch externe Tools zu +vermeiden, besteht darin, die `data`-Konfiguration auf ein reguläres +Unterverzeichnis innerhalb des Subvolumes oder Volumes verweisen zu lassen +(beispielsweise `/mnt/subvol/data` statt `/mnt/subvol`). SnapRAID erstellt +das Snapshot-Verzeichnis immer an der Wurzel des Subvolumes (beispielsweise +`/mnt/subvol/.snapraid/`), wodurch das Datenunterverzeichnis sauber bleibt +und Snapshots außerhalb und unsichtbar für Sicherungswerkzeuge bleiben, die +darin arbeiten. + +Wenn das konfigurierte `data`-Verzeichnis hingegen selbst die Wurzel des +Subvolumes oder Volumes ist, erstellt SnapRAID ein `.snapraid/`-Verzeichnis +direkt darin (auf Btrfs, Bcachefs und NTFS). Während SnapRAID dieses +Verzeichnis bei seinen eigenen Scans automatisch ausschließt, werden +externe Sicherungs- oder Synchronisationswerkzeuge darauf stoßen. Wenn es +nicht ausgeschlossen wird, könnten sie in die Snapshots oder Verknüpfungen +eindringen und den gesamten eingefrorenen Datenbaum kopieren, was Daten +dupliziert und den Sicherungsspeicherplatz erschöpfen kann. Konfigurieren +Sie externe Sicherungswerkzeuge immer so, dass sie das Verzeichnis +`.snapraid/` ausschließen. + +Bei ZFS werden Snapshots über das standardmäßige virtuelle Verzeichnis +`.zfs/snapshot/` anstelle von `.snapraid/` bereitgestellt. Standardmäßig +(`snapdir=hidden`) blendet ZFS dieses Verzeichnis in Verzeichnislisten aus, +sodass externe Sicherungswerkzeuge es nicht durchlaufen. Wenn Sie +`snapdir=visible` aktiviert haben, stellen Sie sicher, dass Ihre +Sicherungswerkzeuge das Verzeichnis `.zfs/` ausschließen. + 10 MUSTER (PATTERN) =================== diff --git a/doc/snapraid-es.1 b/doc/snapraid-es.1 index ff245ca7..6d8294a0 100644 --- a/doc/snapraid-es.1 +++ b/doc/snapraid-es.1 @@ -2034,6 +2034,36 @@ con éxito. La paridad aún puede contener bloques calculados a partir de la instantánea utilizada por el sync interrumpido. Un sync posterior puede reemplazar esa instantánea, haciendo que las versiones intermedias de los archivos no estén disponibles para la recuperación. +.SS Copias de seguridad externas con instantáneas del sistema de archivos (External backups with filesystem snapshots) +Cuando las instantáneas del sistema de archivos están habilitadas, SnapRAID +accede o crea instantáneas en la raíz de cada subvolumen, volumen o conjunto +de datos (dataset). +.PP +Una forma sencilla de evitar interferencias con herramientas externas es +apuntar la configuración \`data\` a un subdirectorio normal dentro del +subvolumen o volumen (por ejemplo, \`/mnt/subvol/data\` en lugar de +\`/mnt/subvol\`). SnapRAID siempre crea el directorio de instantáneas en la +raíz del subvolumen (por ejemplo, \`/mnt/subvol/.snapraid/\`), dejando limpio +el subdirectorio de datos para que las instantáneas permanezcan fuera e +invisibles para las herramientas de copia de seguridad que operan dentro +de él. +.PP +De lo contrario, si el directorio \`data\` configurado es en sí mismo la raíz +del subvolumen o volumen, SnapRAID crea un directorio \`.snapraid/\` +directamente dentro de él (en Btrfs, Bcachefs y NTFS). Aunque SnapRAID +excluye automáticamente este directorio de su propio escaneo, las +herramientas externas de copia de seguridad o sincronización de archivos lo +encontrarán. Si no se excluye, pueden acceder a las instantáneas o enlaces +de directorio y copiar todo el árbol de datos congelado, duplicando datos y +agotando el almacenamiento de respaldo. Configure siempre las herramientas +de copia de seguridad externas para excluir el directorio \`.snapraid/\`. +.PP +En ZFS, las instantáneas se exponen a través del directorio virtual estándar +\`.zfs/snapshot/\` en lugar de \`.snapraid/\`. De forma predeterminada +(\`snapdir=hidden\`), ZFS oculta este directorio de los listados, por lo que +las herramientas externas de copia de seguridad no lo recorrerán. Si ha +habilitado \`snapdir=visible\`, asegúrese de que sus herramientas de copia +de seguridad excluyan el directorio \`.zfs/\`. .SH PATRONES (PATTERN) Los patrones proporcionan una forma flexible de filtrar archivos para su inclusión o exclusión. Al usar caracteres de globbing, puede definir reglas que coincidan con diff --git a/doc/snapraid-es.d b/doc/snapraid-es.d index 4eb03b86..beb131fd 100644 --- a/doc/snapraid-es.d +++ b/doc/snapraid-es.d @@ -1639,6 +1639,37 @@ Ciclo de vida de las instantáneas (Snapshots Lifecycle) reemplazar esa instantánea, haciendo que las versiones intermedias de los archivos no estén disponibles para la recuperación. + Copias de seguridad externas con instantáneas del sistema de archivos (External backups with filesystem snapshots) + Cuando las instantáneas del sistema de archivos están habilitadas, SnapRAID + accede o crea instantáneas en la raíz de cada subvolumen, volumen o conjunto + de datos (dataset). + + Una forma sencilla de evitar interferencias con herramientas externas es + apuntar la configuración `data` a un subdirectorio normal dentro del + subvolumen o volumen (por ejemplo, `/mnt/subvol/data` en lugar de + `/mnt/subvol`). SnapRAID siempre crea el directorio de instantáneas en la + raíz del subvolumen (por ejemplo, `/mnt/subvol/.snapraid/`), dejando limpio + el subdirectorio de datos para que las instantáneas permanezcan fuera e + invisibles para las herramientas de copia de seguridad que operan dentro + de él. + + De lo contrario, si el directorio `data` configurado es en sí mismo la raíz + del subvolumen o volumen, SnapRAID crea un directorio `.snapraid/` + directamente dentro de él (en Btrfs, Bcachefs y NTFS). Aunque SnapRAID + excluye automáticamente este directorio de su propio escaneo, las + herramientas externas de copia de seguridad o sincronización de archivos lo + encontrarán. Si no se excluye, pueden acceder a las instantáneas o enlaces + de directorio y copiar todo el árbol de datos congelado, duplicando datos y + agotando el almacenamiento de respaldo. Configure siempre las herramientas + de copia de seguridad externas para excluir el directorio `.snapraid/`. + + En ZFS, las instantáneas se exponen a través del directorio virtual estándar + `.zfs/snapshot/` en lugar de `.snapraid/`. De forma predeterminada + (`snapdir=hidden`), ZFS oculta este directorio de los listados, por lo que + las herramientas externas de copia de seguridad no lo recorrerán. Si ha + habilitado `snapdir=visible`, asegúrese de que sus herramientas de copia + de seguridad excluyan el directorio `.zfs/`. + Patrones (Pattern) Los patrones proporcionan una forma flexible de filtrar archivos para su inclusión o exclusión. Al usar caracteres de globbing, puede definir reglas que coincidan con diff --git a/doc/snapraid-es.txt b/doc/snapraid-es.txt index b4e08684..ecfd677c 100644 --- a/doc/snapraid-es.txt +++ b/doc/snapraid-es.txt @@ -1749,6 +1749,39 @@ la instantánea utilizada por el sync interrumpido. Un sync posterior puede reemplazar esa instantánea, haciendo que las versiones intermedias de los archivos no estén disponibles para la recuperación. +9.1 Copias de seguridad externas con instantáneas del sistema de archivos (External backups with filesystem snapshots) +---------------------------------------------------------------------------------------------------------------------- + +Cuando las instantáneas del sistema de archivos están habilitadas, SnapRAID +accede o crea instantáneas en la raíz de cada subvolumen, volumen o conjunto +de datos (dataset). + +Una forma sencilla de evitar interferencias con herramientas externas es +apuntar la configuración `data` a un subdirectorio normal dentro del +subvolumen o volumen (por ejemplo, `/mnt/subvol/data` en lugar de +`/mnt/subvol`). SnapRAID siempre crea el directorio de instantáneas en la +raíz del subvolumen (por ejemplo, `/mnt/subvol/.snapraid/`), dejando limpio +el subdirectorio de datos para que las instantáneas permanezcan fuera e +invisibles para las herramientas de copia de seguridad que operan dentro +de él. + +De lo contrario, si el directorio `data` configurado es en sí mismo la raíz +del subvolumen o volumen, SnapRAID crea un directorio `.snapraid/` +directamente dentro de él (en Btrfs, Bcachefs y NTFS). Aunque SnapRAID +excluye automáticamente este directorio de su propio escaneo, las +herramientas externas de copia de seguridad o sincronización de archivos lo +encontrarán. Si no se excluye, pueden acceder a las instantáneas o enlaces +de directorio y copiar todo el árbol de datos congelado, duplicando datos y +agotando el almacenamiento de respaldo. Configure siempre las herramientas +de copia de seguridad externas para excluir el directorio `.snapraid/`. + +En ZFS, las instantáneas se exponen a través del directorio virtual estándar +`.zfs/snapshot/` en lugar de `.snapraid/`. De forma predeterminada +(`snapdir=hidden`), ZFS oculta este directorio de los listados, por lo que +las herramientas externas de copia de seguridad no lo recorrerán. Si ha +habilitado `snapdir=visible`, asegúrese de que sus herramientas de copia +de seguridad excluyan el directorio `.zfs/`. + 10 PATRONES (PATTERN) ===================== diff --git a/doc/snapraid-fr.1 b/doc/snapraid-fr.1 index 03482ca6..40471034 100644 --- a/doc/snapraid-fr.1 +++ b/doc/snapraid-fr.1 @@ -2071,6 +2071,36 @@ avec succès. La parité peut encore contenir des blocs calculés à partir de l\'instantané utilisé par le sync interrompu. Un sync ultérieur peut remplacer cet instantané, rendant les versions intermédiaires des fichiers indisponibles pour la récupération. +.SS Sauvegardes externes avec les instantanés de système de fichiers (External backups with filesystem snapshots) +Lorsque les instantanés de système de fichiers sont activés, SnapRAID accède +aux instantanés ou les crée à la racine de chaque sous\-volume, volume ou +jeu de données (dataset). +.PP +Un moyen simple d\'éviter toute interférence avec les outils externes +consiste à faire pointer la configuration \`data\` vers un sous\-répertoire +ordinaire au sein du sous\-volume ou du volume (par exemple +\`/mnt/subvol/data\` au lieu de \`/mnt/subvol\`). SnapRAID crée toujours le +répertoire d\'instantanés à la racine du sous\-volume (par exemple +\`/mnt/subvol/.snapraid/\`), laissant le sous\-répertoire de données propre de +sorte que les instantanés restent à l\'extérieur et invisibles pour les +outils de sauvegarde opérant à l\'intérieur. +.PP +Sinon, si votre répertoire \`data\` configuré est lui\-même la racine du +sous\-volume ou du volume, SnapRAID crée un répertoire \`.snapraid/\` +directement à l\'intérieur (sur Btrfs, Bcachefs et NTFS). Bien que SnapRAID +exclue automatiquement ce répertoire de ses propres analyses, les outils +de sauvegarde externes ou les synchroniseurs de fichiers le rencontreront. +S\'il n\'est pas exclu, ils peuvent traverser les instantanés ou les liens de +répertoires et copier l\'ensemble de l\'arborescence figée, dupliquant les +données et risquant d\'épuiser l\'espace de sauvegarde. Configurez toujours +les outils de sauvegarde externes pour exclure le répertoire \`.snapraid/\`. +.PP +Sur ZFS, les instantanés sont exposés via le répertoire virtuel standard +\`.zfs/snapshot/\` plutôt que \`.snapraid/\`. Par défaut (\`snapdir=hidden\`), ZFS +masque ce répertoire des listes de fichiers, de sorte que les outils de +sauvegarde externes ne le parcourront pas. Si vous avez activé +\`snapdir=visible\`, veillez à ce que vos outils de sauvegarde excluent le +répertoire \`.zfs/\`. .SH MOTIF (PATTERN) Les motifs offrent un moyen flexible de filtrer les fichiers à inclure ou à exclure. En utilisant des caractères de \[dq]globbing\[dq], vous pouvez définir des règles qui diff --git a/doc/snapraid-fr.d b/doc/snapraid-fr.d index 39b5c8d1..513d0664 100644 --- a/doc/snapraid-fr.d +++ b/doc/snapraid-fr.d @@ -1676,6 +1676,37 @@ Cycle de vie des instantanés (Snapshots Lifecycle) cet instantané, rendant les versions intermédiaires des fichiers indisponibles pour la récupération. + Sauvegardes externes avec les instantanés de système de fichiers (External backups with filesystem snapshots) + Lorsque les instantanés de système de fichiers sont activés, SnapRAID accède + aux instantanés ou les crée à la racine de chaque sous-volume, volume ou + jeu de données (dataset). + + Un moyen simple d'éviter toute interférence avec les outils externes + consiste à faire pointer la configuration `data` vers un sous-répertoire + ordinaire au sein du sous-volume ou du volume (par exemple + `/mnt/subvol/data` au lieu de `/mnt/subvol`). SnapRAID crée toujours le + répertoire d'instantanés à la racine du sous-volume (par exemple + `/mnt/subvol/.snapraid/`), laissant le sous-répertoire de données propre de + sorte que les instantanés restent à l'extérieur et invisibles pour les + outils de sauvegarde opérant à l'intérieur. + + Sinon, si votre répertoire `data` configuré est lui-même la racine du + sous-volume ou du volume, SnapRAID crée un répertoire `.snapraid/` + directement à l'intérieur (sur Btrfs, Bcachefs et NTFS). Bien que SnapRAID + exclue automatiquement ce répertoire de ses propres analyses, les outils + de sauvegarde externes ou les synchroniseurs de fichiers le rencontreront. + S'il n'est pas exclu, ils peuvent traverser les instantanés ou les liens de + répertoires et copier l'ensemble de l'arborescence figée, dupliquant les + données et risquant d'épuiser l'espace de sauvegarde. Configurez toujours + les outils de sauvegarde externes pour exclure le répertoire `.snapraid/`. + + Sur ZFS, les instantanés sont exposés via le répertoire virtuel standard + `.zfs/snapshot/` plutôt que `.snapraid/`. Par défaut (`snapdir=hidden`), ZFS + masque ce répertoire des listes de fichiers, de sorte que les outils de + sauvegarde externes ne le parcourront pas. Si vous avez activé + `snapdir=visible`, veillez à ce que vos outils de sauvegarde excluent le + répertoire `.zfs/`. + Motif (Pattern) Les motifs offrent un moyen flexible de filtrer les fichiers à inclure ou à exclure. En utilisant des caractères de "globbing", vous pouvez définir des règles qui diff --git a/doc/snapraid-fr.txt b/doc/snapraid-fr.txt index 9169b1fc..c69cc2ed 100644 --- a/doc/snapraid-fr.txt +++ b/doc/snapraid-fr.txt @@ -1786,6 +1786,39 @@ l'instantané utilisé par le sync interrompu. Un sync ultérieur peut remplacer cet instantané, rendant les versions intermédiaires des fichiers indisponibles pour la récupération. +9.1 Sauvegardes externes avec les instantanés de système de fichiers (External backups with filesystem snapshots) +----------------------------------------------------------------------------------------------------------------- + +Lorsque les instantanés de système de fichiers sont activés, SnapRAID accède +aux instantanés ou les crée à la racine de chaque sous-volume, volume ou +jeu de données (dataset). + +Un moyen simple d'éviter toute interférence avec les outils externes +consiste à faire pointer la configuration `data` vers un sous-répertoire +ordinaire au sein du sous-volume ou du volume (par exemple +`/mnt/subvol/data` au lieu de `/mnt/subvol`). SnapRAID crée toujours le +répertoire d'instantanés à la racine du sous-volume (par exemple +`/mnt/subvol/.snapraid/`), laissant le sous-répertoire de données propre de +sorte que les instantanés restent à l'extérieur et invisibles pour les +outils de sauvegarde opérant à l'intérieur. + +Sinon, si votre répertoire `data` configuré est lui-même la racine du +sous-volume ou du volume, SnapRAID crée un répertoire `.snapraid/` +directement à l'intérieur (sur Btrfs, Bcachefs et NTFS). Bien que SnapRAID +exclue automatiquement ce répertoire de ses propres analyses, les outils +de sauvegarde externes ou les synchroniseurs de fichiers le rencontreront. +S'il n'est pas exclu, ils peuvent traverser les instantanés ou les liens de +répertoires et copier l'ensemble de l'arborescence figée, dupliquant les +données et risquant d'épuiser l'espace de sauvegarde. Configurez toujours +les outils de sauvegarde externes pour exclure le répertoire `.snapraid/`. + +Sur ZFS, les instantanés sont exposés via le répertoire virtuel standard +`.zfs/snapshot/` plutôt que `.snapraid/`. Par défaut (`snapdir=hidden`), ZFS +masque ce répertoire des listes de fichiers, de sorte que les outils de +sauvegarde externes ne le parcourront pas. Si vous avez activé +`snapdir=visible`, veillez à ce que vos outils de sauvegarde excluent le +répertoire `.zfs/`. + 10 MOTIF (PATTERN) ================== diff --git a/doc/snapraid-it.1 b/doc/snapraid-it.1 index ab7aff8d..5b5326df 100644 --- a/doc/snapraid-it.1 +++ b/doc/snapraid-it.1 @@ -2055,6 +2055,34 @@ con successo. La parità potrebbe ancora contenere blocchi calcolati dallo snapshot utilizzato dal sync interrotto. Un sync successivo potrebbe sostituire tale snapshot, rendendo le versioni intermedie dei file non disponibili per il recupero. +.SS Backup esterni con snapshot del filesystem (External backups with filesystem snapshots) +Quando gli snapshot del filesystem sono abilitati, SnapRAID accede o crea +gli snapshot alla radice di ciascun sottovolume, volume o dataset di dati. +.PP +Un modo semplice per evitare interferenze con gli strumenti esterni consiste +nel far puntare la configurazione \`data\` a una sottodirectory ordinaria +all\'interno del subvolume o del volume (ad esempio \`/mnt/subvol/data\` invece +di \`/mnt/subvol\`). SnapRAID crea sempre la directory degli snapshot alla +radice del subvolume (ad esempio \`/mnt/subvol/.snapraid/\`), lasciando pulita +la sottodirectory dei dati in modo che gli snapshot rimangano all\'esterno +e invisibili agli strumenti di backup che operano al suo interno. +.PP +Altrimenti, se la directory \`data\` configurata è essa stessa la radice del +subvolume o del volume, SnapRAID crea una directory \`.snapraid/\` direttamente +al suo interno (su Btrfs, Bcachefs e NTFS). Sebbene SnapRAID escluda +automaticamente questa directory dalla propria scansione, gli strumenti di +backup esterni o i programmi di sincronizzazione dei file la incontreranno. +Se non viene esclusa, potrebbero entrare negli snapshot o nei collegamenti +di directory e copiare l\'intero albero dei dati congelato, duplicando i dati +ed esaurendo lo spazio di archiviazione dei backup. Configurare sempre gli +strumenti di backup esterni in modo da escludere la directory \`.snapraid/\`. +.PP +Su ZFS, gli snapshot sono esposti tramite la directory virtuale standard +\`.zfs/snapshot/\` anziché \`.snapraid/\`. Di default (\`snapdir=hidden\`), ZFS +nasconde questa directory dall\'elenco delle directory, quindi gli strumenti +di backup esterni non la attraverseranno. Se è stato abilitato +\`snapdir=visible\`, assicurarsi che gli strumenti di backup escludano la +directory \`.zfs/\`. .SH PATTERN I pattern offrono un modo flessibile per filtrare i file da includere o escludere. Usando i caratteri globbing, è possibile definire regole che diff --git a/doc/snapraid-it.d b/doc/snapraid-it.d index a300db88..e69417a5 100644 --- a/doc/snapraid-it.d +++ b/doc/snapraid-it.d @@ -1649,6 +1649,35 @@ Ciclo di vita degli snapshot (Snapshots Lifecycle) tale snapshot, rendendo le versioni intermedie dei file non disponibili per il recupero. + Backup esterni con snapshot del filesystem (External backups with filesystem snapshots) + Quando gli snapshot del filesystem sono abilitati, SnapRAID accede o crea + gli snapshot alla radice di ciascun sottovolume, volume o dataset di dati. + + Un modo semplice per evitare interferenze con gli strumenti esterni consiste + nel far puntare la configurazione `data` a una sottodirectory ordinaria + all'interno del subvolume o del volume (ad esempio `/mnt/subvol/data` invece + di `/mnt/subvol`). SnapRAID crea sempre la directory degli snapshot alla + radice del subvolume (ad esempio `/mnt/subvol/.snapraid/`), lasciando pulita + la sottodirectory dei dati in modo che gli snapshot rimangano all'esterno + e invisibili agli strumenti di backup che operano al suo interno. + + Altrimenti, se la directory `data` configurata è essa stessa la radice del + subvolume o del volume, SnapRAID crea una directory `.snapraid/` direttamente + al suo interno (su Btrfs, Bcachefs e NTFS). Sebbene SnapRAID escluda + automaticamente questa directory dalla propria scansione, gli strumenti di + backup esterni o i programmi di sincronizzazione dei file la incontreranno. + Se non viene esclusa, potrebbero entrare negli snapshot o nei collegamenti + di directory e copiare l'intero albero dei dati congelato, duplicando i dati + ed esaurendo lo spazio di archiviazione dei backup. Configurare sempre gli + strumenti di backup esterni in modo da escludere la directory `.snapraid/`. + + Su ZFS, gli snapshot sono esposti tramite la directory virtuale standard + `.zfs/snapshot/` anziché `.snapraid/`. Di default (`snapdir=hidden`), ZFS + nasconde questa directory dall'elenco delle directory, quindi gli strumenti + di backup esterni non la attraverseranno. Se è stato abilitato + `snapdir=visible`, assicurarsi che gli strumenti di backup escludano la + directory `.zfs/`. + Pattern I pattern offrono un modo flessibile per filtrare i file da includere o escludere. Usando i caratteri globbing, è possibile definire regole che diff --git a/doc/snapraid-it.txt b/doc/snapraid-it.txt index bf0b3c36..711a98cf 100644 --- a/doc/snapraid-it.txt +++ b/doc/snapraid-it.txt @@ -1759,6 +1759,37 @@ snapshot utilizzato dal sync interrotto. Un sync successivo potrebbe sostituire tale snapshot, rendendo le versioni intermedie dei file non disponibili per il recupero. +9.1 Backup esterni con snapshot del filesystem (External backups with filesystem snapshots) +------------------------------------------------------------------------------------------- + +Quando gli snapshot del filesystem sono abilitati, SnapRAID accede o crea +gli snapshot alla radice di ciascun sottovolume, volume o dataset di dati. + +Un modo semplice per evitare interferenze con gli strumenti esterni consiste +nel far puntare la configurazione `data` a una sottodirectory ordinaria +all'interno del subvolume o del volume (ad esempio `/mnt/subvol/data` invece +di `/mnt/subvol`). SnapRAID crea sempre la directory degli snapshot alla +radice del subvolume (ad esempio `/mnt/subvol/.snapraid/`), lasciando pulita +la sottodirectory dei dati in modo che gli snapshot rimangano all'esterno +e invisibili agli strumenti di backup che operano al suo interno. + +Altrimenti, se la directory `data` configurata è essa stessa la radice del +subvolume o del volume, SnapRAID crea una directory `.snapraid/` direttamente +al suo interno (su Btrfs, Bcachefs e NTFS). Sebbene SnapRAID escluda +automaticamente questa directory dalla propria scansione, gli strumenti di +backup esterni o i programmi di sincronizzazione dei file la incontreranno. +Se non viene esclusa, potrebbero entrare negli snapshot o nei collegamenti +di directory e copiare l'intero albero dei dati congelato, duplicando i dati +ed esaurendo lo spazio di archiviazione dei backup. Configurare sempre gli +strumenti di backup esterni in modo da escludere la directory `.snapraid/`. + +Su ZFS, gli snapshot sono esposti tramite la directory virtuale standard +`.zfs/snapshot/` anziché `.snapraid/`. Di default (`snapdir=hidden`), ZFS +nasconde questa directory dall'elenco delle directory, quindi gli strumenti +di backup esterni non la attraverseranno. Se è stato abilitato +`snapdir=visible`, assicurarsi che gli strumenti di backup escludano la +directory `.zfs/`. + 10 PATTERN ========== diff --git a/doc/snapraid-ja.1 b/doc/snapraid-ja.1 index efdca0e8..a11a9d20 100644 --- a/doc/snapraid-ja.1 +++ b/doc/snapraid-ja.1 @@ -1833,6 +1833,31 @@ ZFSでは標準の \`.zfs/snapshot/\` が使用されます。 パリティには、中断された sync で使用されたスナップショットから計算されたブロックが まだ含まれている可能性があります。その後の sync によりそのスナップショットが 置き換えられ、中間バージョンのファイルが復元できなくなる可能性があります。 +.SS ファイルシステムスナップショットと外部バックアップ (External backups with filesystem snapshots) +ファイルシステムスナップショットが有効な場合、SnapRAIDは各データサブボリューム、 +ボリューム、またはデータセットのルートにあるスナップショットにアクセスまたは作成します。 +.PP +外部ツールとの干渉を避ける簡単な方法は、\`data\` 設定をサブボリュームまたは +ボリューム内の通常のサブディレクトリ（例えば \`/mnt/subvol\` の代わりに +\`/mnt/subvol/data\`）に指定することです。SnapRAIDは常にサブボリュームのルートに +スナップショットディレクトリを作成するため（例えば \`/mnt/subvol/.snapraid/\`）、 +データサブディレクトリがクリーンに保たれ、スナップショットはそのディレクトリ内で +動作するバックアップツールから見えない状態のままになります。 +.PP +一方、設定された \`data\` ディレクトリ自体がサブボリュームまたはボリュームの +ルートである場合、SnapRAIDはその直下に \`.snapraid/\` ディレクトリを作成します（Btrfs、 +Bcachefs、およびNTFS）。SnapRAID自身のスキャンからは自動的に除外されますが、 +外部のバックアップツールやファイル同期ツールはそのディレクトリを検出します。 +除外設定を行わない場合、スナップショットやディレクトリリンク内を走査して凍結された +データツリー全体をコピーしてしまい、データが重複してバックアップストレージを使い果たす +可能性があります。外部バックアップツールでは、必ず \`.snapraid/\` ディレクトリを +除外するように設定してください。 +.PP +ZFSでは、スナップショットは \`.snapraid/\` ではなく標準の仮想ディレクトリ +\`.zfs/snapshot/\` 経由で公開されます。デフォルト（\`snapdir=hidden\`）では、ZFSはこの +ディレクトリを一覧表示から隠すため、外部バックアップツールが走査することはありません。 +\`snapdir=visible\` を有効にしている場合は、バックアップツールが \`.zfs/\` ディレクトリを +除外するように設定してください。 .SH パターン (PATTERN) パターンは、含めるファイルまたは除外するファイルをフィルタリングするための柔軟な方法を 提供します。グロブ文字を使用することで、すべてのパスを手動でリストすることなく、 diff --git a/doc/snapraid-ja.d b/doc/snapraid-ja.d index 3931aefe..58a996b7 100644 --- a/doc/snapraid-ja.d +++ b/doc/snapraid-ja.d @@ -1438,6 +1438,32 @@ Name{number} まだ含まれている可能性があります。その後の sync によりそのスナップショットが 置き換えられ、中間バージョンのファイルが復元できなくなる可能性があります。 + ファイルシステムスナップショットと外部バックアップ (External backups with filesystem snapshots) + ファイルシステムスナップショットが有効な場合、SnapRAIDは各データサブボリューム、 + ボリューム、またはデータセットのルートにあるスナップショットにアクセスまたは作成します。 + + 外部ツールとの干渉を避ける簡単な方法は、`data` 設定をサブボリュームまたは + ボリューム内の通常のサブディレクトリ（例えば `/mnt/subvol` の代わりに + `/mnt/subvol/data`）に指定することです。SnapRAIDは常にサブボリュームのルートに + スナップショットディレクトリを作成するため（例えば `/mnt/subvol/.snapraid/`）、 + データサブディレクトリがクリーンに保たれ、スナップショットはそのディレクトリ内で + 動作するバックアップツールから見えない状態のままになります。 + + 一方、設定された `data` ディレクトリ自体がサブボリュームまたはボリュームの + ルートである場合、SnapRAIDはその直下に `.snapraid/` ディレクトリを作成します（Btrfs、 + Bcachefs、およびNTFS）。SnapRAID自身のスキャンからは自動的に除外されますが、 + 外部のバックアップツールやファイル同期ツールはそのディレクトリを検出します。 + 除外設定を行わない場合、スナップショットやディレクトリリンク内を走査して凍結された + データツリー全体をコピーしてしまい、データが重複してバックアップストレージを使い果たす + 可能性があります。外部バックアップツールでは、必ず `.snapraid/` ディレクトリを + 除外するように設定してください。 + + ZFSでは、スナップショットは `.snapraid/` ではなく標準の仮想ディレクトリ + `.zfs/snapshot/` 経由で公開されます。デフォルト（`snapdir=hidden`）では、ZFSはこの + ディレクトリを一覧表示から隠すため、外部バックアップツールが走査することはありません。 + `snapdir=visible` を有効にしている場合は、バックアップツールが `.zfs/` ディレクトリを + 除外するように設定してください。 + パターン (Pattern) パターンは、含めるファイルまたは除外するファイルをフィルタリングするための柔軟な方法を 提供します。グロブ文字を使用することで、すべてのパスを手動でリストすることなく、 diff --git a/doc/snapraid-ja.txt b/doc/snapraid-ja.txt index f8b28a74..580201d5 100644 --- a/doc/snapraid-ja.txt +++ b/doc/snapraid-ja.txt @@ -1548,6 +1548,34 @@ ZFSでは標準の `.zfs/snapshot/` が使用されます。 まだ含まれている可能性があります。その後の sync によりそのスナップショットが 置き換えられ、中間バージョンのファイルが復元できなくなる可能性があります。 +9.1 ファイルシステムスナップショットと外部バックアップ (External backups with filesystem snapshots) +-------------------------------------------------------------------------- + +ファイルシステムスナップショットが有効な場合、SnapRAIDは各データサブボリューム、 +ボリューム、またはデータセットのルートにあるスナップショットにアクセスまたは作成します。 + +外部ツールとの干渉を避ける簡単な方法は、`data` 設定をサブボリュームまたは +ボリューム内の通常のサブディレクトリ（例えば `/mnt/subvol` の代わりに +`/mnt/subvol/data`）に指定することです。SnapRAIDは常にサブボリュームのルートに +スナップショットディレクトリを作成するため（例えば `/mnt/subvol/.snapraid/`）、 +データサブディレクトリがクリーンに保たれ、スナップショットはそのディレクトリ内で +動作するバックアップツールから見えない状態のままになります。 + +一方、設定された `data` ディレクトリ自体がサブボリュームまたはボリュームの +ルートである場合、SnapRAIDはその直下に `.snapraid/` ディレクトリを作成します（Btrfs、 +Bcachefs、およびNTFS）。SnapRAID自身のスキャンからは自動的に除外されますが、 +外部のバックアップツールやファイル同期ツールはそのディレクトリを検出します。 +除外設定を行わない場合、スナップショットやディレクトリリンク内を走査して凍結された +データツリー全体をコピーしてしまい、データが重複してバックアップストレージを使い果たす +可能性があります。外部バックアップツールでは、必ず `.snapraid/` ディレクトリを +除外するように設定してください。 + +ZFSでは、スナップショットは `.snapraid/` ではなく標準の仮想ディレクトリ +`.zfs/snapshot/` 経由で公開されます。デフォルト（`snapdir=hidden`）では、ZFSはこの +ディレクトリを一覧表示から隠すため、外部バックアップツールが走査することはありません。 +`snapdir=visible` を有効にしている場合は、バックアップツールが `.zfs/` ディレクトリを +除外するように設定してください。 + 10 パターン (PATTERN) ================= diff --git a/doc/snapraid-ko.1 b/doc/snapraid-ko.1 index c5af4752..406369b0 100644 --- a/doc/snapraid-ko.1 +++ b/doc/snapraid-ko.1 @@ -1877,6 +1877,28 @@ ZFS에서는 표준 \`.zfs/snapshot/\` 이 사용됩니다. 패리티에는 중단된 sync에서 사용된 스냅샷에서 계산된 블록이 여전히 포함되어 있을 수 있습니다. 이후의 sync로 인해 해당 스냅샷이 교체되어 복구에 필요한 중간 버전의 파일을 사용할 수 없게 될 수 있습니다. +.SS 파일 시스템 스냅샷을 사용한 외부 백업 (External backups with filesystem snapshots) +파일 시스템 스냅샷이 활성화되면 SnapRAID는 각 데이터 서브볼륨, 볼륨 또는 +데이터셋의 루트에서 스냅샷에 접근하거나 생성합니다. +.PP +외부 도구와의 간섭을 피하는 간단한 방법은 서브볼륨이나 볼륨 내의 일반 +하위 디렉터리(예: \`/mnt/subvol\` 대신 \`/mnt/subvol/data\`)를 가리키도록 +\`data\` 를 설정하는 것입니다. SnapRAID는 항상 서브볼륨 루트에 스냅샷 디렉터리를 +생성하므로(예: \`/mnt/subvol/.snapraid/\`), 데이터 하위 디렉터리를 깨끗하게 +유지하여 해당 디렉터리 내에서 작동하는 백업 도구에 스냅샷이 노출되지 않도록 합니다. +.PP +그렇지 않고 설정된 \`data\` 디렉터리 자체가 서브볼륨이나 볼륨 루트인 경우, +SnapRAID는 해당 디렉터리 바로 안에 \`.snapraid/\` 디렉터리를 생성합니다(Btrfs, +Bcachefs 및 NTFS). SnapRAID 자체 스캔에서는 이 디렉터리가 자동으로 제외되지만, +외부 백업 도구나 파일 동기화 도구는 이를 발견하게 됩니다. 제외하지 않으면 +스냅샷이나 디렉터리 링크를 탐색하여 동결된 전체 데이터 트리를 복사함으로써 +데이터를 중복 생성하고 백업 저장 공간을 고갈시킬 수 있습니다. 항상 외부 백업 +도구에서 \`.snapraid/\` 디렉터리를 제외하도록 구성하십시오. +.PP +ZFS에서는 스냅샷이 \`.snapraid/\` 대신 표준 가상 디렉터리인 \`.zfs/snapshot/\` 을 +통해 노출됩니다. 기본값(\`snapdir=hidden\`)에서는 ZFS가 디렉터리 목록에서 이 +디렉터리를 숨기므로 외부 백업 도구가 이를 탐색하지 않습니다. \`snapdir=visible\` 로 +설정한 경우 백업 도구에서 \`.zfs/\` 디렉터리를 제외하도록 하십시오. .SH 패턴 (PATTERN) 패턴은 포함하거나 제외할 파일을 필터링하는 유연한 방법을 제공합니다. 글로빙(globbing) 문자를 사용하면 모든 경로를 일일이 나열하지 않고도 diff --git a/doc/snapraid-ko.d b/doc/snapraid-ko.d index 896fc3f7..181827b1 100644 --- a/doc/snapraid-ko.d +++ b/doc/snapraid-ko.d @@ -1482,6 +1482,29 @@ Name{number} 여전히 포함되어 있을 수 있습니다. 이후의 sync로 인해 해당 스냅샷이 교체되어 복구에 필요한 중간 버전의 파일을 사용할 수 없게 될 수 있습니다. + 파일 시스템 스냅샷을 사용한 외부 백업 (External backups with filesystem snapshots) + 파일 시스템 스냅샷이 활성화되면 SnapRAID는 각 데이터 서브볼륨, 볼륨 또는 + 데이터셋의 루트에서 스냅샷에 접근하거나 생성합니다. + + 외부 도구와의 간섭을 피하는 간단한 방법은 서브볼륨이나 볼륨 내의 일반 + 하위 디렉터리(예: `/mnt/subvol` 대신 `/mnt/subvol/data`)를 가리키도록 + `data` 를 설정하는 것입니다. SnapRAID는 항상 서브볼륨 루트에 스냅샷 디렉터리를 + 생성하므로(예: `/mnt/subvol/.snapraid/`), 데이터 하위 디렉터리를 깨끗하게 + 유지하여 해당 디렉터리 내에서 작동하는 백업 도구에 스냅샷이 노출되지 않도록 합니다. + + 그렇지 않고 설정된 `data` 디렉터리 자체가 서브볼륨이나 볼륨 루트인 경우, + SnapRAID는 해당 디렉터리 바로 안에 `.snapraid/` 디렉터리를 생성합니다(Btrfs, + Bcachefs 및 NTFS). SnapRAID 자체 스캔에서는 이 디렉터리가 자동으로 제외되지만, + 외부 백업 도구나 파일 동기화 도구는 이를 발견하게 됩니다. 제외하지 않으면 + 스냅샷이나 디렉터리 링크를 탐색하여 동결된 전체 데이터 트리를 복사함으로써 + 데이터를 중복 생성하고 백업 저장 공간을 고갈시킬 수 있습니다. 항상 외부 백업 + 도구에서 `.snapraid/` 디렉터리를 제외하도록 구성하십시오. + + ZFS에서는 스냅샷이 `.snapraid/` 대신 표준 가상 디렉터리인 `.zfs/snapshot/` 을 + 통해 노출됩니다. 기본값(`snapdir=hidden`)에서는 ZFS가 디렉터리 목록에서 이 + 디렉터리를 숨기므로 외부 백업 도구가 이를 탐색하지 않습니다. `snapdir=visible` 로 + 설정한 경우 백업 도구에서 `.zfs/` 디렉터리를 제외하도록 하십시오. + 패턴 (Pattern) 패턴은 포함하거나 제외할 파일을 필터링하는 유연한 방법을 제공합니다. 글로빙(globbing) 문자를 사용하면 모든 경로를 일일이 나열하지 않고도 diff --git a/doc/snapraid-ko.txt b/doc/snapraid-ko.txt index db1e385d..0bc5dd8b 100644 --- a/doc/snapraid-ko.txt +++ b/doc/snapraid-ko.txt @@ -1592,6 +1592,31 @@ ZFS에서는 표준 `.zfs/snapshot/` 이 사용됩니다. 여전히 포함되어 있을 수 있습니다. 이후의 sync로 인해 해당 스냅샷이 교체되어 복구에 필요한 중간 버전의 파일을 사용할 수 없게 될 수 있습니다. +9.1 파일 시스템 스냅샷을 사용한 외부 백업 (External backups with filesystem snapshots) +---------------------------------------------------------------------- + +파일 시스템 스냅샷이 활성화되면 SnapRAID는 각 데이터 서브볼륨, 볼륨 또는 +데이터셋의 루트에서 스냅샷에 접근하거나 생성합니다. + +외부 도구와의 간섭을 피하는 간단한 방법은 서브볼륨이나 볼륨 내의 일반 +하위 디렉터리(예: `/mnt/subvol` 대신 `/mnt/subvol/data`)를 가리키도록 +`data` 를 설정하는 것입니다. SnapRAID는 항상 서브볼륨 루트에 스냅샷 디렉터리를 +생성하므로(예: `/mnt/subvol/.snapraid/`), 데이터 하위 디렉터리를 깨끗하게 +유지하여 해당 디렉터리 내에서 작동하는 백업 도구에 스냅샷이 노출되지 않도록 합니다. + +그렇지 않고 설정된 `data` 디렉터리 자체가 서브볼륨이나 볼륨 루트인 경우, +SnapRAID는 해당 디렉터리 바로 안에 `.snapraid/` 디렉터리를 생성합니다(Btrfs, +Bcachefs 및 NTFS). SnapRAID 자체 스캔에서는 이 디렉터리가 자동으로 제외되지만, +외부 백업 도구나 파일 동기화 도구는 이를 발견하게 됩니다. 제외하지 않으면 +스냅샷이나 디렉터리 링크를 탐색하여 동결된 전체 데이터 트리를 복사함으로써 +데이터를 중복 생성하고 백업 저장 공간을 고갈시킬 수 있습니다. 항상 외부 백업 +도구에서 `.snapraid/` 디렉터리를 제외하도록 구성하십시오. + +ZFS에서는 스냅샷이 `.snapraid/` 대신 표준 가상 디렉터리인 `.zfs/snapshot/` 을 +통해 노출됩니다. 기본값(`snapdir=hidden`)에서는 ZFS가 디렉터리 목록에서 이 +디렉터리를 숨기므로 외부 백업 도구가 이를 탐색하지 않습니다. `snapdir=visible` 로 +설정한 경우 백업 도구에서 `.zfs/` 디렉터리를 제외하도록 하십시오. + 10 패턴 (PATTERN) =============== diff --git a/doc/snapraid-pl.1 b/doc/snapraid-pl.1 index be4409c7..f58b449d 100644 --- a/doc/snapraid-pl.1 +++ b/doc/snapraid-pl.1 @@ -1954,6 +1954,36 @@ usuwania, zastępowania lub przenoszenia plików do momentu pomyślnego ukończe kolejnej operacji \`sync\`. Parzystość może nadal zawierać bloki obliczone na podstawie migawki użytej przez przerwaną synchronizację. Późniejsza synchronizacja może zastąpić tę migawkę, uniemożliwiając odzyskanie pośrednich wersji plików. +.SS Kopie zapasowe z migawkami systemu plików (External backups with filesystem snapshots) +Gdy migawki systemu plików są włączone, SnapRAID uzyskuje dostęp do migawek +lub tworzy je w katalogu głównym każdego podwoluminu danych, woluminu lub +zestawu danych (dataset). +.PP +Prostym sposobem na uniknięcie jakichkolwiek konfliktów z zewnętrznymi +narzędziami jest wskazanie w konfiguracji \`data\` zwykłego podkatalogu +wewnątrz podwoluminu lub woluminu (na przykład \`/mnt/subvol/data\` zamiast +\`/mnt/subvol\`). SnapRAID zawsze tworzy katalog migawek w katalogu głównym +podwoluminu (na przykład \`/mnt/subvol/.snapraid/\`), pozostawiając podkatalog +danych czysty, dzięki czemu migawki pozostają na zewnątrz i są niewidoczne +dla narzędzi do tworzenia kopii zapasowych działających w tym katalogu. +.PP +W przeciwnym razie, jeśli skonfigurowany katalog \`data\` jest sam w sobie +katalogiem głównym podwoluminu lub woluminu, SnapRAID utworzy katalog +\`.snapraid/\` bezpośrednio w nim (w systemach Btrfs, Bcachefs i NTFS). +Chociaż SnapRAID automatycznie wyklucza ten katalog z własnego skanowania, +zewnętrzne narzędzia do tworzenia kopii zapasowych lub synchronizacji +plików napotkają go. Jeśli nie zostanie wykluczony, mogą wejść do migawek +lub dowiązań katalogów i skopiować całe zamrożone drzewo danych, duplikując +dane i wyczerpując przestrzeń dyskową kopii zapasowej. Zawsze konfiguruj +zewnętrzne narzędzia do tworzenia kopii zapasowych tak, aby wykluczały +katalog \`.snapraid/\`. +.PP +W systemie ZFS migawki są udostępniane za pośrednictwem standardowego +katalogu wirtualnego \`.zfs/snapshot/\` zamiast \`.snapraid/\`. Domyślnie +(\`snapdir=hidden\`) system ZFS ukrywa ten katalog na listach katalogów, więc +zewnętrzne narzędzia do tworzenia kopii zapasowych go nie przeskanują. Jeśli +włączono opcję \`snapdir=visible\`, upewnij się, że narzędzia do tworzenia kopii +zapasowych wykluczają katalog \`.zfs/\`. .SH WZORCE (PATTERN) Wzorce zapewniają elastyczny sposób filtrowania plików do uwzględnienia lub wykluczenia. Używając znaków globbingowych, można zdefiniować reguły, które diff --git a/doc/snapraid-pl.d b/doc/snapraid-pl.d index 164a97ab..5994af30 100644 --- a/doc/snapraid-pl.d +++ b/doc/snapraid-pl.d @@ -1559,6 +1559,37 @@ Cykl życia migawek (Snapshots Lifecycle) migawki użytej przez przerwaną synchronizację. Późniejsza synchronizacja może zastąpić tę migawkę, uniemożliwiając odzyskanie pośrednich wersji plików. + Kopie zapasowe z migawkami systemu plików (External backups with filesystem snapshots) + Gdy migawki systemu plików są włączone, SnapRAID uzyskuje dostęp do migawek + lub tworzy je w katalogu głównym każdego podwoluminu danych, woluminu lub + zestawu danych (dataset). + + Prostym sposobem na uniknięcie jakichkolwiek konfliktów z zewnętrznymi + narzędziami jest wskazanie w konfiguracji `data` zwykłego podkatalogu + wewnątrz podwoluminu lub woluminu (na przykład `/mnt/subvol/data` zamiast + `/mnt/subvol`). SnapRAID zawsze tworzy katalog migawek w katalogu głównym + podwoluminu (na przykład `/mnt/subvol/.snapraid/`), pozostawiając podkatalog + danych czysty, dzięki czemu migawki pozostają na zewnątrz i są niewidoczne + dla narzędzi do tworzenia kopii zapasowych działających w tym katalogu. + + W przeciwnym razie, jeśli skonfigurowany katalog `data` jest sam w sobie + katalogiem głównym podwoluminu lub woluminu, SnapRAID utworzy katalog + `.snapraid/` bezpośrednio w nim (w systemach Btrfs, Bcachefs i NTFS). + Chociaż SnapRAID automatycznie wyklucza ten katalog z własnego skanowania, + zewnętrzne narzędzia do tworzenia kopii zapasowych lub synchronizacji + plików napotkają go. Jeśli nie zostanie wykluczony, mogą wejść do migawek + lub dowiązań katalogów i skopiować całe zamrożone drzewo danych, duplikując + dane i wyczerpując przestrzeń dyskową kopii zapasowej. Zawsze konfiguruj + zewnętrzne narzędzia do tworzenia kopii zapasowych tak, aby wykluczały + katalog `.snapraid/`. + + W systemie ZFS migawki są udostępniane za pośrednictwem standardowego + katalogu wirtualnego `.zfs/snapshot/` zamiast `.snapraid/`. Domyślnie + (`snapdir=hidden`) system ZFS ukrywa ten katalog na listach katalogów, więc + zewnętrzne narzędzia do tworzenia kopii zapasowych go nie przeskanują. Jeśli + włączono opcję `snapdir=visible`, upewnij się, że narzędzia do tworzenia kopii + zapasowych wykluczają katalog `.zfs/`. + Wzorce (Pattern) Wzorce zapewniają elastyczny sposób filtrowania plików do uwzględnienia lub wykluczenia. Używając znaków globbingowych, można zdefiniować reguły, które diff --git a/doc/snapraid-pl.txt b/doc/snapraid-pl.txt index 8b7af044..8ad42b3c 100644 --- a/doc/snapraid-pl.txt +++ b/doc/snapraid-pl.txt @@ -1669,6 +1669,39 @@ kolejnej operacji `sync`. Parzystość może nadal zawierać bloki obliczone na migawki użytej przez przerwaną synchronizację. Późniejsza synchronizacja może zastąpić tę migawkę, uniemożliwiając odzyskanie pośrednich wersji plików. +9.1 Kopie zapasowe z migawkami systemu plików (External backups with filesystem snapshots) +------------------------------------------------------------------------------------------ + +Gdy migawki systemu plików są włączone, SnapRAID uzyskuje dostęp do migawek +lub tworzy je w katalogu głównym każdego podwoluminu danych, woluminu lub +zestawu danych (dataset). + +Prostym sposobem na uniknięcie jakichkolwiek konfliktów z zewnętrznymi +narzędziami jest wskazanie w konfiguracji `data` zwykłego podkatalogu +wewnątrz podwoluminu lub woluminu (na przykład `/mnt/subvol/data` zamiast +`/mnt/subvol`). SnapRAID zawsze tworzy katalog migawek w katalogu głównym +podwoluminu (na przykład `/mnt/subvol/.snapraid/`), pozostawiając podkatalog +danych czysty, dzięki czemu migawki pozostają na zewnątrz i są niewidoczne +dla narzędzi do tworzenia kopii zapasowych działających w tym katalogu. + +W przeciwnym razie, jeśli skonfigurowany katalog `data` jest sam w sobie +katalogiem głównym podwoluminu lub woluminu, SnapRAID utworzy katalog +`.snapraid/` bezpośrednio w nim (w systemach Btrfs, Bcachefs i NTFS). +Chociaż SnapRAID automatycznie wyklucza ten katalog z własnego skanowania, +zewnętrzne narzędzia do tworzenia kopii zapasowych lub synchronizacji +plików napotkają go. Jeśli nie zostanie wykluczony, mogą wejść do migawek +lub dowiązań katalogów i skopiować całe zamrożone drzewo danych, duplikując +dane i wyczerpując przestrzeń dyskową kopii zapasowej. Zawsze konfiguruj +zewnętrzne narzędzia do tworzenia kopii zapasowych tak, aby wykluczały +katalog `.snapraid/`. + +W systemie ZFS migawki są udostępniane za pośrednictwem standardowego +katalogu wirtualnego `.zfs/snapshot/` zamiast `.snapraid/`. Domyślnie +(`snapdir=hidden`) system ZFS ukrywa ten katalog na listach katalogów, więc +zewnętrzne narzędzia do tworzenia kopii zapasowych go nie przeskanują. Jeśli +włączono opcję `snapdir=visible`, upewnij się, że narzędzia do tworzenia kopii +zapasowych wykluczają katalog `.zfs/`. + 10 WZORCE (PATTERN) =================== diff --git a/doc/snapraid-pt.1 b/doc/snapraid-pt.1 index 08ad589a..42c6fa53 100644 --- a/doc/snapraid-pt.1 +++ b/doc/snapraid-pt.1 @@ -1992,6 +1992,36 @@ com sucesso. A paridade ainda pode conter blocos calculados a partir do instantâneo usado pelo sync interrompido. Um sync posterior pode substituir esse instantâneo, tornando as versões intermediárias dos arquivos indisponíveis para recuperação. +.SS Cópias de segurança externas com instantâneos do sistema de ficheiros (External backups with filesystem snapshots) +Quando os instantâneos do sistema de ficheiros estão ativados, o SnapRAID +acede ou cria instantâneos na raiz de cada subvolume, volume ou conjunto +de dados (dataset). +.PP +Uma forma simples de evitar qualquer interferência com ferramentas externas +é apontar a configuração \`data\` para um subdiretório normal dentro do +subvolume ou volume (por exemplo, \`/mnt/subvol/data\` em vez de \`/mnt/subvol\`). +O SnapRAID cria sempre o diretório de instantâneos na raiz do subvolume +(por exemplo, \`/mnt/subvol/.snapraid/\`), deixando o subdiretório de dados +limpo, de modo que os instantâneos permaneçam fora e invisíveis para as +ferramentas de cópia de segurança que operam dentro dele. +.PP +Caso contrário, se o diretório \`data\` configurado for ele próprio a raiz +do subvolume ou do volume, o SnapRAID cria um diretório \`.snapraid/\` +diretamente dentro dele (em Btrfs, Bcachefs e NTFS). Embora o SnapRAID +exclua automaticamente esse diretório das suas próprias verificações, +ferramentas externas de cópia de segurança ou de sincronização irão +encontrá\-lo. Se não for excluído, podem atravessar os instantâneos ou +ligações de diretório e copiar toda a árvore de dados congelada, duplicando +dados e esgotando o armazenamento de backup. Configure sempre as +ferramentas de cópia de segurança externas para excluir o diretório +\`.snapraid/\`. +.PP +No ZFS, os instantâneos são expostos através do diretório virtual padrão +\`.zfs/snapshot/\` em vez de \`.snapraid/\`. Por predefinição (\`snapdir=hidden\`), +o ZFS oculta esse diretório das listagens, de modo que ferramentas externas +de cópia de segurança não o percorrem. Se tiver ativado \`snapdir=visible\`, +certifique\-se de que as suas ferramentas de cópia de segurança excluem o +diretório \`.zfs/\`. .SH PADRãO (PATTERN) Os padrões fornecem uma maneira flexível de filtrar arquivos para inclusão ou exclusão. Ao usar caracteres de globbing, você pode definir regras que diff --git a/doc/snapraid-pt.d b/doc/snapraid-pt.d index e18a4cbd..029e06b1 100644 --- a/doc/snapraid-pt.d +++ b/doc/snapraid-pt.d @@ -1597,6 +1597,37 @@ Ciclo de Vida dos Instantâneos (Snapshots Lifecycle) esse instantâneo, tornando as versões intermediárias dos arquivos indisponíveis para recuperação. + Cópias de segurança externas com instantâneos do sistema de ficheiros (External backups with filesystem snapshots) + Quando os instantâneos do sistema de ficheiros estão ativados, o SnapRAID + acede ou cria instantâneos na raiz de cada subvolume, volume ou conjunto + de dados (dataset). + + Uma forma simples de evitar qualquer interferência com ferramentas externas + é apontar a configuração `data` para um subdiretório normal dentro do + subvolume ou volume (por exemplo, `/mnt/subvol/data` em vez de `/mnt/subvol`). + O SnapRAID cria sempre o diretório de instantâneos na raiz do subvolume + (por exemplo, `/mnt/subvol/.snapraid/`), deixando o subdiretório de dados + limpo, de modo que os instantâneos permaneçam fora e invisíveis para as + ferramentas de cópia de segurança que operam dentro dele. + + Caso contrário, se o diretório `data` configurado for ele próprio a raiz + do subvolume ou do volume, o SnapRAID cria um diretório `.snapraid/` + diretamente dentro dele (em Btrfs, Bcachefs e NTFS). Embora o SnapRAID + exclua automaticamente esse diretório das suas próprias verificações, + ferramentas externas de cópia de segurança ou de sincronização irão + encontrá-lo. Se não for excluído, podem atravessar os instantâneos ou + ligações de diretório e copiar toda a árvore de dados congelada, duplicando + dados e esgotando o armazenamento de backup. Configure sempre as + ferramentas de cópia de segurança externas para excluir o diretório + `.snapraid/`. + + No ZFS, os instantâneos são expostos através do diretório virtual padrão + `.zfs/snapshot/` em vez de `.snapraid/`. Por predefinição (`snapdir=hidden`), + o ZFS oculta esse diretório das listagens, de modo que ferramentas externas + de cópia de segurança não o percorrem. Se tiver ativado `snapdir=visible`, + certifique-se de que as suas ferramentas de cópia de segurança excluem o + diretório `.zfs/`. + Padrão (Pattern) Os padrões fornecem uma maneira flexível de filtrar arquivos para inclusão ou exclusão. Ao usar caracteres de globbing, você pode definir regras que diff --git a/doc/snapraid-pt.txt b/doc/snapraid-pt.txt index a6d6edb4..654c4c93 100644 --- a/doc/snapraid-pt.txt +++ b/doc/snapraid-pt.txt @@ -1707,6 +1707,39 @@ instantâneo usado pelo sync interrompido. Um sync posterior pode substituir esse instantâneo, tornando as versões intermediárias dos arquivos indisponíveis para recuperação. +9.1 Cópias de segurança externas com instantâneos do sistema de ficheiros (External backups with filesystem snapshots) +---------------------------------------------------------------------------------------------------------------------- + +Quando os instantâneos do sistema de ficheiros estão ativados, o SnapRAID +acede ou cria instantâneos na raiz de cada subvolume, volume ou conjunto +de dados (dataset). + +Uma forma simples de evitar qualquer interferência com ferramentas externas +é apontar a configuração `data` para um subdiretório normal dentro do +subvolume ou volume (por exemplo, `/mnt/subvol/data` em vez de `/mnt/subvol`). +O SnapRAID cria sempre o diretório de instantâneos na raiz do subvolume +(por exemplo, `/mnt/subvol/.snapraid/`), deixando o subdiretório de dados +limpo, de modo que os instantâneos permaneçam fora e invisíveis para as +ferramentas de cópia de segurança que operam dentro dele. + +Caso contrário, se o diretório `data` configurado for ele próprio a raiz +do subvolume ou do volume, o SnapRAID cria um diretório `.snapraid/` +diretamente dentro dele (em Btrfs, Bcachefs e NTFS). Embora o SnapRAID +exclua automaticamente esse diretório das suas próprias verificações, +ferramentas externas de cópia de segurança ou de sincronização irão +encontrá-lo. Se não for excluído, podem atravessar os instantâneos ou +ligações de diretório e copiar toda a árvore de dados congelada, duplicando +dados e esgotando o armazenamento de backup. Configure sempre as +ferramentas de cópia de segurança externas para excluir o diretório +`.snapraid/`. + +No ZFS, os instantâneos são expostos através do diretório virtual padrão +`.zfs/snapshot/` em vez de `.snapraid/`. Por predefinição (`snapdir=hidden`), +o ZFS oculta esse diretório das listagens, de modo que ferramentas externas +de cópia de segurança não o percorrem. Se tiver ativado `snapdir=visible`, +certifique-se de que as suas ferramentas de cópia de segurança excluem o +diretório `.zfs/`. + 10 PADRãO (PATTERN) =================== diff --git a/doc/snapraid-ro.1 b/doc/snapraid-ro.1 index a9036c6f..1d509188 100644 --- a/doc/snapraid-ro.1 +++ b/doc/snapraid-ro.1 @@ -1952,6 +1952,36 @@ cu succes. Paritatea poate conține în continuare blocuri calculate din snapshot\-ul utilizat de sync\-ul întrerupt. Un sync ulterior poate înlocui acel snapshot, făcând versiunile intermediare ale fișierelor indisponibile pentru recuperare. +.SS Copii de rezervă externe cu snapshot\-uri de sistem de fișiere (External backups with filesystem snapshots) +Când snapshot\-urile sistemului de fișiere sunt activate, SnapRAID accesează +sau creează snapshot\-uri la rădăcina fiecărui subvolum, volum sau set de +date (dataset). +.PP +O modalitate simplă de a evita orice interferență cu instrumentele externe +este de a configura discul \`data\` astfel încât să indice spre un subdirector +obișnuit din cadrul subvolumului sau volumului (de exemplu +\`/mnt/subvol/data\` în loc de \`/mnt/subvol\`). SnapRAID creează întotdeauna +directorul de snapshot\-uri la rădăcina subvolumului (de exemplu +\`/mnt/subvol/.snapraid/\`), lăsând subdirectorul de date curat, astfel încât +snapshot\-urile să rămână în exterior și invizibile pentru instrumentele de +backup care operează în interiorul său. +.PP +În caz contrar, dacă directorul \`data\` configurat este chiar rădăcina +subvolumului sau a volumului, SnapRAID creează un director \`.snapraid/\` +direct în interiorul acestuia (pe Btrfs, Bcachefs și NTFS). Deși SnapRAID +exclude automat acest director din scanarea proprie, instrumentele externe +de backup sau sincronizare îl vor întâlni. Dacă nu este exclus, acestea pot +traversa snapshot\-urile sau legăturile de directoare și pot copia întregul +arbore de date înghețat, duplicând datele și epuizând spațiul de stocare al +backup\-ului. Configurați întotdeauna instrumentele externe de backup să +excludă directorul \`.snapraid/\`. +.PP +Pe ZFS, snapshot\-urile sunt expuse prin directorul virtual standard +\`.zfs/snapshot/\` în loc de \`.snapraid/\`. În mod implicit (\`snapdir=hidden\`), +ZFS ascunde acest director din listările de directoare, astfel încât +instrumentele externe de backup nu îl vor parcurge. Dacă ați activat +\`snapdir=visible\`, asigurați\-vă că instrumentele de backup exclud +directorul \`.zfs/\`. .SH MODEL (PATTERN) Modelele oferă o modalitate flexibilă de a filtra fișierele pentru includere sau excludere. Folosind caractere de tip globbing, puteți defini reguli care să diff --git a/doc/snapraid-ro.d b/doc/snapraid-ro.d index 3da8a3a9..e9d89159 100644 --- a/doc/snapraid-ro.d +++ b/doc/snapraid-ro.d @@ -1557,6 +1557,37 @@ Ciclul de viață al snapshot-urilor (Snapshots Lifecycle) acel snapshot, făcând versiunile intermediare ale fișierelor indisponibile pentru recuperare. + Copii de rezervă externe cu snapshot-uri de sistem de fișiere (External backups with filesystem snapshots) + Când snapshot-urile sistemului de fișiere sunt activate, SnapRAID accesează + sau creează snapshot-uri la rădăcina fiecărui subvolum, volum sau set de + date (dataset). + + O modalitate simplă de a evita orice interferență cu instrumentele externe + este de a configura discul `data` astfel încât să indice spre un subdirector + obișnuit din cadrul subvolumului sau volumului (de exemplu + `/mnt/subvol/data` în loc de `/mnt/subvol`). SnapRAID creează întotdeauna + directorul de snapshot-uri la rădăcina subvolumului (de exemplu + `/mnt/subvol/.snapraid/`), lăsând subdirectorul de date curat, astfel încât + snapshot-urile să rămână în exterior și invizibile pentru instrumentele de + backup care operează în interiorul său. + + În caz contrar, dacă directorul `data` configurat este chiar rădăcina + subvolumului sau a volumului, SnapRAID creează un director `.snapraid/` + direct în interiorul acestuia (pe Btrfs, Bcachefs și NTFS). Deși SnapRAID + exclude automat acest director din scanarea proprie, instrumentele externe + de backup sau sincronizare îl vor întâlni. Dacă nu este exclus, acestea pot + traversa snapshot-urile sau legăturile de directoare și pot copia întregul + arbore de date înghețat, duplicând datele și epuizând spațiul de stocare al + backup-ului. Configurați întotdeauna instrumentele externe de backup să + excludă directorul `.snapraid/`. + + Pe ZFS, snapshot-urile sunt expuse prin directorul virtual standard + `.zfs/snapshot/` în loc de `.snapraid/`. În mod implicit (`snapdir=hidden`), + ZFS ascunde acest director din listările de directoare, astfel încât + instrumentele externe de backup nu îl vor parcurge. Dacă ați activat + `snapdir=visible`, asigurați-vă că instrumentele de backup exclud + directorul `.zfs/`. + Model (Pattern) Modelele oferă o modalitate flexibilă de a filtra fișierele pentru includere sau excludere. Folosind caractere de tip globbing, puteți defini reguli care să diff --git a/doc/snapraid-ro.txt b/doc/snapraid-ro.txt index 6a3e3880..c9d9a2ff 100644 --- a/doc/snapraid-ro.txt +++ b/doc/snapraid-ro.txt @@ -1667,6 +1667,39 @@ snapshot-ul utilizat de sync-ul întrerupt. Un sync ulterior poate înlocui acel snapshot, făcând versiunile intermediare ale fișierelor indisponibile pentru recuperare. +9.1 Copii de rezervă externe cu snapshot-uri de sistem de fișiere (External backups with filesystem snapshots) +-------------------------------------------------------------------------------------------------------------- + +Când snapshot-urile sistemului de fișiere sunt activate, SnapRAID accesează +sau creează snapshot-uri la rădăcina fiecărui subvolum, volum sau set de +date (dataset). + +O modalitate simplă de a evita orice interferență cu instrumentele externe +este de a configura discul `data` astfel încât să indice spre un subdirector +obișnuit din cadrul subvolumului sau volumului (de exemplu +`/mnt/subvol/data` în loc de `/mnt/subvol`). SnapRAID creează întotdeauna +directorul de snapshot-uri la rădăcina subvolumului (de exemplu +`/mnt/subvol/.snapraid/`), lăsând subdirectorul de date curat, astfel încât +snapshot-urile să rămână în exterior și invizibile pentru instrumentele de +backup care operează în interiorul său. + +În caz contrar, dacă directorul `data` configurat este chiar rădăcina +subvolumului sau a volumului, SnapRAID creează un director `.snapraid/` +direct în interiorul acestuia (pe Btrfs, Bcachefs și NTFS). Deși SnapRAID +exclude automat acest director din scanarea proprie, instrumentele externe +de backup sau sincronizare îl vor întâlni. Dacă nu este exclus, acestea pot +traversa snapshot-urile sau legăturile de directoare și pot copia întregul +arbore de date înghețat, duplicând datele și epuizând spațiul de stocare al +backup-ului. Configurați întotdeauna instrumentele externe de backup să +excludă directorul `.snapraid/`. + +Pe ZFS, snapshot-urile sunt expuse prin directorul virtual standard +`.zfs/snapshot/` în loc de `.snapraid/`. În mod implicit (`snapdir=hidden`), +ZFS ascunde acest director din listările de directoare, astfel încât +instrumentele externe de backup nu îl vor parcurge. Dacă ați activat +`snapdir=visible`, asigurați-vă că instrumentele de backup exclud +directorul `.zfs/`. + 10 MODEL (PATTERN) ================== diff --git a/doc/snapraid-ru.1 b/doc/snapraid-ru.1 index bcfb9ca0..4b5e257f 100644 --- a/doc/snapraid-ru.1 +++ b/doc/snapraid-ru.1 @@ -1957,6 +1957,34 @@ SnapRAID управляет тремя конкретными снимками, использованного прерванной синхронизацией. Более поздняя синхронизация может заменить этот снимок, сделав промежуточные версии файлов недоступными для восстановления. +.SS Внешнее резервное копирование со снимками файловой системы (External backups with filesystem snapshots) +Когда снимки файловой системы включены, SnapRAID обращается к снимкам или +создает их в корне каждого подтома, тома или набора данных (dataset). +.PP +Простой способ избежать любых конфликтов со сторонними инструментами — +указать в директиве \`data\` обычный подкаталог внутри подтома или тома +(например, \`/mnt/subvol/data\` вместо \`/mnt/subvol\`). SnapRAID всегда +создает каталог снимков в корне подтома (например, +\`/mnt/subvol/.snapraid/\`), оставив подкаталог данных чистым, благодаря +чему снимки останутся снаружи и будут невидимы для программ резервного +копирования, работающих внутри него. +.PP +В противном случае, если настроенный каталог \`data\` сам по себе является +корнем подтома или тома, SnapRAID создает каталог \`.snapraid/\` прямо внутри +него (в Btrfs, Bcachefs и NTFS). Хотя SnapRAID автоматически исключает этот +каталог из собственного сканирования, внешние утилиты резервного +копирования или синхронизации файлов обнаружат его. Если каталог не +исключен, они могут войти в снимки или ссылки на каталоги и скопировать +все замороженное дерево данных, дублируя файлы и исчерпывая место в +хранилище резервных копий. Всегда настраивайте внешние утилиты резервного +копирования на исключение каталога \`.snapraid/\`. +.PP +В ZFS снимки доступны через стандартный виртуальный каталог +\`.zfs/snapshot/\`, а не через \`.snapraid/\`. По умолчанию (\`snapdir=hidden\`) +ZFS скрывает этот каталог из списков директорий, поэтому внешние утилиты +резервного копирования не будут сканировать его. Если вы включили +\`snapdir=visible\`, обязательно настройте утилиты резервного копирования на +исключение каталога \`.zfs/\`. .SH Шаблон (PATTERN) Шаблоны обеспечивают гибкий способ фильтрации файлов для включения или исключения. Используя символы подстановки (globbing), вы можете определить правила, diff --git a/doc/snapraid-ru.d b/doc/snapraid-ru.d index c2097a95..2ce06ad5 100644 --- a/doc/snapraid-ru.d +++ b/doc/snapraid-ru.d @@ -1564,6 +1564,35 @@ Name{number} заменить этот снимок, сделав промежуточные версии файлов недоступными для восстановления. + Внешнее резервное копирование со снимками файловой системы (External backups with filesystem snapshots) + Когда снимки файловой системы включены, SnapRAID обращается к снимкам или + создает их в корне каждого подтома, тома или набора данных (dataset). + + Простой способ избежать любых конфликтов со сторонними инструментами — + указать в директиве `data` обычный подкаталог внутри подтома или тома + (например, `/mnt/subvol/data` вместо `/mnt/subvol`). SnapRAID всегда + создает каталог снимков в корне подтома (например, + `/mnt/subvol/.snapraid/`), оставив подкаталог данных чистым, благодаря + чему снимки останутся снаружи и будут невидимы для программ резервного + копирования, работающих внутри него. + + В противном случае, если настроенный каталог `data` сам по себе является + корнем подтома или тома, SnapRAID создает каталог `.snapraid/` прямо внутри + него (в Btrfs, Bcachefs и NTFS). Хотя SnapRAID автоматически исключает этот + каталог из собственного сканирования, внешние утилиты резервного + копирования или синхронизации файлов обнаружат его. Если каталог не + исключен, они могут войти в снимки или ссылки на каталоги и скопировать + все замороженное дерево данных, дублируя файлы и исчерпывая место в + хранилище резервных копий. Всегда настраивайте внешние утилиты резервного + копирования на исключение каталога `.snapraid/`. + + В ZFS снимки доступны через стандартный виртуальный каталог + `.zfs/snapshot/`, а не через `.snapraid/`. По умолчанию (`snapdir=hidden`) + ZFS скрывает этот каталог из списков директорий, поэтому внешние утилиты + резервного копирования не будут сканировать его. Если вы включили + `snapdir=visible`, обязательно настройте утилиты резервного копирования на + исключение каталога `.zfs/`. + Шаблон (Pattern) Шаблоны обеспечивают гибкий способ фильтрации файлов для включения или исключения. Используя символы подстановки (globbing), вы можете определить правила, diff --git a/doc/snapraid-ru.txt b/doc/snapraid-ru.txt index 7133e41b..e1f6a0e6 100644 --- a/doc/snapraid-ru.txt +++ b/doc/snapraid-ru.txt @@ -1674,6 +1674,37 @@ SnapRAID управляет тремя конкретными снимками, заменить этот снимок, сделав промежуточные версии файлов недоступными для восстановления. +9.1 Внешнее резервное копирование со снимками файловой системы (External backups with filesystem snapshots) +----------------------------------------------------------------------------------------------------------- + +Когда снимки файловой системы включены, SnapRAID обращается к снимкам или +создает их в корне каждого подтома, тома или набора данных (dataset). + +Простой способ избежать любых конфликтов со сторонними инструментами — +указать в директиве `data` обычный подкаталог внутри подтома или тома +(например, `/mnt/subvol/data` вместо `/mnt/subvol`). SnapRAID всегда +создает каталог снимков в корне подтома (например, +`/mnt/subvol/.snapraid/`), оставив подкаталог данных чистым, благодаря +чему снимки останутся снаружи и будут невидимы для программ резервного +копирования, работающих внутри него. + +В противном случае, если настроенный каталог `data` сам по себе является +корнем подтома или тома, SnapRAID создает каталог `.snapraid/` прямо внутри +него (в Btrfs, Bcachefs и NTFS). Хотя SnapRAID автоматически исключает этот +каталог из собственного сканирования, внешние утилиты резервного +копирования или синхронизации файлов обнаружат его. Если каталог не +исключен, они могут войти в снимки или ссылки на каталоги и скопировать +все замороженное дерево данных, дублируя файлы и исчерпывая место в +хранилище резервных копий. Всегда настраивайте внешние утилиты резервного +копирования на исключение каталога `.snapraid/`. + +В ZFS снимки доступны через стандартный виртуальный каталог +`.zfs/snapshot/`, а не через `.snapraid/`. По умолчанию (`snapdir=hidden`) +ZFS скрывает этот каталог из списков директорий, поэтому внешние утилиты +резервного копирования не будут сканировать его. Если вы включили +`snapdir=visible`, обязательно настройте утилиты резервного копирования на +исключение каталога `.zfs/`. + 10 Шаблон (PATTERN) =================== diff --git a/doc/snapraid-sv.1 b/doc/snapraid-sv.1 index 9173ff54..769baa66 100644 --- a/doc/snapraid-sv.1 +++ b/doc/snapraid-sv.1 @@ -1953,6 +1953,34 @@ framgångsrikt. Pariteten kan fortfarande innehålla block som beräknats från ögonblicksbilden som användes av den avbrutna synkroniseringen. En senare synkronisering kan ersätta den ögonblicksbilden, vilket gör mellanliggande filversioner otillgängliga för återställning. +.SS Externa säkerhetskopior med ögonblicksbilder av filsystem (External backups with filesystem snapshots) +När ögonblicksbilder av filsystem är aktiverade ansluter eller skapar +SnapRAID ögonblicksbilder vid roten av varje dataundervolym, volym eller +datauppsättning (dataset). +.PP +Ett enkelt sätt att undvika konflikter med externa verktyg är att peka +din \`data\`\-konfiguration till en vanlig underkatalog i undervolymen eller +volymen (till exempel \`/mnt/subvol/data\` istället för \`/mnt/subvol\`). +SnapRAID skapar alltid katalogen för ögonblicksbilder i undervolymens rot +(till exempel \`/mnt/subvol/.snapraid/\`), vilket håller underkatalogen för +data ren så att ögonblicksbilderna förblir utanför och osynliga för +säkerhetskopieringsverktyg som arbetar i den. +.PP +Annars, om din konfigurerade \`data\`\-katalog i sig är roten på undervolymen +eller volymen, skapar SnapRAID en \`.snapraid/\`\-katalog direkt i den (på +Btrfs, Bcachefs och NTFS). Även om SnapRAID automatiskt utesluter denna +katalog från sin egen skanning, kommer externa säkerhetskopieringsverktyg +eller synkroniseringsprogram att stöta på den. Om den inte utesluts kan de +gå in i ögonblicksbilderna eller kataloglänkarna och kopiera hela det frysta +dataträdet, vilket duplicerar data och kan tömma lagringsutrymmet för +säkerhetskopior. Konfigurera alltid externa säkerhetskopieringsverktyg till +att utesluta katalogen \`.snapraid/\`. +.PP +På ZFS exponeras ögonblicksbilder via den virtuella standardkatalogen +\`.zfs/snapshot/\` istället för \`.snapraid/\`. Som standard (\`snapdir=hidden\`) +döljer ZFS denna katalog från kataloglistor så att externa säkerhetskopieringsverktyg +inte söker igenom den. Om du har aktiverat \`snapdir=visible\`, se till att dina +säkerhetskopieringsverktyg utesluter katalogen \`.zfs/\`. .SH MöNSTER (PATTERN) Mönster ger ett flexibelt sätt att filtrera filer för inkludering eller exkludering. Genom att använda jokertecken kan du definiera regler som diff --git a/doc/snapraid-sv.d b/doc/snapraid-sv.d index cba81745..c49f0796 100644 --- a/doc/snapraid-sv.d +++ b/doc/snapraid-sv.d @@ -1558,6 +1558,35 @@ Livscykel för ögonblicksbilder (Snapshots Lifecycle) synkronisering kan ersätta den ögonblicksbilden, vilket gör mellanliggande filversioner otillgängliga för återställning. + Externa säkerhetskopior med ögonblicksbilder av filsystem (External backups with filesystem snapshots) + När ögonblicksbilder av filsystem är aktiverade ansluter eller skapar + SnapRAID ögonblicksbilder vid roten av varje dataundervolym, volym eller + datauppsättning (dataset). + + Ett enkelt sätt att undvika konflikter med externa verktyg är att peka + din `data`-konfiguration till en vanlig underkatalog i undervolymen eller + volymen (till exempel `/mnt/subvol/data` istället för `/mnt/subvol`). + SnapRAID skapar alltid katalogen för ögonblicksbilder i undervolymens rot + (till exempel `/mnt/subvol/.snapraid/`), vilket håller underkatalogen för + data ren så att ögonblicksbilderna förblir utanför och osynliga för + säkerhetskopieringsverktyg som arbetar i den. + + Annars, om din konfigurerade `data`-katalog i sig är roten på undervolymen + eller volymen, skapar SnapRAID en `.snapraid/`-katalog direkt i den (på + Btrfs, Bcachefs och NTFS). Även om SnapRAID automatiskt utesluter denna + katalog från sin egen skanning, kommer externa säkerhetskopieringsverktyg + eller synkroniseringsprogram att stöta på den. Om den inte utesluts kan de + gå in i ögonblicksbilderna eller kataloglänkarna och kopiera hela det frysta + dataträdet, vilket duplicerar data och kan tömma lagringsutrymmet för + säkerhetskopior. Konfigurera alltid externa säkerhetskopieringsverktyg till + att utesluta katalogen `.snapraid/`. + + På ZFS exponeras ögonblicksbilder via den virtuella standardkatalogen + `.zfs/snapshot/` istället för `.snapraid/`. Som standard (`snapdir=hidden`) + döljer ZFS denna katalog från kataloglistor så att externa säkerhetskopieringsverktyg + inte söker igenom den. Om du har aktiverat `snapdir=visible`, se till att dina + säkerhetskopieringsverktyg utesluter katalogen `.zfs/`. + Mönster (Pattern) Mönster ger ett flexibelt sätt att filtrera filer för inkludering eller exkludering. Genom att använda jokertecken kan du definiera regler som diff --git a/doc/snapraid-sv.txt b/doc/snapraid-sv.txt index beb8e6a1..59bec6b3 100644 --- a/doc/snapraid-sv.txt +++ b/doc/snapraid-sv.txt @@ -1668,6 +1668,37 @@ framgångsrikt. Pariteten kan fortfarande innehålla block som beräknats från synkronisering kan ersätta den ögonblicksbilden, vilket gör mellanliggande filversioner otillgängliga för återställning. +9.1 Externa säkerhetskopior med ögonblicksbilder av filsystem (External backups with filesystem snapshots) +---------------------------------------------------------------------------------------------------------- + +När ögonblicksbilder av filsystem är aktiverade ansluter eller skapar +SnapRAID ögonblicksbilder vid roten av varje dataundervolym, volym eller +datauppsättning (dataset). + +Ett enkelt sätt att undvika konflikter med externa verktyg är att peka +din `data`-konfiguration till en vanlig underkatalog i undervolymen eller +volymen (till exempel `/mnt/subvol/data` istället för `/mnt/subvol`). +SnapRAID skapar alltid katalogen för ögonblicksbilder i undervolymens rot +(till exempel `/mnt/subvol/.snapraid/`), vilket håller underkatalogen för +data ren så att ögonblicksbilderna förblir utanför och osynliga för +säkerhetskopieringsverktyg som arbetar i den. + +Annars, om din konfigurerade `data`-katalog i sig är roten på undervolymen +eller volymen, skapar SnapRAID en `.snapraid/`-katalog direkt i den (på +Btrfs, Bcachefs och NTFS). Även om SnapRAID automatiskt utesluter denna +katalog från sin egen skanning, kommer externa säkerhetskopieringsverktyg +eller synkroniseringsprogram att stöta på den. Om den inte utesluts kan de +gå in i ögonblicksbilderna eller kataloglänkarna och kopiera hela det frysta +dataträdet, vilket duplicerar data och kan tömma lagringsutrymmet för +säkerhetskopior. Konfigurera alltid externa säkerhetskopieringsverktyg till +att utesluta katalogen `.snapraid/`. + +På ZFS exponeras ögonblicksbilder via den virtuella standardkatalogen +`.zfs/snapshot/` istället för `.snapraid/`. Som standard (`snapdir=hidden`) +döljer ZFS denna katalog från kataloglistor så att externa säkerhetskopieringsverktyg +inte söker igenom den. Om du har aktiverat `snapdir=visible`, se till att dina +säkerhetskopieringsverktyg utesluter katalogen `.zfs/`. + 10 MöNSTER (PATTERN) ==================== diff --git a/doc/snapraid-uk.1 b/doc/snapraid-uk.1 index 766ceae0..ba98c152 100644 --- a/doc/snapraid-uk.1 +++ b/doc/snapraid-uk.1 @@ -2126,6 +2126,34 @@ SnapRAID керує трьома конкретними знімками, \`stab використаного перерваною синхронізацією. Пізніша синхронізація може замінити цей знімок, зробивши проміжні версії файлів недоступними для відновлення. +.SS Зовнішнє резервне копіювання зі знімками файлової системи (External backups with filesystem snapshots) +Коли знімки файлової системи ввімкнено, SnapRAID звертається до знімків або +створює їх у корені кожного підтому даних, тому або набору даних (dataset). +.PP +Простий спосіб уникнути будь\-яких конфліктів зі сторонніми інструментами — +вказати в налаштуванні \`data\` звичайний підкаталог усередині підтому або +тому (наприклад, \`/mnt/subvol/data\` замість \`/mnt/subvol\`). SnapRAID завжди +створює каталог знімків у корені підтому (наприклад, +\`/mnt/subvol/.snapraid/\`), залишивши підкаталог даних чистим, завдяки чому +знімки залишаться ззовні та будуть невидимими для засобів резервного +копіювання, що працюють у ньому. +.PP +В іншому випадку, якщо налаштований каталог \`data\` сам по собі є коренем +підтому або тому, SnapRAID створює каталог \`.snapraid/\` безпосередньо +всередині нього (у Btrfs, Bcachefs та NTFS). Хоча SnapRAID автоматично +виключає цей каталог із власного сканування, зовнішні інструменти +резервного копіювання або синхронізації файлів виявлять його. Якщо каталог +не виключено, вони можуть увійти у знімки або посилання на каталоги та +скопіювати все заморожене дерево даних, дублюючи файли й вичерпуючи +дисковий простір резервного сховища. Завжди налаштовуйте зовнішні засоби +резервного копіювання на виключення каталогу \`.snapraid/\`. +.PP +У ZFS знімки надаються через стандартний віртуальний каталог +\`.zfs/snapshot/\` замість \`.snapraid/\`. За замовчуванням (\`snapdir=hidden\`) +ZFS приховує цей каталог зі списків каталогів, тому зовнішні інструменти +резервного копіювання не скануватимуть його. Якщо ви ввімкнули +\`snapdir=visible\`, обов\'язково переконайтеся, що ваші інструменти +резервного копіювання виключають каталог \`.zfs/\`. .SH Шаблон (PATTERN) Шаблони забезпечують гнучкий спосіб фільтрації файлів для включення або виключення. Використовуючи символи підстановки (globbing), ви можете визначити правила, які diff --git a/doc/snapraid-uk.d b/doc/snapraid-uk.d index 9e6df76c..e06dcff0 100644 --- a/doc/snapraid-uk.d +++ b/doc/snapraid-uk.d @@ -1722,6 +1722,35 @@ Name{number} замінити цей знімок, зробивши проміжні версії файлів недоступними для відновлення. + Зовнішнє резервне копіювання зі знімками файлової системи (External backups with filesystem snapshots) + Коли знімки файлової системи ввімкнено, SnapRAID звертається до знімків або + створює їх у корені кожного підтому даних, тому або набору даних (dataset). + + Простий спосіб уникнути будь-яких конфліктів зі сторонніми інструментами — + вказати в налаштуванні `data` звичайний підкаталог усередині підтому або + тому (наприклад, `/mnt/subvol/data` замість `/mnt/subvol`). SnapRAID завжди + створює каталог знімків у корені підтому (наприклад, + `/mnt/subvol/.snapraid/`), залишивши підкаталог даних чистим, завдяки чому + знімки залишаться ззовні та будуть невидимими для засобів резервного + копіювання, що працюють у ньому. + + В іншому випадку, якщо налаштований каталог `data` сам по собі є коренем + підтому або тому, SnapRAID створює каталог `.snapraid/` безпосередньо + всередині нього (у Btrfs, Bcachefs та NTFS). Хоча SnapRAID автоматично + виключає цей каталог із власного сканування, зовнішні інструменти + резервного копіювання або синхронізації файлів виявлять його. Якщо каталог + не виключено, вони можуть увійти у знімки або посилання на каталоги та + скопіювати все заморожене дерево даних, дублюючи файли й вичерпуючи + дисковий простір резервного сховища. Завжди налаштовуйте зовнішні засоби + резервного копіювання на виключення каталогу `.snapraid/`. + + У ZFS знімки надаються через стандартний віртуальний каталог + `.zfs/snapshot/` замість `.snapraid/`. За замовчуванням (`snapdir=hidden`) + ZFS приховує цей каталог зі списків каталогів, тому зовнішні інструменти + резервного копіювання не скануватимуть його. Якщо ви ввімкнули + `snapdir=visible`, обов'язково переконайтеся, що ваші інструменти + резервного копіювання виключають каталог `.zfs/`. + Шаблон (Pattern) Шаблони забезпечують гнучкий спосіб фільтрації файлів для включення або виключення. Використовуючи символи підстановки (globbing), ви можете визначити правила, які diff --git a/doc/snapraid-uk.txt b/doc/snapraid-uk.txt index 95d034d8..1dcdc967 100644 --- a/doc/snapraid-uk.txt +++ b/doc/snapraid-uk.txt @@ -1832,6 +1832,37 @@ SnapRAID керує трьома конкретними знімками, `stabl замінити цей знімок, зробивши проміжні версії файлів недоступними для відновлення. +9.1 Зовнішнє резервне копіювання зі знімками файлової системи (External backups with filesystem snapshots) +---------------------------------------------------------------------------------------------------------- + +Коли знімки файлової системи ввімкнено, SnapRAID звертається до знімків або +створює їх у корені кожного підтому даних, тому або набору даних (dataset). + +Простий спосіб уникнути будь-яких конфліктів зі сторонніми інструментами — +вказати в налаштуванні `data` звичайний підкаталог усередині підтому або +тому (наприклад, `/mnt/subvol/data` замість `/mnt/subvol`). SnapRAID завжди +створює каталог знімків у корені підтому (наприклад, +`/mnt/subvol/.snapraid/`), залишивши підкаталог даних чистим, завдяки чому +знімки залишаться ззовні та будуть невидимими для засобів резервного +копіювання, що працюють у ньому. + +В іншому випадку, якщо налаштований каталог `data` сам по собі є коренем +підтому або тому, SnapRAID створює каталог `.snapraid/` безпосередньо +всередині нього (у Btrfs, Bcachefs та NTFS). Хоча SnapRAID автоматично +виключає цей каталог із власного сканування, зовнішні інструменти +резервного копіювання або синхронізації файлів виявлять його. Якщо каталог +не виключено, вони можуть увійти у знімки або посилання на каталоги та +скопіювати все заморожене дерево даних, дублюючи файли й вичерпуючи +дисковий простір резервного сховища. Завжди налаштовуйте зовнішні засоби +резервного копіювання на виключення каталогу `.snapraid/`. + +У ZFS знімки надаються через стандартний віртуальний каталог +`.zfs/snapshot/` замість `.snapraid/`. За замовчуванням (`snapdir=hidden`) +ZFS приховує цей каталог зі списків каталогів, тому зовнішні інструменти +резервного копіювання не скануватимуть його. Якщо ви ввімкнули +`snapdir=visible`, обов'язково переконайтеся, що ваші інструменти +резервного копіювання виключають каталог `.zfs/`. + 10 Шаблон (PATTERN) =================== diff --git a/doc/snapraid-zh.1 b/doc/snapraid-zh.1 index 1359424b..c39b06ed 100644 --- a/doc/snapraid-zh.1 +++ b/doc/snapraid-zh.1 @@ -1755,6 +1755,25 @@ SnapRAID 在每个数据子卷根目录下的隐藏目录中管理三个特定 但是，如果 \`sync\` 中断，请避免在后续 \`sync\` 成功完成之前修改、删除、 替换或移动文件。校验可能仍包含根据中断的同步所使用的快照计算的块。 以后的同步可能会替换该快照，从而导致中间文件版本无法用于恢复。 +.SS 使用文件系统快照进行外部备份 (External backups with filesystem snapshots) +当启用文件系统快照时，SnapRAID 会在每个数据子卷、卷或数据集（dataset） +的根目录下访问或创建快照。 +.PP +避免与外部工具发生冲突的一种简单方法，是将 \`data\` 配置指向子卷或卷内的 +常规子目录（例如 \`/mnt/subvol/data\` 而不是 \`/mnt/subvol\`）。SnapRAID +始终会在子卷根目录下创建快照目录（例如 \`/mnt/subvol/.snapraid/\`），从而保持 +数据子目录整洁，使快照保留在外部且对在该目录内运行的备份工具不可见。 +.PP +否则，如果配置的 \`data\` 目录本身就是子卷或卷的根目录，SnapRAID 会直接在其中 +创建 \`.snapraid/\` 目录（在 Btrfs、Bcachefs 和 NTFS 上）。虽然 SnapRAID +会在其自身的扫描中自动排除此目录，但外部备份工具或文件同步工具会发现它。如果未 +将其排除，它们可能会遍历快照或目录链接并复制整个冻结的数据树，从而导致数据 +重复并耗尽备份存储空间。请务必将外部备份工具配置为排除 \`.snapraid/\` 目录。 +.PP +在 ZFS 上，快照是通过标准虚拟目录 \`.zfs/snapshot/\` 而不是 \`.snapraid/\` +公开的。默认情况下（\`snapdir=hidden\`），ZFS 会在目录列表中隐藏此目录，因此 +外部备份工具不会遍历它。如果您启用了 \`snapdir=visible\`，请确保您的备份工具 +排除 \`.zfs/\` 目录。 .SH 模式 (PATTERN) 模式提供了一种灵活的方法来过滤要包含或排除的文件。通过使用通配符（globbing）， 您可以定义匹配特定文件名或整个目录结构的规则，而无需手动列出每个路径。 diff --git a/doc/snapraid-zh.d b/doc/snapraid-zh.d index 324c5511..f2b0836e 100644 --- a/doc/snapraid-zh.d +++ b/doc/snapraid-zh.d @@ -1360,6 +1360,26 @@ Name{number} 替换或移动文件。校验可能仍包含根据中断的同步所使用的快照计算的块。 以后的同步可能会替换该快照，从而导致中间文件版本无法用于恢复。 + 使用文件系统快照进行外部备份 (External backups with filesystem snapshots) + 当启用文件系统快照时，SnapRAID 会在每个数据子卷、卷或数据集（dataset） + 的根目录下访问或创建快照。 + + 避免与外部工具发生冲突的一种简单方法，是将 `data` 配置指向子卷或卷内的 + 常规子目录（例如 `/mnt/subvol/data` 而不是 `/mnt/subvol`）。SnapRAID + 始终会在子卷根目录下创建快照目录（例如 `/mnt/subvol/.snapraid/`），从而保持 + 数据子目录整洁，使快照保留在外部且对在该目录内运行的备份工具不可见。 + + 否则，如果配置的 `data` 目录本身就是子卷或卷的根目录，SnapRAID 会直接在其中 + 创建 `.snapraid/` 目录（在 Btrfs、Bcachefs 和 NTFS 上）。虽然 SnapRAID + 会在其自身的扫描中自动排除此目录，但外部备份工具或文件同步工具会发现它。如果未 + 将其排除，它们可能会遍历快照或目录链接并复制整个冻结的数据树，从而导致数据 + 重复并耗尽备份存储空间。请务必将外部备份工具配置为排除 `.snapraid/` 目录。 + + 在 ZFS 上，快照是通过标准虚拟目录 `.zfs/snapshot/` 而不是 `.snapraid/` + 公开的。默认情况下（`snapdir=hidden`），ZFS 会在目录列表中隐藏此目录，因此 + 外部备份工具不会遍历它。如果您启用了 `snapdir=visible`，请确保您的备份工具 + 排除 `.zfs/` 目录。 + 模式 (Pattern) 模式提供了一种灵活的方法来过滤要包含或排除的文件。通过使用通配符（globbing）， 您可以定义匹配特定文件名或整个目录结构的规则，而无需手动列出每个路径。 diff --git a/doc/snapraid-zh.txt b/doc/snapraid-zh.txt index 76a04230..4791ecd4 100644 --- a/doc/snapraid-zh.txt +++ b/doc/snapraid-zh.txt @@ -1470,6 +1470,28 @@ SnapRAID 在每个数据子卷根目录下的隐藏目录中管理三个特定 替换或移动文件。校验可能仍包含根据中断的同步所使用的快照计算的块。 以后的同步可能会替换该快照，从而导致中间文件版本无法用于恢复。 +9.1 使用文件系统快照进行外部备份 (External backups with filesystem snapshots) +--------------------------------------------------------------- + +当启用文件系统快照时，SnapRAID 会在每个数据子卷、卷或数据集（dataset） +的根目录下访问或创建快照。 + +避免与外部工具发生冲突的一种简单方法，是将 `data` 配置指向子卷或卷内的 +常规子目录（例如 `/mnt/subvol/data` 而不是 `/mnt/subvol`）。SnapRAID +始终会在子卷根目录下创建快照目录（例如 `/mnt/subvol/.snapraid/`），从而保持 +数据子目录整洁，使快照保留在外部且对在该目录内运行的备份工具不可见。 + +否则，如果配置的 `data` 目录本身就是子卷或卷的根目录，SnapRAID 会直接在其中 +创建 `.snapraid/` 目录（在 Btrfs、Bcachefs 和 NTFS 上）。虽然 SnapRAID +会在其自身的扫描中自动排除此目录，但外部备份工具或文件同步工具会发现它。如果未 +将其排除，它们可能会遍历快照或目录链接并复制整个冻结的数据树，从而导致数据 +重复并耗尽备份存储空间。请务必将外部备份工具配置为排除 `.snapraid/` 目录。 + +在 ZFS 上，快照是通过标准虚拟目录 `.zfs/snapshot/` 而不是 `.snapraid/` +公开的。默认情况下（`snapdir=hidden`），ZFS 会在目录列表中隐藏此目录，因此 +外部备份工具不会遍历它。如果您启用了 `snapdir=visible`，请确保您的备份工具 +排除 `.zfs/` 目录。 + 10 模式 (PATTERN) =============== diff --git a/doc/snapraid.1 b/doc/snapraid.1 index e361f5f9..6bd30dce 100644 --- a/doc/snapraid.1 +++ b/doc/snapraid.1 @@ -1962,6 +1962,33 @@ successfully. Parity may still contain blocks computed from the snapshot used by the interrupted sync. A later sync may replace that snapshot, making intermediate file versions unavailable for recovery. +.SS External backups with filesystem snapshots +When filesystem snapshots are enabled, SnapRAID accesses or creates +snapshots at the root of each data subvolume, volume, or dataset. +.PP +A simple way to avoid any interference with external tools is to point +your \`data\` configuration to a regular subdirectory within the subvolume +or volume (for example, \`/mnt/subvol/data\` instead of \`/mnt/subvol\`). +SnapRAID always creates the snapshot directory at the subvolume root +(for example, \`/mnt/subvol/.snapraid/\`), leaving the data subdirectory +clean so that snapshots remain outside and invisible to backup tools +operating inside it. +.PP +Otherwise, if your configured \`data\` directory is itself the subvolume +or volume root, SnapRAID creates the \`.snapraid/\` directory directly +inside it (on Btrfs, Bcachefs, and NTFS). While SnapRAID automatically +excludes this directory from its own scanning, external backup tools +or file synchronizers will encounter it. If not excluded, they may +traverse into the snapshots or directory links and copy the entire +frozen data tree, duplicating data and potentially exhausting backup +storage. Always configure external backup tools to exclude the +\`.snapraid/\` directory. +.PP +On ZFS, snapshots are exposed through the standard \`.zfs/snapshot/\` +virtual directory rather than \`.snapraid/\`. By default (\`snapdir=hidden\`), +ZFS hides this directory from directory listings, so external backup +tools will not traverse it. If you have enabled \`snapdir=visible\`, +ensure your backup tools exclude the \`.zfs/\` directory. .SH PATTERN Patterns are used to select a subset of files to exclude or include in the process. Globbing characters can be used to match files and paths diff --git a/doc/snapraid.d b/doc/snapraid.d index 920ac71d..2682257e 100644 --- a/doc/snapraid.d +++ b/doc/snapraid.d @@ -1567,6 +1567,34 @@ Snapshots Lifecycle that snapshot, making intermediate file versions unavailable for recovery. + External backups with filesystem snapshots + When filesystem snapshots are enabled, SnapRAID accesses or creates + snapshots at the root of each data subvolume, volume, or dataset. + + A simple way to avoid any interference with external tools is to point + your `data` configuration to a regular subdirectory within the subvolume + or volume (for example, `/mnt/subvol/data` instead of `/mnt/subvol`). + SnapRAID always creates the snapshot directory at the subvolume root + (for example, `/mnt/subvol/.snapraid/`), leaving the data subdirectory + clean so that snapshots remain outside and invisible to backup tools + operating inside it. + + Otherwise, if your configured `data` directory is itself the subvolume + or volume root, SnapRAID creates the `.snapraid/` directory directly + inside it (on Btrfs, Bcachefs, and NTFS). While SnapRAID automatically + excludes this directory from its own scanning, external backup tools + or file synchronizers will encounter it. If not excluded, they may + traverse into the snapshots or directory links and copy the entire + frozen data tree, duplicating data and potentially exhausting backup + storage. Always configure external backup tools to exclude the + `.snapraid/` directory. + + On ZFS, snapshots are exposed through the standard `.zfs/snapshot/` + virtual directory rather than `.snapraid/`. By default (`snapdir=hidden`), + ZFS hides this directory from directory listings, so external backup + tools will not traverse it. If you have enabled `snapdir=visible`, + ensure your backup tools exclude the `.zfs/` directory. + Pattern Patterns are used to select a subset of files to exclude or include in the process. Globbing characters can be used to match files and paths diff --git a/doc/snapraid.txt b/doc/snapraid.txt index 4f425fd3..6833e6f0 100644 --- a/doc/snapraid.txt +++ b/doc/snapraid.txt @@ -1677,6 +1677,36 @@ snapshot used by the interrupted sync. A later sync may replace that snapshot, making intermediate file versions unavailable for recovery. +9.1 External backups with filesystem snapshots +---------------------------------------------- + +When filesystem snapshots are enabled, SnapRAID accesses or creates +snapshots at the root of each data subvolume, volume, or dataset. + +A simple way to avoid any interference with external tools is to point +your `data` configuration to a regular subdirectory within the subvolume +or volume (for example, `/mnt/subvol/data` instead of `/mnt/subvol`). +SnapRAID always creates the snapshot directory at the subvolume root +(for example, `/mnt/subvol/.snapraid/`), leaving the data subdirectory +clean so that snapshots remain outside and invisible to backup tools +operating inside it. + +Otherwise, if your configured `data` directory is itself the subvolume +or volume root, SnapRAID creates the `.snapraid/` directory directly +inside it (on Btrfs, Bcachefs, and NTFS). While SnapRAID automatically +excludes this directory from its own scanning, external backup tools +or file synchronizers will encounter it. If not excluded, they may +traverse into the snapshots or directory links and copy the entire +frozen data tree, duplicating data and potentially exhausting backup +storage. Always configure external backup tools to exclude the +`.snapraid/` directory. + +On ZFS, snapshots are exposed through the standard `.zfs/snapshot/` +virtual directory rather than `.snapraid/`. By default (`snapdir=hidden`), +ZFS hides this directory from directory listings, so external backup +tools will not traverse it. If you have enabled `snapdir=visible`, +ensure your backup tools exclude the `.zfs/` directory. + 10 PATTERN ==========