blog
Painéis

E-mail conecta mas a caixa fica vazia depois da migração

A conta loga, o disco está ocupado e a INBOX lista zero. A ordem de checagem antes de mexer, o reparo de dono e permissão e o passo que apaga as mensagens do cliente se você inverter a sequência.

JR · · 11 min de leitura · 2 tabelas · 8 blocos de código

Resposta curta: caixa vazia depois de migração quase nunca é mensagem perdida: os arquivos seguem em /home/usuario/mail/dominio/conta e a listagem só quebra por dono errado ou por diretório sem bit de execução. Confirme cur/new antes de tocar em qualquer coisa e nunca recrie a conta primeiro.

Neste artigo
  1. A conta autentica, a INBOX lista zero mensagem
  2. Prove que as mensagens estão no disco antes de corrigir qualquer coisa
  3. Ler o resultado antes de escolher a correção
  4. Corrigir dono e permissão da Maildir
  5. Quando as pastas somem mas as mensagens ficam
  6. Recriar a conta nunca é o primeiro passo
  7. Checklist em lote para carteira migrada
  8. Como explicar ao cliente sem gerar pânico

A conta autentica, a INBOX lista zero mensagem

O cliente configura o Outlook ou o Thunderbird, a senha é aceita, a conta conecta. E a INBOX aparece vazia. No webmail, a mesma coisa: entra, não dá erro, não tem mensagem. O disco da conta, no entanto, continua ocupado.

Esses dois fatos juntos, autenticação OK e lista vazia, apontam para um lugar só: autenticação e leitura de arquivo são etapas diferentes. O login é validado contra a base de contas do cPanel. A listagem de mensagens depende do servidor IMAP conseguir abrir os diretórios da Maildir em /home/usuario/mail/dominio/conta. Se o dono veio errado da migração, ou se os diretórios perderam o bit de execução, o processo que roda como o usuário da conta não consegue percorrer nada, e uma Maildir ilegível se comporta exatamente como uma Maildir vazia.

Pré-requisito de acesso. O diagnóstico e o reparo descritos aqui exigem SSH como root no servidor ou WHM. Se você administra sites em revenda ou compartilhado e só tem cPanel, você consegue fazer parte da verificação pelo Gerenciador de Arquivos (ver se cur e new existem e têm mensagens dentro de mail/dominio/conta), mas não consegue corrigir dono. Nesse caso, pule para a subseção "Se você só tem cPanel" e abra chamado com as informações certas em vez de tentar contornar.

Não há medição própria neste artigo. O que vem abaixo é procedimento de diagnóstico e a ferramenta documentada do WHM para corrigir dono e permissão de caixas.

Por que autentica e mesmo assim lista zeroSenha aceitaLogin validado na base cPanelIMAP abre a MaildirPrecisa de dono e bit xLista chega ao clienteSem leitura, caixa parece vazia
Autenticar e listar são etapas distintas: a falha está na segunda.

Prove que as mensagens estão no disco antes de corrigir qualquer coisa

Essa é a parte que agência migrando carteira costuma pular, e é a que decide todo o resto. Enquanto você não confirmar que os arquivos existem, qualquer correção é chute, e chute em servidor de e-mail apaga mensagem.

Localize a Maildir da conta em /home/usuario/mail

Contas de e-mail de domínio ficam em /home/usuario/mail/dominio/conta. A caixa padrão do próprio usuário do cPanel fica um nível acima, em /home/usuario/mail, com cur e new direto ali.

ls -la /home/usuario/mail/exemplo.com.br/contato/

Você espera ver, no mínimo, cur, new e tmp. Se esses três diretórios não existem, o problema não é permissão, é que a Maildir não foi copiada.

Conte os arquivos em cur e em new

ls -1 /home/usuario/mail/exemplo.com.br/contato/cur | wc -l
ls -1 /home/usuario/mail/exemplo.com.br/contato/new | wc -l
du -sh /home/usuario/mail/exemplo.com.br/contato/

cur guarda as mensagens já vistas pelo cliente, new guarda as que ainda não foram entregues ao cliente. Contagem alta em cur com INBOX vazia no webmail é a assinatura clássica do problema de leitura.

Compare dono e permissão com uma conta que funciona

Este passo evita que você invente o valor "certo" de permissão. Pegue uma conta do mesmo servidor que está listando mensagens normalmente e compare:

stat -c '%U:%G %a %n' /home/usuario/mail/exemplo.com.br/contato \
  /home/usuario/mail/exemplo.com.br/contato/cur

stat -c '%U:%G %a %n' /home/outro/mail/outrodominio.com.br/financeiro \
  /home/outro/mail/outrodominio.com.br/financeiro/cur

Duas coisas diferentes saem daí, e vale não misturar:

Faça o backup da caixa antes de mexer em dono ou modo

tar -czf /root/maildir-contato-$(date +%F).tar.gz \
  -C /home/usuario/mail/exemplo.com.br contato

Custa segundos e é o que separa "corrigi a permissão" de "apaguei a caixa do cliente".

Ler o resultado antes de escolher a correção

O que você viu Leitura provável Ação
cur com muitos arquivos, dono root ou usuário de outro servidor Dono errado depois de restauração ou rsync como root Corrigir dono e, na sequência, normalizar a permissão
cur com arquivos, dono correto, diretórios sem bit de execução (0644, 0600) chmod -R achatou diretório e arquivo no mesmo modo Corrigir só a permissão, separando diretório de arquivo
cur com arquivos, dono correto, diretórios 0755 e arquivos 0644 Fora do padrão do cPanel, mas legível Não é a causa da caixa vazia; normalize depois e continue procurando
cur e new vazios, du perto de zero A Maildir não veio na migração Voltar ao backup ou refazer a transferência, não mexer em permissão
Mensagens em cur, mas pastas do cliente sumiram Arquivo de assinatura IMAP perdido Reassinar as pastas, ver seção específica
Tudo certo no disco e ainda vazio no cliente O cliente pode estar conectando no servidor antigo Conferir para onde o hostname de e-mail resolve antes de mexer no servidor novo

A última linha é a que mais economiza trabalho. Se o registro de e-mail do domínio ainda aponta para a hospedagem antiga, ou se o cliente tem um mail.dominio fixado no arquivo de hosts dele, nenhuma correção de permissão vai mudar o que ele vê. Teste com o webmail do servidor novo acessado pelo IP ou pelo hostname do servidor, não pelo domínio do cliente.

Corrigir dono e permissão da Maildir

Repair Mailbox Permissions, a ferramenta do WHM para várias contas

O cPanel tem uma interface própria para isso, em WHM > Email > Repair Mailbox Permissions. Segundo a documentação oficial do cPanel, a ferramenta corrige dono e permissão dos arquivos de caixa de correio das contas cPanel que você selecionar na lista. É isso que a página descreve, e é só isso que eu afirmo sobre o que ela faz.

Recomendo essa opção para agência por dois motivos práticos, e aqui é avaliação minha, não documentação: ela trata várias contas em uma única passada, o que importa quando você migrou uma carteira inteira, e não depende de você acertar a sintaxe de um find às onze da noite.

Depois de rodar, repita o stat do passo 3. Se o dono e o modo mudaram para o padrão da conta saudável, siga para a validação.

Correção manual por SSH, uma caixa por vez

Use quando você quer tratar uma única caixa e já sabe exatamente o que está errado.

CAIXA=/home/usuario/mail/exemplo.com.br/contato

chown -R usuario:usuario "$CAIXA"
find "$CAIXA" -type d -exec chmod 0700 {} +
find "$CAIXA" -type f -exec chmod 0600 {} +

Repare que diretório e arquivo são tratados em comandos separados. Um chmod -R 0700 no caminho inteiro deixaria todo arquivo de mensagem com bit de execução, e um chmod -R 0600 tiraria o bit de entrada dos diretórios, o que quebra a caixa de um jeito novo. Achatar permissão com -R é a forma mais comum de transformar um problema pequeno em um problema grande.

Não saia aplicando isso em /home/usuario/mail inteiro por reflexo: o diretório mail do usuário e alguns diretórios de serviço do cPanel não usam necessariamente o mesmo modo das pastas internas da Maildir. Se a dúvida aparecer, volte para a opção A.

Se você só tem cPanel, sem WHM e sem SSH

Sem WHM e sem SSH, você não corrige dono. O que dá para fazer, e adianta muito o chamado, é levar o diagnóstico pronto. Pelo Gerenciador de Arquivos, com "mostrar arquivos ocultos" ligado, abra mail/dominio/conta e anote:

Texto pronto para o chamado: "A conta [email protected] autentica normalmente no webmail, mas a INBOX lista zero mensagem. A pasta mail/exemplo.com.br/contato/cur tem 4.312 arquivos e a conta ocupa 2,1 GB. Suspeito de dono ou permissão errada na Maildir depois da migração. Peço reparo de permissões de caixa nessa conta. Não recriem a conta." Essa última frase evita o pior desfecho possível.

Validar no webmail do servidor, não no Outlook do cliente

Valide sempre no webmail do servidor, não no Outlook do cliente. O cliente desktop tem cache local, índice próprio e pode mostrar o estado antigo por minutos. Abra o webmail, entre na conta, confira se a INBOX lista, se as pastas aparecem e se uma mensagem antiga abre de verdade, com corpo e anexo. Só depois peça para o cliente testar.

Quando as pastas somem mas as mensagens ficam

Outro cenário pós-migração: a INBOX volta, mas as pastas que o cliente tinha (Arquivo, Clientes, 2024) não aparecem no programa de e-mail, embora os diretórios com ponto na frente estejam lá no disco, cheios de mensagens.

No formato Maildir++, cada pasta é um diretório iniciado por ponto, com seus próprios cur, new e tmp. A lista do que o cliente IMAP enxerga vem de um arquivo de assinaturas dentro da caixa, e esse arquivo, ou a cota e os índices, é o tipo de coisa que se perde ou vem com dono errado na cópia.

ls -la /home/usuario/mail/exemplo.com.br/contato/ | grep '^d' | head -20

O que é recriável sem perder mensagem:

Arquivo Para que serve Se sumir ou vier corrompido
subscriptions Lista de pastas assinadas no IMAP Pasta existe no disco mas não aparece no cliente; reassinar resolve
maildirsize Cache do cálculo de cota É recalculado; caixa pode aparecer cheia até recalcular
dovecot-uidlist e dovecot.index* Índice e numeração das mensagens São reconstruídos na próxima leitura da pasta

Mensagem nenhuma está nesses arquivos. As mensagens são os arquivos soltos dentro de cur e new. Por isso apagar índice é operação de baixo risco, desde que o backup da seção anterior já esteja feito, e que você apague com alvo explícito, nunca com curinga solto no diretório.

Para as pastas voltarem à vista do cliente, o caminho mais seguro é abrir o webmail e reassinar as pastas na tela de gerenciamento de pastas. Isso regrava o arquivo de assinaturas com o dono correto, sem você editar nada na mão. Se o problema for só de dispositivo, a assinatura IMAP também explica pasta que aparece no webmail e não no celular.

Recriar a conta nunca é o primeiro passo

A reação padrão de quem está com pressa é apagar a conta no cPanel e criar de novo com a mesma senha, porque "assim ela nasce limpa". Nasce mesmo. Sem as mensagens.

Remover uma conta de e-mail remove o diretório da caixa junto. As mensagens que estavam ilegíveis por permissão, e que seriam recuperadas com um reparo de cinco minutos, viram restauração de backup, se houver backup, e perda definitiva, se não houver. É o único passo desse roteiro que não tem volta.

Ordem fixa, e vale colar no runbook da agência:

  1. Confirmar que cur e new têm arquivos.
  2. Fazer o tar da caixa.
  3. Corrigir dono e permissão (WHM, SSH ou chamado, conforme o seu acesso).
  4. Validar no webmail.
  5. Reassinar pastas, se for o caso.
  6. Só então, se o disco estiver realmente vazio e o backup confirmar que nunca houve mensagem, considerar recriar a conta.
Ordem de reparo de caixa vazia pós-migraçãoConfirmar arquivos em cur e newSem isso, qualquer correção é chuteBackup tar.gz da caixaGuardar fora do /homeCorrigir dono e permissãoWHM, SSH ou chamadoValidar no webmail do servidorAbrir mensagem antiga com anexoReassinar pastas, se faltaremPela tela de pastas do webmailRecriar conta, só em último casoApagar a conta apaga as mensagens
Ordem fixa para colar no runbook da agência.

Checklist em lote para carteira migrada

Quem migrou trinta contas não vai auditar uma por uma na mão. Rode primeiro um levantamento que só lê, sem alterar nada, e olhe o resultado antes de decidir. Os dois comandos abaixo precisam de root.

# Inventário: dono, grupo, modo e contagem de mensagens de cada caixa
for d in /home/*/mail/*/*; do
  [ -d "$d/cur" ] || continue
  dono=$(stat -c '%U:%G %a' "$d")
  qtd=$(ls -1 "$d/cur" | wc -l)
  echo "$dono  cur=$qtd  $d"
done | sort

Com o sort no fim do laço, a saída sai agrupada por dono e as linhas que destoam do padrão do servidor ficam visíveis em bloco.

O teste que realmente isola a caixa quebrada não é contar quantos donos existem (num servidor com várias contas cPanel, um dono por conta é o estado normal), e sim comparar o dono de cada Maildir com o dono do /home correspondente:

# Lista só as caixas cujo dono diverge do dono do home do usuário
for d in /home/*/mail/*/*; do
  [ -d "$d/cur" ] || continue
  home=$(echo "$d" | cut -d/ -f1-3)
  esperado=$(stat -c '%U' "$home")
  atual=$(stat -c '%U' "$d")
  [ "$atual" = "$esperado" ] && continue
  echo "DIVERGENTE esperado=$esperado atual=$atual $d"
done

Saída vazia significa que dono não é o seu problema, e você volta a olhar bit de execução de diretório, rota de DNS ou cache do cliente. Saída com linhas te dá exatamente a lista de contas cPanel a selecionar na tela Repair Mailbox Permissions do WHM, o que é mais rápido e mais seguro do que um chown recursivo improvisado em /home.

Checklist para fechar o chamado:

Como explicar ao cliente sem gerar pânico

O cliente que abre o Outlook e vê a caixa vazia já assumiu que perdeu tudo. A explicação precisa desarmar isso na primeira frase, antes de qualquer detalhe técnico.

Duas orientações que valem junto com a frase, e que evitam o chamado seguinte: peça para o cliente não apagar e recriar a conta no programa de e-mail enquanto você trabalha, e avise que, em conta IMAP antiga, o cliente desktop pode levar alguns minutos para recarregar o índice depois do reparo. Se ele confirmar no webmail antes, a ansiedade acaba ali.

Referências

  1. Documentação oficial (cpanel) — Repair Mailbox Permissions. Consultado em 2026-09-24.
Leia também