IT

Linux e rete

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.

8 min di lettura, aggiornato il 18 novembre 2026

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.

Terminale
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 SHA256SUMS

La verifica deve mostrare OK. Installa poi il binario:

Terminale
bunzip2 "$FILE"
sudo install -m 755 "${FILE%.bz2}" /usr/local/bin/restic
restic version

Se bunzip2 non è presente, installalo con sudo apt install -y bzip2.

Preparare la configurazione

  1. Crea la cartella di configurazione e la password del repository:

    Terminale
    sudo install -d -m 700 /etc/restic
    sudo sh -c 'umask 077; openssl rand -base64 32 > /etc/restic/password'
    sudo cat /etc/restic/password
  2. Crea il file di ambiente:

    Terminale
    sudo install -m 600 /dev/null /etc/restic/restic.env
    sudo nano /etc/restic/restic.env
    Configurazione
    RESTIC_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'.

  3. Elenca le cartelle di cui fare il backup. Indica solo percorsi esistenti:

    Terminale
    sudo nano /etc/restic/paths
    Testo
    /etc
    /home
    /root
    /var/www
    /var/backups
  4. Elenca ciò che deve essere ignorato:

    Terminale
    sudo nano /etc/restic/excludes
    Testo
    /home/*/.cache
    /root/.cache
    /var/www/*/cache
    **/node_modules
    *.tmp
  5. Crea un piccolo comando che carica questa configurazione:

    Terminale
    sudo nano /usr/local/sbin/restic-env
    Terminale
    #!/bin/sh
    set -a
    . /etc/restic/restic.env
    set +a
    exec /usr/local/bin/restic "$@"
    Terminale
    sudo chmod 700 /usr/local/sbin/restic-env

Creare il repository e lanciare un primo backup

  1. Inizializza il repository:

    Terminale
    sudo restic-env init
  2. Simula il backup per controllare i file selezionati:

    Terminale
    sudo restic-env backup --files-from /etc/restic/paths --exclude-file /etc/restic/excludes --exclude-caches --dry-run --verbose
  3. Lancia il backup:

    Terminale
    sudo restic-env backup --files-from /etc/restic/paths --exclude-file /etc/restic/excludes --exclude-caches --tag auto
  4. Verifica il risultato:

    Terminale
    sudo restic-env snapshots
    sudo restic-env ls latest /etc/hostname
    sudo restic-env check

    check deve terminare con no 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

Terminale
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

Terminale
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/shadow

In 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:

Terminale
sudo rm -rf /var/tmp/restic-test

Livello 3: ripartenza su un altro server

È il test che dimostra che potresti ripartire dopo la perdita totale del server. Su un'altra macchina:

  1. Installa Restic come sopra.

  2. Ricrea /etc/restic/restic.env, /etc/restic/password e /usr/local/sbin/restic-env a partire dalle tue copie esterne.

  3. Ripristina in una cartella dedicata, senza sovrascrivere il sistema:

    Terminale
    sudo restic-env snapshots --host web01
    sudo restic-env restore latest --host web01 --target /var/restore
  4. 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

  1. Crea il servizio di backup:

    Terminale
    sudo nano /etc/systemd/system/restic-backup.service
    Configurazione
    [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
  2. Crea il suo timer:

    Terminale
    sudo nano /etc/systemd/system/restic-backup.timer
    Configurazione
    [Unit]
    Description=Daily Restic backup
    
    [Timer]
    OnCalendar=*-*-* 03:30:00
    RandomizedDelaySec=20min
    Persistent=true
    
    [Install]
    WantedBy=timers.target
  3. Crea il servizio di manutenzione, che applica la retention e poi controlla il repository:

    Terminale
    sudo nano /etc/systemd/system/restic-maintenance.service
    Configurazione
    [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à.

  4. Crea il suo timer:

    Terminale
    sudo nano /etc/systemd/system/restic-maintenance.timer
    Configurazione
    [Unit]
    Description=Weekly Restic maintenance
    
    [Timer]
    OnCalendar=Sun *-*-* 05:00:00
    RandomizedDelaySec=20min
    Persistent=true
    
    [Install]
    WantedBy=timers.target
  5. Attiva i due timer e lancia un backup tramite questo meccanismo:

    Terminale
    sudo 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:

Terminale
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 add e conservala anch'essa fuori dal server.

Aggiornare Restic

Il binario ufficiale si aggiorna da solo, dopo la verifica della sua firma:

Terminale
sudo restic self-update
restic version

I 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:

Terminale
pgrep -a restic
sudo restic-env list locks

Rimuovi poi solo i lock scaduti:

Terminale
sudo restic-env unlock

SignatureDoesNotMatch, 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:

Terminale
curl -I https://s3.lyn.io.hostmyservers.net

Qualsiasi 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.

Riferimenti