blog
Painéis

Backup automático do cPanel no Google Drive, e como verificar

O procedimento documentado do cPanel, o fluxo OAuth no Google Cloud e o protocolo de conferência que separa "configurei" de "o backup existe e restaura".

JR · · 10 min de leitura · 2 tabelas · 3 blocos de código

Resposta curta: no WHM, na seção Additional Destinations da interface Backup Configuration, você cria um destino Google Drive com Client ID e Client Secret gerados no Google Cloud, autoriza via OAuth e valida. Só considere o cliente protegido depois de abrir o .tar.gz no Drive e confirmar o dump SQL dentro dele.

Neste artigo
  1. Backup que mora no mesmo servidor não é backup
  2. Por que isso se configura no WHM e não no cPanel do cliente
  3. Criar as credenciais OAuth no Google Cloud
  4. Configurar o destino no WHM e validar
  5. O protocolo de verificação que quase ninguém faz
  6. Sete erros comuns, sintoma e correção
  7. Padronizar isso em 10, 20 ou 40 sites
  8. A frase que você manda para o cliente

Backup que mora no mesmo servidor não é backup

A cópia que fica em /home/usuario/backups protege contra um tipo só de acidente: o erro humano. Plugin que quebrou o layout, tema atualizado no meio do dia, tabela apagada por engano. Para isso ela serve, e serve bem.

Não protege contra o resto. Conta suspensa por falta de pagamento do cliente, disco que falha, invasão que criptografa o home inteiro, conta encerrada por engano em uma migração. Nesses casos o backup morre junto com a coisa que ele deveria restaurar.

Esse é o ponto que trabalha contra quem vende disco: aumentar o plano para caber mais backup local não aumenta a sobrevivência da cópia. O que aumenta é a cópia sair do servidor. Google Drive é uma das opções documentadas pelo cPanel como destino adicional (*Additional Destination*), ao lado de FTP, SFTP, Amazon S3, Backblaze B2, WebDAV e Rsync. Se a sua realidade é uma agência com 10 ou 40 sites e a conta Google Workspace do escritório já existe e já é paga, o Drive costuma ser o caminho de menor atrito.

O que ele não é: versionamento infinito, retenção legal, nem cofre imutável. Se alguém tiver acesso à conta Google, apaga o backup. Trate a conta do Drive que recebe backup com o mesmo cuidado que trata a senha de root: 2FA ligado, e de preferência uma conta de serviço do escritório, não a conta pessoal de um sócio que pode sair da empresa.

Por que isso se configura no WHM e não no cPanel do cliente

Aqui mora a confusão que faz muita gente perder uma tarde.

O destino remoto de backup é configurado no WHM, na interface *Backup Configuration*, na seção *Additional Destinations*. Na maioria das instalações essa interface é de nível root. Um revendedor com WHM limitado normalmente não a enxerga, e um usuário final com acesso só ao cPanel definitivamente não a tem.

O que existe do lado do usuário cPanel é outra coisa: *Backup* e *Backup Wizard*, que geram e baixam um backup completo da conta para a sua máquina, ou enviam para um destino remoto informado na hora (FTP/SCP), sem agendamento. É útil como ação pontual, antes de uma migração ou de uma atualização grande. Não é rotina automatizada.

Traduzindo para a rotina de quem atende cliente:

Você tem Onde configura Dá para agendar Cobre o quê
Root no servidor (VPS/dedicado) WHM » Backup Configuration » seção Additional Destinations Sim Todas as contas do servidor
WHM de revendedor Depende do provedor; confirme antes Depende As contas da sua revenda, se liberado
Só cPanel da conta cPanel » Backup / Backup Wizard Não Aquela conta, sob demanda

Se você é revendedor e não vê *Backup Configuration*, a pergunta certa para o provedor é objetiva: "o backup remoto das contas da minha revenda é feito por vocês, com qual frequência, e para onde? Posso apontar um destino próprio?". A resposta define se você precisa de uma rotina paralela.

Criar as credenciais OAuth no Google Cloud

O cPanel não conversa com o Drive usando e-mail e senha. Ele usa OAuth, e você precisa gerar um par de Client ID e Client Secret no Google Cloud Console antes de abrir o WHM. A documentação oficial do cPanel descreve esse pré-requisito.

Criar o projeto e ativar a Google Drive API

No Google Cloud Console, crie um projeto (nome sugerido, e isto é exemplo: backup-cpanel-agencia) e ative a Google Drive API para ele.

Sem a API ativada, a falha pode aparecer em dois momentos diferentes, e é por isso que o diagnóstico confunde: em alguns projetos o próprio fluxo de autorização já retorna erro na criação do destino; em outros a autorização conclui normalmente e são as chamadas de upload que passam a falhar depois. O tratamento é o mesmo nos dois casos: ativar a Drive API no projeto e refazer a autorização do destino.

Tela de consentimento e o token que expira sozinho

Configure a tela de consentimento OAuth. Dois detalhes que geram dor de cabeça semanas depois:

Gerar o Client ID e o Client Secret e guardar os dois

Crie a credencial do tipo OAuth Client ID. Guarde os dois valores no gerenciador de senhas do time, no mesmo cofre onde ficam as credenciais do servidor. Você vai precisar deles de novo quando trocar de servidor ou refazer o destino.

Configurar o destino no WHM e validar

Criar o destino Google Drive em Additional Destinations

Em WHM » *Backup Configuration*, garanta primeiro que o backup está habilitado e com uma agenda definida (diário, semanal, mensal e a retenção de cada um). Destino remoto sem backup habilitado não envia nada.

Na seção *Additional Destinations*, dentro dessa mesma interface, escolha Google Drive e crie o destino. Os campos principais, conforme a documentação do cPanel:

Autorizar com a conta certa e validar a transferência

O botão de gerar credenciais abre o fluxo de autorização da Google em outra janela. Você faz login com a conta que vai guardar os backups, não com a sua conta pessoal aberta no navegador. É clássico: autoriza com a conta errada, o backup vai para o Drive do sócio, o sócio sai da empresa, a pasta some com ele.

Depois de autorizar, salve com a opção que valida o destino. A validação faz uma transferência de teste. Se ela falhar, o cPanel diz onde travou, e é melhor resolver agora do que descobrir na madrugada seguinte.

Deixar o destino Enabled, não só criado

Confirme que o destino ficou Enabled. E decida conscientemente se quer manter a cópia local além da remota: manter as duas dá restauração rápida no dia a dia e sobrevivência no desastre, ao custo de disco.

Do Google Cloud ao destino ativo no WHMProjeto no Google CloudAtivar a Google Drive APITela de consentimentoApp publicado, não em testeClient ID e SecretGuardar no cofre do timeDestino no WHMAdditional Destinations, Google DriveSalvar validandoDeixar o destino Enabled
A ordem importa: sem a Drive API ativa, a autorização conclui e o upload falha depois.

O protocolo de verificação que quase ninguém faz

Validação do cPanel passou significa "consegui escrever um arquivo de teste na pasta". Não significa "o backup do cliente está íntegro e restaurável". A verificação de verdade é sua, e leva alguns minutos por servidor.

Conferir a pasta do Drive no dia seguinte

Abra a pasta configurada. Você quer ver um arquivo por conta, com data de hoje, e tamanho compatível com o tamanho da conta. Backup de um WordPress com biblioteca de mídia cheia que aparece com poucos KB é upload interrompido, não compressão milagrosa.

Compare com o tamanho do arquivo local, quando ele existe. Diferença grande entre local e remoto é transferência truncada.

Baixar um arquivo e testar a integridade com gzip -t

Escolha um cliente por servidor, por trimestre, e baixe de verdade. O download já testa uma coisa que ninguém testa: se o arquivo sai do Drive.

# integridade do gzip (silêncio = arquivo íntegro)
gzip -t backup-1.15.2026_03-20-11_cliente.tar.gz

# listar o conteúdo sem extrair
tar -tzf backup-1.15.2026_03-20-11_cliente.tar.gz | head -30

Confirmar que o dump SQL está dentro do .tar.gz

É aqui que o "cliente protegido" vira verdade ou vira ilusão. Site WordPress sem dump SQL é um monte de arquivo PHP sem posts, sem páginas e sem configuração.

# procurar os dumps dentro do backup
tar -tzf backup-1.15.2026_03-20-11_cliente.tar.gz | grep -i '\.sql'

# extrair só o diretório de banco para conferir
tar -xzf backup-1.15.2026_03-20-11_cliente.tar.gz --wildcards '*/mysql/*'

# o dump precisa ter CREATE TABLE e INSERT, não só cabeçalho
head -20 */mysql/cliente_wp.sql
grep -c 'INSERT INTO' */mysql/cliente_wp.sql

A estrutura interna do arquivo varia entre versões do cPanel e entre backup compactado e não compactado, então trate os caminhos acima como ponto de partida e ajuste ao que o tar -tzf mostrar. O critério não muda: existe dump, o dump tem tabelas, o dump tem linhas.

Restaurar um cliente sorteado uma vez por ano

O teste definitivo é restaurar. Em um subdomínio de staging, em uma conta descartável, no seu ambiente local com Docker, tanto faz. Restaurar uma vez por ano um cliente sorteado descobre problemas que nenhuma listagem de tar descobre.

Protocolo de verificação por servidorAbrir a pasta do servidorArquivo por conta, data de hojeComparar tamanhosRemoto muito menor é truncadoBaixar um sorteadoTesta se o arquivo sai do Drivegzip -t e tar -tzfSilêncio significa arquivo íntegroProcurar o dump SQLCREATE TABLE e INSERT INTOAnotar na planilhaData, responsável, resultado
Validação do cPanel só prova que a escrita funcionou. O resto é conferência manual.

Sete erros comuns, sintoma e correção

Sintoma Causa provável O que fazer
Destino validava e parou de enviar sem ninguém mexer Refresh token expirado, app OAuth em estado de teste Publicar o app na tela de consentimento e gerar as credenciais de novo no destino
Erro de autorização na criação do destino, ou autorização que conclui e nenhum upload completa Google Drive API não ativada no projeto Ativar a API no projeto do Cloud Console e refazer a autorização do destino
Upload começa e falha sempre no mesmo ponto Quota do Drive estourada ou backup maior que o espaço livre Conferir armazenamento da conta Google, reduzir o backup com exclusões, ou separar contas grandes em outro destino
Validação passa, mas nenhum backup aparece Pasta de destino diferente da que você está olhando, ou autorização feita com a conta Google errada Conferir o campo de pasta e refazer o OAuth com a conta correta
Arquivo no Drive muito menor que o esperado Transferência interrompida por timeout ou limite de rede Baixar e rodar gzip -t; se falhar, revisar janela de backup e tamanho das contas
Backup local existe, remoto não Destino desabilitado ou backup remoto desligado para aquele tipo (diário/semanal/mensal) Verificar o status *Enabled* do destino e a configuração de cada agenda
Nada é gerado, nem local nem remoto Backup desabilitado no WHM, ou disco do servidor cheio Checar o espaço livre antes de qualquer coisa; backup não roda em disco lotado

Um hábito que economiza horas: depois de qualquer mudança no destino, não espere a madrugada. Force uma execução ou use a validação do próprio destino e olhe o resultado no mesmo dia.

Padronizar isso em 10, 20 ou 40 sites

O ganho não está em configurar bonito uma vez. Está em conseguir responder, em trinta segundos e sem abrir o servidor, "onde está o backup do cliente X e de quando ele é".

Uma pasta por servidor, não por cliente

Uma pasta por servidor, não por cliente, porque o destino é do servidor. Dentro do Drive:

/backups-cpanel/
  srv01/
  srv02/
  srv03/

Se você atende clientes em servidores de provedores diferentes, o nome da pasta deve deixar isso óbvio, porque no dia do incêndio ninguém lembra qual conta estava onde.

Planilha de controle com uma linha por conta

Colunas mínimas: cliente, domínio, servidor, destino remoto, frequência, retenção, data da última conferência manual, data do último teste de restauração, responsável. Essa planilha é o que você mostra ao cliente quando ele pergunta se tem backup, e é o que permite outra pessoa do time assumir a conta sem entrevistar você.

Checklist trimestral de sete itens

  1. Abrir a pasta do Drive de cada servidor e confirmar arquivo com data recente para todas as contas ativas.
  2. Conferir o espaço livre da conta Google. Quota estourada não avisa no WHM, ela só quebra o upload.
  3. Baixar um backup sorteado e rodar gzip -t e tar -tzf.
  4. Confirmar o dump SQL com grep -c 'INSERT INTO'.
  5. Conferir se contas novas criadas no trimestre entraram na rotina.
  6. Conferir se contas encerradas continuam ocupando espaço no Drive sem necessidade.
  7. Anotar a data da conferência na planilha.

Sete itens, alguns minutos por servidor, quatro vezes por ano. É a diferença entre dizer "tem backup" e saber que tem.

Nem tudo precisa ir para o mesmo lugar

Site institucional que muda uma vez por mês e loja com pedido entrando toda hora não têm a mesma necessidade. Para a loja, backup diário do servidor pode não ser suficiente, e a conversa passa a ser sobre dump de banco mais frequente. Cobrar isso separadamente é honesto: é trabalho adicional e custo de armazenamento adicional.

A frase que você manda para o cliente

Cliente não compra "destino adicional de backup". Ele compra a certeza de não perder oito anos de conteúdo. Use uma frase curta, sem jargão, de preferência por escrito, para ficar registrada:

Se o cliente perguntar quanto tempo leva para restaurar, responda com o que você mediu no seu último teste de restauração, não com uma estimativa. Se você nunca testou, a resposta honesta é "ainda não medi, vou medir e te digo". Depois meça.

E quando o backup completo da conta for grande demais para a janela de upload ou para o espaço no Drive, o caminho não é comprar mais armazenamento por reflexo. É olhar o que está inflando o arquivo: cache em disco, logs antigos, pasta de uploads com originais de imagem que ninguém usa, backups de plugin de backup dentro do wp-content. Reduzir o que entra no tar costuma resolver sem custo nenhum, e ainda deixa a restauração mais rápida.

Referências

  1. Documentação oficial (cpanel) — How to Configure Google Drive as a Backup Additional Destination. Consultado em 2026-09-24.
Leia também