Base de conhecimento

1000 perguntas frequentes, 500 tutoriais e vídeos explicativos. Aqui, você encontra apenas soluções!

Fazer backup de dados via linha de comando no Swiss Backup (CLI S3)

Atualização 01/09/2026

Este guia detalha como fazer o backup manual de dados através da linha de comando (CLI) usando o protocolo Compatível com S3 no Swiss Backup, a solução de backup em nuvem suíça independente.

 

Usar um local S3 na CLI

Pré-requisitos

  • Ter um espaço Swiss Backup Infomaniak com uma quota de dispositivo disponível (mínimo 1) para uma cópia de segurança na nuvem.
  • Adicionar 1 dispositivo do tipo Cloud para obter as configurações compatíveis com S3.
  • Utilizar uma aplicação do tipo Terminal (interface de linha de comando, CLI / Command Line Interface) no seu dispositivo.

Com uma aplicação do tipo Terminal (interface de linha de comando, CLI) no seu dispositivo:

  1. Instale s3cmd, por exemplo, no Debian/Ubuntu:

    sudo apt install s3cmd

    ou no macOS (com Homebrew):

    brew install s3cmd

    e, para Windows, recomenda-se usar S3Express, uma ferramenta de linha de comando de código aberto (precisa de ajuda?).

  2. Insira o seguinte comando para configurar a conexão:

    s3cmd --configure
  3. Preencha os campos com as informações específicas do seu dispositivo (consulte este outro guia):
    • Display name = escolha um nome para o armazenamento.
    • AccessKey e SecretKey = as chaves de acesso geradas no e-mail recebido da Infomaniak após a criação do espaço de armazenamento.
    • Service point = por exemplo, https://s3.swiss-backup02.infomaniak.com (1)
    • Bucket name = default
    • Default region
    • S3 Endpoint: use a URL fornecida pela Infomaniak
    • Use HTTPS: sim
    • HTTP Proxy server: deixe em branco, a menos que haja uma configuração específica
    • Signature version: force o uso da versão v4
    • Path style: escolha Sim, se solicitado
    • Test access: você pode fazer o teste para validar a configuração

(1) A indicação "//s3.swiss-backup02", "//s3.swiss-backup03", etc., muda de acordo com o número do cluster indicado no Manager, nas informações de armazenamento em nuvem, em "Localização"; e, se o seu dispositivo Swiss Backup foi criado antes de outubro de 2020, deverá usar https://swiss-backup.infomaniak.com/identity/v3.

Após a conclusão, um arquivo de configuração será salvo (por padrão, em ~/.s3cfg).

 

Iniciar uma cópia para o Swiss Backup

Aqui estão alguns comandos básicos para interagir com o Swiss Backup:

  • Listar os buckets: s3cmd ls
  • Listar o conteúdo de um bucket: s3cmd ls s3://nome-do-bucket
  • Enviar um arquivo: s3cmd put example.txt s3://bucket-name/
  • Baixar um arquivo: s3cmd get s3://bucket-name/example.txt
  • Sincronizar um diretório local com um bucket: s3cmd sync /path/local/ s3://bucket-name/

 

Em caso de problema

Após uma atualização da ferramenta AWS CLI (Interface de Linha de Comando dos Serviços Web da Amazon), poderá encontrar um erro ao tentar conectar-se ou transferir dados para um local S3 do Swiss Backup:

A transferência de dados em vários blocos usando o aws-chunked não é suportada

Este erro está relacionado com um método de transferência utilizado pela AWS CLI (aws-chunked), que não é compatível com o serviço Swiss Backup.

Infelizmente, a Infomaniak não tem a possibilidade de intervir nesta incompatibilidade, pois esta está relacionada com o funcionamento interno do cliente AWS CLI, desenvolvido pela Amazon.

Para continuar a usar o Swiss Backup de forma eficiente através da linha de comando, a Infomaniak recomenda o uso da ferramenta de código aberto s3cmd, descrita anteriormente neste guia, que é totalmente compatível com os locais S3.


Esta seção de perguntas frequentes foi útil?