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.