Backup Automático

O que faz

O Backup Automático ajuda você a criar, organizar e restaurar backups versionados

de pastas importantes e bancos de dados, com uma rotina previsível e fácil de auditar.

Em vez de "zipar a pasta de vez em quando", o plugin padroniza os backups: nomeia os

arquivos com data e hora, aplica uma política de retenção (quantas cópias manter),

verifica a integridade e deixa a restauração a um comando de distância.

Ele cobre os dois casos mais comuns: backup de arquivos (uma pasta de projeto,

conteúdo ou configurações, via tar/zip) e backup de banco de dados (dump de

PostgreSQL com pg_dump, por exemplo). E, mais importante, ele leva a restauração a

sério — backup que ninguém sabe restaurar não é backup.

Casos de uso típicos:

• Snapshot diário de uma pasta de trabalho antes de mexer em algo arriscado.
• Dump versionado do banco de produção/staging para um diretório seguro.
• Retenção automática (ex.: manter os últimos 7 diários e 4 semanais).
• Restaurar rapidamente um backup específico quando algo der errado.

Instalação

1. Copie a pasta backup-automatico/ para o diretório de plugins do Claude Code.
2. Garanta as ferramentas do sistema conforme o uso: tar/zip para arquivos e

pg_dump/pg_restore para Postgres.

1. Defina o destino dos backups em BACKUP_DEST_DIR e demais variáveis (veja

Configuração).

1. (Opcional) Agende o backup como tarefa recorrente combinando com o

agendador-cron.

Comandos disponíveis

• /backup-criar — cria um backup versionado de uma pasta ou de um banco, aplica a

retenção e verifica a integridade do arquivo gerado.

• /backup-restaurar — lista os backups disponíveis e restaura o escolhido, sempre

com confirmação antes de sobrescrever dados.

Configuração

Sempre por nome de variável de ambiente — nunca cole credenciais reais.

• BACKUP_DEST_DIR — obrigatória. Pasta onde os backups serão guardados

(idealmente em outro disco/volume, não junto dos dados originais).

• BACKUP_RETENTION — opcional; quantas cópias manter por tipo (padrão: 7).
• BACKUP_SOURCE_DIR — opcional; pasta padrão a ser copiada quando não especificada.
• BACKUP_DB_URL — opcional; string de conexão do banco a fazer dump

(postgresql://USUARIO:SENHA@HOST:PORTA/BANCO). Use por nome, nunca em texto fixo.

• SLACK_WEBHOOK_URL — opcional; se definido, permite avisar o time ao concluir/falhar

(via slack-notificador).

Exemplo de uso

/backup-criar Faça backup da pasta ./conteudo e mantenha as últimas 7 cópias.

O Claude gera conteudo-2026-06-16-0900.tar.gz em BACKUP_DEST_DIR, confere o

tamanho/integridade, remove cópias antigas além da retenção e relata o resultado. Para

restaurar:

/backup-restaurar

Ele lista os backups com data e tamanho, você escolhe um, confirma, e o plugin

restaura para a pasta indicada — sem sobrescrever nada sem o seu "ok".

Segurança e limites

• Regra 3-2-1: mantenha pelo menos 3 cópias, em 2 mídias, com 1 fora do local.

BACKUP_DEST_DIR deve idealmente ficar em outro volume ou em armazenamento remoto.

• Restauração testada. O plugin facilita restaurar, mas teste a restauração

periodicamente — é a única forma de saber que o backup funciona.

• Segredos no dump. Dumps de banco contêm dados sensíveis (LGPD). Restrinja

permissões da pasta de destino e considere criptografar os arquivos.

• Confirmação na restauração. Restaurar pode sobrescrever dados atuais; o comando

sempre pede confirmação explícita e descreve o que será substituído.

• Espaço em disco. Backups crescem; a retenção evita encher o disco, mas monitore

o espaço de BACKUP_DEST_DIR.

• Sem upload automático para a nuvem por padrão. O plugin gera arquivos locais;

envie-os para um bucket/remoto conforme sua política, se desejar.