Backup cifrati con Restic
Fai il backup di un server Linux con Restic verso uno storage compatibile S3: cifratura, pianificazione systemd, retention, verifica e test di ripristino.
In questa pagina
Questa guida ti spiega come fare il backup del tuo VPS o server dedicato con Restic verso uno storage compatibile S3. Restic cifra i dati sul server prima dell'invio, trasferisce solo ciò che è cambiato e conserva più punti di ripristino, chiamati snapshot.
Configurerai un backup giornaliero, una politica di retention, un controllo di integrità settimanale e, soprattutto, un test di ripristino. Finché questo test non è riuscito, considera di non avere un backup.
Prerequisiti
- Un server con Debian 12 o 13, oppure Ubuntu 22.04 o 24.04, con accesso
sudo - Un bucket su uno storage compatibile S3, con una chiave di accesso e una chiave segreta
- Un orologio di sistema allineato: consulta la nostra guida Configurare NTP
- Un posto fuori dal server in cui conservare la password del repository, come un gestore di password
Non c'è alcuna porta in ingresso da aprire. Il server deve solo poter raggiungere lo storage in HTTPS sulla porta in uscita 443.
Scegliere lo storage
Gli esempi usano l'Object Storage HostMyServers, compatibile S3, il cui endpoint pubblicato su quella pagina è https://s3.lyn.io.hostmyservers.net. Il bucket si chiama mes-sauvegardes e la cartella web01 indica il tuo server: adatta questi due nomi.
Per un altro provider compatibile S3, sostituisci semplicemente l'indirizzo in RESTIC_REPOSITORY con quello che ti indica.
Installare Restic
I pacchetti delle distribuzioni possono essere vecchi. Installa il binario ufficiale pubblicato dal progetto. Al momento della stesura, l'ultima versione è 0.19.1: consulta la pagina delle versioni e adatta RESTIC_VERSION se necessario.
RESTIC_VERSION="0.19.1"
ARCH="$(dpkg --print-architecture)"
FILE="restic_${RESTIC_VERSION}_linux_${ARCH}.bz2"
cd /tmp
curl -fsSLO "https://github.com/restic/restic/releases/download/v${RESTIC_VERSION}/${FILE}"
curl -fsSLO "https://github.com/restic/restic/releases/download/v${RESTIC_VERSION}/SHA256SUMS"
sha256sum --check --ignore-missing SHA256SUMSLa verifica deve mostrare OK. Installa poi il binario:
bunzip2 "$FILE"
sudo install -m 755 "${FILE%.bz2}" /usr/local/bin/restic
restic versionSe bunzip2 non è presente, installalo con sudo apt install -y bzip2.
Preparare la configurazione
-
Crea la cartella di configurazione e la password del repository:
Terminalesudo install -d -m 700 /etc/restic sudo sh -c 'umask 077; openssl rand -base64 32 > /etc/restic/password' sudo cat /etc/restic/password -
Crea il file di ambiente:
Terminalesudo install -m 600 /dev/null /etc/restic/restic.env sudo nano /etc/restic/restic.envConfigurazioneRESTIC_REPOSITORY='s3:https://s3.lyn.io.hostmyservers.net/mes-sauvegardes/web01' RESTIC_PASSWORD_FILE='/etc/restic/password' AWS_ACCESS_KEY_ID='TUA_CHIAVE_DI_ACCESSO' AWS_SECRET_ACCESS_KEY='TUA_CHIAVE_SEGRETA'Se il tuo provider richiede una regione, aggiungi
AWS_DEFAULT_REGION='TUA_REGIONE'. -
Elenca le cartelle di cui fare il backup. Indica solo percorsi esistenti:
Terminalesudo nano /etc/restic/pathsTesto/etc /home /root /var/www /var/backups -
Elenca ciò che deve essere ignorato:
Terminalesudo nano /etc/restic/excludesTesto/home/*/.cache /root/.cache /var/www/*/cache **/node_modules *.tmp -
Crea un piccolo comando che carica questa configurazione:
Terminalesudo nano /usr/local/sbin/restic-envTerminale#!/bin/sh set -a . /etc/restic/restic.env set +a exec /usr/local/bin/restic "$@"Terminalesudo chmod 700 /usr/local/sbin/restic-env
Creare il repository e lanciare un primo backup
-
Inizializza il repository:
Terminalesudo restic-env init -
Simula il backup per controllare i file selezionati:
Terminalesudo restic-env backup --files-from /etc/restic/paths --exclude-file /etc/restic/excludes --exclude-caches --dry-run --verbose -
Lancia il backup:
Terminalesudo restic-env backup --files-from /etc/restic/paths --exclude-file /etc/restic/excludes --exclude-caches --tag auto -
Verifica il risultato:
Terminalesudo restic-env snapshots sudo restic-env ls latest /etc/hostname sudo restic-env checkcheckdeve terminare conno errors were found.
Testare il ripristino
Fai questo test adesso, poi almeno una volta a trimestre. Si svolge su tre livelli, dal più rapido al più completo.
Livello 1: un file
sudo rm -rf /var/tmp/restic-test
sudo restic-env restore latest --target /var/tmp/restic-test --include /etc/hostname
sudo diff /etc/hostname /var/tmp/restic-test/etc/hostname && echo "Identical"Livello 2: una cartella completa
sudo restic-env restore latest:/etc --target /var/tmp/restic-test/etc-full
sudo diff -r /etc /var/tmp/restic-test/etc-full | head -n 20
sudo stat -c '%U:%G %a %n' /etc/shadow /var/tmp/restic-test/etc-full/shadowIn diff devono comparire solo i file modificati dopo il backup. Il proprietario e i permessi di shadow devono essere identici. Cancella poi questa cartella, che contiene dati sensibili:
sudo rm -rf /var/tmp/restic-testLivello 3: ripartenza su un altro server
È il test che dimostra che potresti ripartire dopo la perdita totale del server. Su un'altra macchina:
-
Installa Restic come sopra.
-
Ricrea
/etc/restic/restic.env,/etc/restic/passworde/usr/local/sbin/restic-enva partire dalle tue copie esterne. -
Ripristina in una cartella dedicata, senza sovrascrivere il sistema:
Terminalesudo restic-env snapshots --host web01 sudo restic-env restore latest --host web01 --target /var/restore -
Controlla i tuoi file, poi ripristina un database dalle sue esportazioni seguendo la guida corrispondente.
Annota la data del test e il tempo necessario: è una buona stima del tuo tempo di ripristino reale. Qui web01 corrisponde all'hostname del server di origine, mostrato da restic-env snapshots.
Pianificare i backup con systemd
-
Crea il servizio di backup:
Terminalesudo nano /etc/systemd/system/restic-backup.serviceConfigurazione[Unit] Description=Restic backup Wants=network-online.target After=network-online.target [Service] Type=oneshot EnvironmentFile=/etc/restic/restic.env Environment=HOME=/root Environment=RESTIC_CACHE_DIR=/var/cache/restic CacheDirectory=restic CacheDirectoryMode=0700 Nice=10 IOSchedulingClass=idle ExecStart=/usr/local/bin/restic backup --retry-lock 1h --files-from /etc/restic/paths --exclude-file /etc/restic/excludes --exclude-caches --tag auto -
Crea il suo timer:
Terminalesudo nano /etc/systemd/system/restic-backup.timerConfigurazione[Unit] Description=Daily Restic backup [Timer] OnCalendar=*-*-* 03:30:00 RandomizedDelaySec=20min Persistent=true [Install] WantedBy=timers.target -
Crea il servizio di manutenzione, che applica la retention e poi controlla il repository:
Terminalesudo nano /etc/systemd/system/restic-maintenance.serviceConfigurazione[Unit] Description=Restic retention and check Wants=network-online.target After=network-online.target [Service] Type=oneshot EnvironmentFile=/etc/restic/restic.env Environment=HOME=/root Environment=RESTIC_CACHE_DIR=/var/cache/restic CacheDirectory=restic CacheDirectoryMode=0700 Nice=10 IOSchedulingClass=idle ExecStart=/usr/local/bin/restic forget --retry-lock 1h --tag auto --keep-daily 7 --keep-weekly 4 --keep-monthly 6 --prune ExecStart=/usr/local/bin/restic check --retry-lock 1h --read-data-subset=5%%Il simbolo
%è raddoppiato perché systemd gli attribuisce un significato particolare nei suoi file di unità. -
Crea il suo timer:
Terminalesudo nano /etc/systemd/system/restic-maintenance.timerConfigurazione[Unit] Description=Weekly Restic maintenance [Timer] OnCalendar=Sun *-*-* 05:00:00 RandomizedDelaySec=20min Persistent=true [Install] WantedBy=timers.target -
Attiva i due timer e lancia un backup tramite questo meccanismo:
Terminalesudo systemctl daemon-reload sudo systemctl enable --now restic-backup.timer restic-maintenance.timer sudo systemctl start restic-backup.service sudo systemctl status restic-backup.service --no-pager systemctl list-timers 'restic-*'
Consulta i log con sudo journalctl -u restic-backup.service -n 50 --no-pager. Ricordati di monitorare questi servizi: un backup che fallisce in silenzio per settimane è un rischio comune. systemctl --failed li mostra in caso di errore.
Capire la retention
| Opzione | Conserva |
|---|---|
--keep-daily 7 |
L'ultimo snapshot di ciascuno degli ultimi 7 giorni che ne hanno uno |
--keep-weekly 4 |
L'ultimo snapshot di ciascuna delle ultime 4 settimane che ne hanno uno |
--keep-monthly 6 |
L'ultimo snapshot di ciascuno degli ultimi 6 mesi che ne hanno uno |
forget rimuove degli snapshot, e --prune libera poi lo spazio corrispondente. Prima di modificare questi valori, simula il risultato:
sudo restic-env forget --tag auto --keep-daily 7 --keep-weekly 4 --keep-monthly 6 --dry-run--read-data-subset=5% scarica e verifica a ogni esecuzione un campione casuale di circa il 5 % dei dati. Per controllare tutto, usa --read-data, più lento e più oneroso in termini di trasferimento.
Limitare i rischi
- Le chiavi memorizzate sul server permettono di eliminare il repository. Se un attaccante prende il controllo del server, può raggiungere anche i tuoi backup.
- L'offerta HMS annuncia il versioning e le regole del ciclo di vita sulla sua pagina di presentazione. Il versioning permette di recuperare un oggetto sovrascritto o eliminato, ma le versioni conservate contano nel volume fatturato.
- Una seconda chiave del repository evita di dipendere da una sola password. Aggiungila con
sudo restic-env key adde conservala anch'essa fuori dal server.
Aggiornare Restic
Il binario ufficiale si aggiorna da solo, dopo la verifica della sua firma:
sudo restic self-update
restic versionI tuoi dati restano nel repository. Dopo un aggiornamento importante, rilancia sudo restic-env check e un test di ripristino di livello 1.
In caso di problemi
wrong password or no key found
Il contenuto di /etc/restic/password non corrisponde al repository. Ripristina la password dalla tua copia esterna. Senza alcuna password valida, i dati non sono recuperabili.
repository does not exist: unable to open config file
Il repository non è stato inizializzato a questo indirizzo, oppure l'indirizzo è sbagliato. Verifica RESTIC_REPOSITORY, il nome del bucket e la cartella. Lancia sudo restic-env init solo se si tratta davvero di un nuovo repository.
repository is already locked
Un'altra operazione è in corso, oppure una vecchia operazione è stata interrotta. Verifica prima che nessun Restic sia in esecuzione su alcun server che usa questo repository:
pgrep -a restic
sudo restic-env list locksRimuovi poi solo i lock scaduti:
sudo restic-env unlockSignatureDoesNotMatch, InvalidAccessKeyId o AccessDenied
Le chiavi sono errate, oppure non hanno accesso a questo bucket. Verifica AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY e l'endpoint mostrato per il tuo servizio. Se l'errore menziona una regione, aggiungi AWS_DEFAULT_REGION con il valore fornito dal tuo provider di storage, oppure contatta il supporto dalla tua area clienti.
RequestTimeTooSkewed
L'orologio del server è sfasato. Controllalo con timedatectl, poi correggilo con la nostra guida Configurare NTP.
NoSuchBucket
Il bucket non esiste o il suo nome è scritto male. Crealo dalla tua area clienti, poi rilancia init.
no such host o timeout
Verifica l'endpoint, la risoluzione DNS e l'uscita verso la porta 443:
curl -I https://s3.lyn.io.hostmyservers.netQualsiasi risposta HTTP, anche un errore 403, dimostra che il servizio è raggiungibile.
Il servizio termina con il codice 3
Lo snapshot è stato creato, ma alcuni file non hanno potuto essere letti. Il log li elenca. Correggi i permessi, escludi i file temporanei, poi rilancia il backup.
Il repository segnala errori durante check
Non lanciare né forget né prune, conserva lo stato attuale e segui la procedura ufficiale di risoluzione dei problemi.