Base de Conhecimento

Restic na VPS: backup automático do servidor

  • restic, backup, sftp, systemd, vps
  • Usuários acharam útil: 0

Restic 0.19.1: instalação pelo binário oficial, chave SSH e destino SFTP, senha do repositório, backup com exclusões e de banco, forget, prune e check, restauração e agendamento.

Por Redação Eleven Host · @robson.direitodigital · 14 de novembro de 2026 · 11 min de leitura

Arte da Eleven Host: janela de terminal com o título: Restic na VPS: backup automático do servidor

Capa da Redação Eleven Host para o tutorial: Restic na VPS: backup automático do servidor Arte: Eleven Host

Restic na VPS é um programa de backup de linha de comando, com criptografia e deduplicação, que envia a cópia do servidor para um destino SFTP fora da máquina. Em 14/11/2026, a versão estável é a 0.19.1.

Atualizado em 14/11/2026. Os blocos de exemplo são pontos de partida: confira cada um no seu servidor antes de agendar. O artigo O que é servidor VPS: guia simples para iniciantes explica o que é uma VPS, caso você ainda esteja começando.

O que é o restic

O restic é um único executável, sem servidor nem configuração complexa. Cada backup envia só as partes dos arquivos que mudaram, e o projeto permite verificar depois se os dados podem ser restaurados. A licença é a BSD-2-Clause, e o projeto não tem edição paga.

A documentação de referência descreve a criptografia: tudo o que o restic grava no repositório é cifrado com AES-256 em modo contador e autenticado com Poly1305-AES, e a chave vem da senha por meio do scrypt. Num backup seguinte, só os blocos alterados dos arquivos são gravados.

Uma cópia que fica na mesma VPS pode sumir junto com ela se a máquina for perdida; por isso, recomendamos manter o repositório em outra máquina.

Em 14/11/2026, a versão estável é a 0.19.1, de 05/07/2026. O apt do Ubuntu 22.04 e do 24.04 entrega versões antigas, e, segundo uma discussão do projeto, o pacote do Ubuntu não tem o comando self-update. Por isso o exemplo abaixo usa o binário oficial.

Qual versão e como instalar

Segundo o projeto, o pacote do Debian se instala com apt-get install restic, e quem achar o pacote desatualizado pode usar um binário oficial. No Ubuntu, packages.ubuntu.com lista o 22.04 com a 0.12.1, o 24.04 com a 0.16.4, o 26.04 com a 0.18.1 e o 26.10 com a 0.19.1. No GitHub do projeto, não há aviso de segurança publicado em 14/11/2026.

O comando restic self-update atualiza o binário oficial; numa discussão do projeto, um usuário explica que o pacote do Debian e do Ubuntu remove o comando. Instalar pelo apt e depois pelo binário também deixaria dois restic no sistema; escolha um dos dois caminhos.

Os exemplos partem de uma VPS Ubuntu nova, acessada por SSH, e os comandos rodam como root (por exemplo, depois de sudo -i), porque o backup lê pastas do sistema. O binário está na página de releases do projeto (github.com/restic/restic/releases/latest): copie o endereço do arquivo do seu sistema e o do SHA256SUMS e baixe os dois na VPS, com o programa de download que o servidor tiver. O projeto também publica a assinatura PGP em SHA256SUMS.asc. Um exemplo de comandos, na pasta do download; confira o nome exato do arquivo na página da release:

sha256sum -c --ignore-missing SHA256SUMS

bunzip2 restic_0.19.1_linux_amd64.bz2

install -m 755 restic_0.19.1_linux_amd64 /usr/local/bin/restic

restic version

Depois, o restic self-update atualiza o binário oficial no lugar, conferindo a assinatura GPG.

Destino da cópia e chave SSH

O destino pode ser um servidor com acesso SFTP: outra VPS ou um armazenamento com SFTP. O restic usa o protocolo SFTP do servidor, então teste antes com sftp usuario@destino.exemplo.com. O 11Cloud, da Eleven Host, é um armazenamento em nuvem com acesso por SFTP/WebDAV (veja o Guia do 11Cloud: por onde começar a usar). Quem pensa em usá-lo deve confirmar no atendimento da Eleven Host se ele serve de destino para o restic e se aceita login por chave SSH.

A documentação do restic pede que o servidor conheça a sua chave pública, e explica o motivo: o login sem senha é importante, porque backups automáticos não funcionam se o servidor pedir credenciais. Um exemplo, na VPS, como root, com um servidor de destino fictício:

ssh-keygen -t ed25519 -f ~/.ssh/restic_destino -N ''

ssh-copy-id -i ~/.ssh/restic_destino.pub usuario@destino.exemplo.com

O ssh-copy-id usa o acesso que você já tem ao destino, como a senha do usuário. Se o destino não aceitar o ssh-copy-id, instale a chave pública da forma que ele permitir. O ~/.ssh/config do root pode dar um apelido ao servidor, como no exemplo da documentação, que usa os campos Host, User e Port. Um exemplo (ajuste o nome, a porta e o usuário), com um campo a mais para a chave:

Host backup

HostName destino.exemplo.com

User usuario

Port 2222

IdentityFile ~/.ssh/restic_destino

Se a porta do destino não for a 22, o ssh-copy-id também precisa dela, com -p. A primeira conexão com um servidor novo pergunta se você confia na impressão digital dele. Teste a conexão uma vez à mão, com sftp backup, antes de agendar.

Armazenamento 11Cloud

O 11Cloud tem planos de 100GB, 500GB, 1TB e 2TB.

Cotas de 100GB a 2TB: 11Cloud a partir de R$ 7,90/mês no plano de 100GB; confira na loja o que cada plano inclui. Ver o 11Cloud

Senha do repositório

Perdeu a senha, perdeu os dados

A documentação do restic avisa que lembrar a senha é importante: sem ela, não há acesso aos dados do repositório, e perdê-la significa perder os dados de forma irrecuperável. Como o arquivo de senha mora na própria VPS, uma VPS perdida leva a senha junto. Guarde uma cópia fora dela, num gerenciador de senhas.

O restic lê a senha de um arquivo apontado por RESTIC_PASSWORD_FILE, e o repositório vem de RESTIC_REPOSITORY. Um exemplo, que cria a senha, restringe o arquivo ao root e junta as duas variáveis num arquivo de ambiente:

mkdir -p /etc/restic && chmod 700 /etc/restic

openssl rand -base64 32 > /etc/restic/senha

chmod 600 /etc/restic/senha

printf 'RESTIC_REPOSITORY=sftp:backup:/srv/restic-repo\nRESTIC_PASSWORD_FILE=/etc/restic/senha\n' > /etc/restic/env

cat /etc/restic/senha

O último comando mostra a senha para você copiar ao gerenciador de senhas. Para usar as variáveis na sessão atual, rode set -a; . /etc/restic/env; set +a.

Criar o repositório

O exemplo da documentação para o SFTP é restic -r sftp:user@host:/srv/restic-repo init. Quando o caminho não começa com barra, ele é relativo à pasta pessoal do usuário remoto; com barra, é absoluto. Com o apelido do ~/.ssh/config e as variáveis do passo anterior, o comando fica curto. Um exemplo:

restic init

O restic cria a estrutura no destino, e a pasta /srv/restic-repo do exemplo precisa poder ser criada pelo usuário remoto.

Fazer o backup

O comando básico é restic backup seguido das pastas. Entre as opções de exclusão da documentação, o --exclude-file lê um padrão por linha e o --one-file-system não atravessa outro sistema de arquivos, pulando /proc e mídias montadas. As exclusões não valem para caminhos passados direto ao backup. Um exemplo de arquivo de exclusões e do backup:

printf '/home/*/.cache\n*.tmp\n' > /etc/restic/excludes

restic backup /etc /home /var/www --exclude-file /etc/restic/excludes --one-file-system --tag diario

O --tag grava uma etiqueta no snapshot. Sobre o resultado: o código de saída 0 indica um backup completo; o 1, um erro fatal sem snapshot; e o 3, que alguns arquivos não puderam ser acessados, com um snapshot incompleto criado.

Banco de dados

Para um banco, a documentação recomenda o --stdin-from-command: o restic roda o comando e, se ele sair com código diferente de zero, cancela o backup e não cria snapshot. O pipe com --stdin é desaconselhado: o restic não consegue saber se os dados do stdin vieram completos, e o pipe esconde os erros do comando, o que leva a backups corrompidos. O exemplo da documentação usa o mysqldump; o --stdin-filename dá nome ao arquivo salvo. Um exemplo de comandos; o dump precisa conseguir autenticar no banco, então confira isso à parte:

restic backup --stdin-from-command --stdin-filename banco.sql -- mysqldump nome_do_banco

restic backup --stdin-from-command --stdin-filename banco.sql -- pg_dump nome_do_banco

A documentação de restauração mostra como trazer o dump de volta: restic dump latest banco.sql | mysql, trocando o nome do arquivo e usando o cliente do seu banco. Se o repositório também tiver snapshots de pastas, confira no restic snapshots qual deles guarda o dump e use o ID dele no lugar de latest.

Listar, limpar e conferir

O restic snapshots lista os snapshots, com ID, data, máquina, tags, pasta e tamanho. O forget remove snapshots e o prune remove os dados que sobram; com --prune, o forget roda o prune se removeu algum snapshot, e --dry-run mostra o que seria feito sem remover nada. Um exemplo de política, que vale testar com --dry-run primeiro:

restic snapshots

restic forget --keep-daily 7 --keep-weekly 4 --keep-monthly 6 --dry-run

restic forget --keep-daily 7 --keep-weekly 4 --keep-monthly 6 --prune

A documentação avisa que o prune pode demorar e que, enquanto ele roda, o repositório fica travado e os backups não terminam. Ela aconselha rodar restic check depois. Sem opções, o check verifica a estrutura do repositório, mas não confere se os arquivos de dados no disco foram alterados. O --read-data confere tudo e baixa tudo, com possível custo de banda; o --read-data-subset confere uma parte. Um exemplo:

restic check --read-data-subset=10%

Uma ideia de rotina: rodar o forget --prune e o check uma vez por semana, fora do horário do backup diário.

Restaurar

Recomendamos restaurar primeiro numa pasta separada. O exemplo da documentação usa --target e a palavra latest para o snapshot mais recente. Um exemplo:

restic restore latest --target /root/restore-teste

restic restore latest --target /root/restore-teste --include /etc/restic

Por padrão, o restore sobrescreve os arquivos que já existem no destino, e restaurar no lugar pode deixar arquivos parcialmente restaurados se a operação for interrompida. Com --delete, o restic apaga os arquivos do destino que não existem no snapshot, e a documentação manda rodar --dry-run -vv antes.

Também dá para navegar pelos snapshots com restic mount /mnt/restic, depois de criar a pasta com mkdir -p /mnt/restic. Desde a 0.19.0, o ponto de montagem precisa ser uma pasta acessível e gravável pelo usuário, e ela tem de existir antes (por exemplo, mkdir -p /mnt/restic). No Ubuntu, o mount pode pedir o pacote fuse3; confira no seu servidor. Se a restauração for para uma VPS nova, o artigo Migrar VPS para outra VPS: como fazer a troca pode ajudar.

Recomendamos testar uma restauração de vez em quando: um backup que ainda não foi restaurado não provou que funciona.

Agendar o backup

O agendamento fica por conta do sistema. Um exemplo com systemd: um serviço /etc/systemd/system/restic-backup.service e um timer /etc/systemd/system/restic-backup.timer, que roda todo dia por volta das 3h. A listagem traz primeiro o conteúdo do serviço e, a partir do segundo [Unit], o do timer.

Conteúdo do serviço, restic-backup.service:

[Unit]

Description=Backup com restic

[Service]

Type=oneshot

Environment=HOME=/root

EnvironmentFile=/etc/restic/env

ExecStart=/usr/local/bin/restic backup /etc /home /var/www --exclude-file /etc/restic/excludes --one-file-system --tag diario

Conteúdo do timer, restic-backup.timer:

[Unit]

Description=Backup diário com restic

[Timer]

OnCalendar=*-*-* 03:00

Persistent=true

RandomizedDelaySec=15min

[Install]

WantedBy=timers.target

Depois de criar os dois arquivos, um exemplo de comandos para ativar, testar uma execução e ver o resultado:

systemctl daemon-reload

systemctl enable --now restic-backup.timer

systemctl start restic-backup.service

journalctl -u restic-backup.service

A manutenção semanal pode seguir o mesmo molde: um segundo serviço com o forget --prune e o check no ExecStart, e um timer com OnCalendar=Sun *-*-* 05:00. Olhe o resultado nos primeiros dias.

VPS na Eleven Host

Preços e descrições dos planos de VPS ficam na loja da Eleven Host.

Ponto de partida do catálogo: VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver as VPS

Perguntas frequentes

O restic é gratuito?

A licença é a BSD-2-Clause, e o projeto não tem edição paga.

Posso instalar pelo apt?

Pode, mas em 14/11/2026 o Ubuntu 22.04 entrega a 0.12.1 e o 24.04, a 0.16.4, contra a 0.19.1 estável. O binário oficial evita essa defasagem.

E se eu perder a senha do repositório?

Segundo a documentação, os dados ficam irrecuperáveis. Guarde uma cópia da senha fora da VPS.

Esta resposta lhe foi útil?

Artigos Relacionados