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".

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
- Backup que mora no mesmo servidor não é backup
- Por que isso se configura no WHM e não no cPanel do cliente
- Criar as credenciais OAuth no Google Cloud
- Configurar o destino no WHM e validar
- O protocolo de verificação que quase ninguém faz
- Sete erros comuns, sintoma e correção
- Padronizar isso em 10, 20 ou 40 sites
- 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:
- Se a conta é Google Workspace e o app é interno, só usuários do domínio autorizam, o que já resolve o escopo.
- Se o app fica em estado de teste, a Google trata o refresh token como temporário. O destino valida hoje e para de funcionar depois, sozinho, sem ninguém ter mexido em nada. Publique o app ou aceite reautorizar periodicamente, de propósito, com data na agenda.
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:
- Destination Name: nome interno. Use algo que identifique o servidor, não o cliente, porque o destino é do servidor inteiro. Exemplo:
drive-srv01. - Folder: a pasta dentro do Drive que vai receber os arquivos. Se ela não existir, confira o comportamento na sua versão antes de assumir que será criada. Pasta errada é o erro mais chato de todos, porque tudo aparenta sucesso e o arquivo está em outro lugar.
- Client ID e Client Secret: os valores gerados no passo anterior.
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.
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.
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
- Abrir a pasta do Drive de cada servidor e confirmar arquivo com data recente para todas as contas ativas.
- Conferir o espaço livre da conta Google. Quota estourada não avisa no WHM, ela só quebra o upload.
- Baixar um backup sorteado e rodar
gzip -tetar -tzf. - Confirmar o dump SQL com
grep -c 'INSERT INTO'. - Conferir se contas novas criadas no trimestre entraram na rotina.
- Conferir se contas encerradas continuam ocupando espaço no Drive sem necessidade.
- 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
- Documentação oficial (cpanel) — How to Configure Google Drive as a Backup Additional Destination. Consultado em 2026-09-24.