LLI Wiki — My Digital Knowledge Base

BorgBackup vers un NAS Synology via SSH

Aide-mémoire des commandes borg pour sauvegarder, lister, purger et restaurer vers un NAS Synology.

BorgBackup permet de sauvegarder une machine Linux vers un NAS Synology via SSH. Borg doit aussi être installé sur le NAS (via le gestionnaire de paquets Synology), d'où l'option --remote-path dans toutes les commandes. Les exemples utilisent borg 1.2.7, un hôte fictif example.com et le port SSH 222.

Préparation

Définissez la passphrase du dépôt dans l'environnement (utilisez votre propre valeur et ne la versionnez jamais) :

export BORG_PASSPHRASE='<PASSWORD>'

Initialisez le dépôt :

borg init --encryption=repokey --remote-path /usr/local/bin/borg ssh://user@example.com:222/volume1/backups/borg/

Créer une sauvegarde

# Un dossier
borg create --stats --progress --remote-path /usr/local/bin/borg ssh://user@example.com:222/volume1/backups/borg::second /home/user/

# Tout le système
borg create --stats --progress --remote-path /usr/local/bin/borg ssh://user@example.com:222/volume1/backups/borg::second /

# Plusieurs dossiers, archive nommée avec la date
borg create --stats --progress --remote-path /usr/local/bin/borg ssh://user@example.com:222/volume1/backups/borg::myhost-{now:%Y-%m-%d} /home/ /etc/ /usr/ /var/log/

# Archive nommée avec la date, l'heure et l'utilisateur
borg create --stats --progress --remote-path /usr/local/bin/borg ssh://user@example.com:222/volume1/backups/borg::data-$(date +"%Y-%m-%d-%H%M%S"-${USER}) /path/to/data/

Lister, inspecter et comparer

# Lister les archives
borg list --remote-path /usr/local/bin/borg ssh://user@example.com:222/volume1/backups/borg

# Lister le contenu d'une archive
borg list --remote-path /usr/local/bin/borg ssh://user@example.com:222/volume1/backups/borg::second

# Informations sur le dépôt
borg info --remote-path /usr/local/bin/borg ssh://user@example.com:222/volume1/backups/borg

# Différences entre deux archives
borg diff --stats --progress --remote-path /usr/local/bin/borg ssh://user@example.com:222/volume1/backups/borg::second first

Purger les anciennes archives

Lancez d'abord avec --dry-run pour voir ce qui serait supprimé :

borg prune -v --remote-path /usr/local/bin/borg --list --dry-run --keep-daily=7 --keep-weekly 4 --keep-monthly 6 ssh://user@example.com:222/volume1/backups/borg

borg --error prune --keep-weekly 4 --keep-monthly 6 ssh://user@example.com:222/volume1/backups/borg::first

Monter une archive

borg mount --remote-path /usr/local/bin/borg ssh://user@example.com:222/volume1/backups/borg /tmp/m_borg

borg umount --remote-path /usr/local/bin/borg /tmp/m_borg

Motifs (patterns)

Préfixe Signification
pf: Chemin complet : utile uniquement pour faire correspondre des chemins complets
fm: Correspondance de noms de fichiers de style Unix
re: Expression régulière, par exemple re:^etc\/key
sh: Motif de style shell, par exemple sh:**/fs*

Lister ou rechercher des fichiers dans une archive

borg list --remote-path /usr/local/bin/borg ssh://user@example.com:222/volume1/backups/borg::full_etc --pattern "pf:etc/fstab"

borg list --remote-path /usr/local/bin/borg ssh://user@example.com:222/volume1/backups/borg::full_etc --pattern "sh:etc/fs*"

Recherche par extraction à blanc :

borg extract --dry-run -v --list --remote-path /usr/local/bin/borg ssh://user@example.com:222/volume1/backups/borg::data-2024-01-02 "sh:**/*.jpg"
borg extract --dry-run -v --list --remote-path /usr/local/bin/borg ssh://user@example.com:222/volume1/backups/borg::data-2024-01-02 "fm:*.jpg"
borg extract --dry-run -v --list --remote-path /usr/local/bin/borg ssh://user@example.com:222/volume1/backups/borg::data-2024-01-02 "re:.*report.*"

Supprimer une archive

borg delete --dry-run --remote-path /usr/local/bin/borg ssh://user@example.com:222/volume1/backups/borg::test

Retirez --dry-run pour supprimer réellement.

Exporter la clé du dépôt

Avec le chiffrement repokey, la clé est stockée dans le dépôt. Conservez-en une copie hors ligne :

borg key export --remote-path /usr/local/bin/borg ssh://user@example.com:222/volume1/backups/borg > encrypted-synology-key-backup
borg key export --remote-path /usr/local/bin/borg --paper ssh://user@example.com:222/volume1/backups/borg > encrypted-synology-key-backup.txt

Vérifier les versions

borg --version
borg --version --remote-path /usr/local/bin/borg "ssh://user@example.com:222/volume1/backups/borg"

Référence : Backing up to an external server with Borg.

Mastodon LLIMastodon SocialFosstodon