Base di conoscenze

1 000 FAQ, 500 tutorial e video esplicativi. Qui ci sono delle soluzioni!

Eseguire il backup dei dati tramite riga di comando su Swiss Backup (CLI S3)

Aggiornamento 01/09/2026

Questa guida illustra come eseguire manualmente il backup dei dati tramite la riga di comando (CLI) utilizzando il protocollo S3 Compatible su Swiss Backup, la soluzione di backup nel cloud svizzero.

 

Utilizzare una posizione S3 tramite CLI

Prerequisiti

  • Avere uno spazio Swiss Backup Infomaniak con una quota dispositivo disponibile (minimo 1) per un backup su cloud.
  • Aggiungi 1 dispositivo di tipo Cloud per ottenere le impostazioni compatibili con S3.
  • Utilizza un'applicazione di tipo Terminal (interfaccia a riga di comando, CLI / Command Line Interface) sul tuo dispositivo.

Utilizzando un'applicazione di tipo Terminale (interfaccia a riga di comando, CLI / Command Line Interface) sul tuo dispositivo:

  1. Installa s3cmd, ad esempio su Debian/Ubuntu:

    sudo apt install s3cmd

    oppure su macOS (con Homebrew):

    brew install s3cmd

    e per Windows si consiglia di utilizzare S3Express, uno strumento a riga di comando open source (hai bisogno di aiuto?).

  2. Inserire il comando seguente per configurare la connessione:

    s3cmd --configure
  3. Compilare i campi in base alle informazioni relative al proprio dispositivo (consultare questa guida):
    • Display name = scegliere un nome per lo spazio di archiviazione.
    • AccessKey e SecretKey = le chiavi di accesso generate tramite l'e-mail ricevuta da Infomaniak in seguito alla creazione dello spazio di archiviazione.
    • Service point = ad esempio https://s3.swiss-backup02.infomaniak.com (1)
    • Bucket name = default
    • Default region
    • S3 Endpoint: utilizzare l'URL fornito da Infomaniak
    • Use HTTPS: sì
    • HTTP Proxy server: lasciare vuoto, a meno che non sia necessaria una configurazione specifica
    • Signature version: forzare l'utilizzo di v4
    • Path style: scegliere , se richiesto
    • Test access: è possibile eseguire il test per convalidare la configurazione

(1) L'indicazione "//s3.swiss-backup02", "//s3.swiss-backup03" ecc. cambia in base al numero del cluster indicato nel Manager, nelle informazioni sullo spazio di archiviazione Cloud, sotto la voce "Posizione"; e se il dispositivo Swiss Backup è stato creato prima di ottobre 2020, sarà necessario utilizzare https://swiss-backup.infomaniak.com/identity/v3.

Al termine, verrà salvato un file di configurazione (per impostazione predefinita in ~/.s3cfg).

 

Avviare una copia su Swiss Backup

Ecco alcuni comandi di base per interagire con Swiss Backup:

  • Elencare i bucket: s3cmd ls
  • Elencare il contenuto di un bucket: s3cmd ls s3://nome-bucket
  • Inviare un file: s3cmd put example.txt s3://bucket-name/
  • Scaricare un file: s3cmd get s3://bucket-name/example.txt
  • Sincronizzare una directory locale con un bucket: s3cmd sync /path/local/ s3://bucket-name/

 

In caso di problemi

A seguito di un aggiornamento dello strumento AWS CLI (Amazon Web Services Command Line Interface), potrebbe verificarsi un errore durante il tentativo di connessione o di trasferimento di dati in una posizione S3 di Swiss Backup:

Il trasferimento di payload in più blocchi tramite aws-chunked non è supportato

Questo errore è legato a un metodo di trasferimento utilizzato da AWS CLI (aws-chunked), che non è compatibile con il servizio Swiss Backup.

Purtroppo, Infomaniak non ha la possibilità di intervenire su questa incompatibilità, in quanto è legata al funzionamento interno del client AWS CLI, sviluppato da Amazon.

Per continuare a utilizzare Swiss Backup in modo efficace tramite la riga di comando, Infomaniak consiglia di utilizzare lo strumento open-source s3cmd descritto in precedenza in questa guida, che è completamente compatibile con gli spazi di archiviazione S3.


Questa FAQ è stata utile?