blog
Painéis

Migrar e-mails de domínio adicional do cPanel em 7 passos

O domínio adicional virou conta própria, o site subiu e as caixas apareceram vazias. O processo de cópia IMAP a IMAP, com a conferência que você faz antes de apagar a origem.

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

Resposta curta: os e-mails de um domínio adicional não migram junto com os arquivos: eles pertencem à conta cPanel principal e precisam ser copiados caixa a caixa por IMAP, em 7 passos, com conferência pasta por pasta antes de remover o domínio da conta antiga.

Neste artigo
  1. Por que as caixas do domínio adicional não viajam com os arquivos
  2. O que a cópia IMAP leva e o que você refaz na mão
  3. Os cinco itens que precisam estar na mesa antes de começar
  4. A ordem de execução que evita retrabalho
  5. Como contar as mensagens e qual diferença é aceitável
  6. Quatro erros que custam caro nessa migração
  7. A frase pronta para explicar a janela ao cliente
  8. Checklist para reutilizar em todo desmembramento

Por que as caixas do domínio adicional não viajam com os arquivos

Quando você tira um domínio adicional de uma conta cPanel e cria uma conta própria para ele, a parte visível da migração é simples: arquivos, banco de dados, certificado, cron. Tudo isso tem ferramenta pronta e o cliente percebe na hora se falhou, porque o site cai.

As caixas de e-mail são o contrário. Elas não caem, elas simplesmente aparecem vazias no servidor novo, e o cliente descobre isso na segunda-feira seguinte procurando um orçamento de três meses atrás.

O motivo é estrutural. As contas de e-mail de um domínio adicional pertencem ao usuário cPanel da conta principal, não ao domínio. Elas moram no diretório de correio daquele usuário. Quando o domínio adicional vira uma conta separada, com outro usuário, outro home e outra cota, não existe nada que faça essas caixas atravessarem sozinhas. A própria cPanel mantém um artigo de base de conhecimento dedicado a esse cenário, How to Migrate the Contents of Email Accounts in Addon Domains, o que já diz bastante sobre quantas migrações esbarram nisso.

Este artigo cobre o caminho que funciona sem acesso root nos dois lados: cópia IMAP a IMAP, com conferência pasta por pasta antes de encostar no domínio adicional da conta antiga. Não há medição própria aqui. Os parâmetros de protocolo são os padrões de IMAP e o caso está documentado pela cPanel no link acima; o resto é organização da tarefa.

O que a cópia IMAP leva e o que você refaz na mão

A cópia IMAP move mensagem. Ela não move configuração de conta. Essa distinção é a origem de quase todo retrabalho pós-migração, então vale imprimir a tabela e usá-la como inventário da conta antiga antes de começar.

Item Onde ver na conta de origem Vai junto na cópia IMAP
Mensagens da INBOX Webmail ou cliente de e-mail Sim
Enviados, Rascunhos, Lixeira, Spam Mesma conexão IMAP Sim, se você incluir as pastas
Subpastas e hierarquia Mesma conexão IMAP Sim
Flags de lido, respondido, favorito Mesma conexão IMAP Sim, com ferramenta que preserve flags
Data interna da mensagem Mesma conexão IMAP Sim, com ferramenta que preserve a data
Senha da caixa Contas de E-mail Não, você define no destino
Cota de disco da caixa Contas de E-mail Não
Filtros por conta e filtros globais Filtros de E-mail Não
Encaminhadores Encaminhadores Não
Respostas automáticas Respondedores Automáticos Não
Endereço padrão, o catch-all Endereço Padrão Não
Listas de discussão Listas de Discussão Não
SPF, DKIM, DMARC Zona DNS e área de entregabilidade Não, refazer no destino

O detalhe que morde é o filtro. Um cliente que há anos manda tudo de nfe@ para uma pasta Fiscal vai continuar recebendo na INBOX depois da migração e vai achar que você perdeu as mensagens antigas. Elas estão lá, na pasta certa, copiadas. O que sumiu foi a regra que alimentava a pasta.

Os cinco itens que precisam estar na mesa antes de começar

Reúna estes cinco itens. Faltando qualquer um, a janela vira improviso.

Senha de cada caixa. A cópia IMAP autentica como o usuário. Você precisa da senha atual de cada conta na origem ou precisa redefinir cada uma, o que quebra o cliente de e-mail do usuário e exige aviso prévio. Se for redefinir, redefina no mesmo dia da cópia e já defina a mesma senha no destino: o cliente reconfigura uma vez só.

Hostname direto dos dois servidores. Não use mail.dominio.com.br em nenhum dos lados. Esse nome vai apontar para um servidor diferente antes e depois da virada de DNS, e durante a janela você precisa falar com os dois ao mesmo tempo. Use o hostname próprio de cada servidor. Prefira hostname a IP, porque o certificado TLS bate com o nome e você evita ter que desligar validação.

Portas 993 ou 143 alcançáveis. 993 é IMAP sobre TLS implícito, 143 é IMAP com STARTTLS. Teste antes, do mesmo lugar de onde você vai rodar a cópia:

# origem, TLS implícito na 993
openssl s_client -connect srv-origem.exemplo.com.br:993 \
  -servername srv-origem.exemplo.com.br </dev/null | head -20

# destino, STARTTLS na 143
openssl s_client -starttls imap \
  -connect srv-destino.exemplo.com.br:143 </dev/null | head -20

O que você espera ver: o certificado do servidor e uma linha de saudação IMAP começando com * OK. Se travar sem resposta, é firewall ou bloqueio de saída do seu provedor de internet, e vale rodar a cópia de um VPS em vez do notebook do escritório.

Domínio ainda resolvendo e recebendo na origem. Não mexa no DNS antes de copiar. A origem precisa continuar entregando e-mail durante todo o processo, porque é dela que você lê.

Inventário das caixas. Liste endereço, cota usada e cota máxima. Caixa com muitos gigabytes e dezenas de milhares de mensagens não copia em cinco minutos, e a cota no destino precisa ser igual ou maior, senão a cópia para no meio com erro de espaço.

A ordem de execução que evita retrabalho

Inventariar a conta antiga antes de criar qualquer coisa

Antes de criar qualquer coisa, tire print ou exporte as listas de contas de e-mail, encaminhadores, respondedores automáticos, filtros globais e filtros por conta, além do endereço padrão. Cinco minutos aqui economizam a semana seguinte.

Criar as caixas no destino sem liberar o cliente

Crie as contas com o mesmo endereço, a mesma senha e cota igual ou maior. Não avise o cliente ainda e não mande ninguém reconfigurar cliente de e-mail. Caixa nova com cliente conectado antes da cópia é a receita para mensagem duplicada, mensagem apagada por engano e, no pior caso, POP3 com "remover do servidor" ligado apontando para a origem.

Testar credencial e conexão antes de copiar de verdade

Com imapsync, o teste de credencial é isolado do resto:

imapsync \
  --host1 srv-origem.exemplo.com.br  --port1 993 --ssl1 \
  --user1 '[email protected]' --password1 'SENHA_ORIGEM' \
  --host2 srv-destino.exemplo.com.br --port2 993 --ssl2 \
  --user2 '[email protected]' --password2 'SENHA_DESTINO' \
  --justconnect

Os nomes de servidor e o endereço acima são exemplos fictícios. Trocando --justconnect por --justfoldersizes, a ferramenta lista as pastas dos dois lados com contagem de mensagens. Guarde essa saída: é a sua linha de base para a conferência.

Rodar em seco e conferir o mapeamento das pastas

--dry executa tudo sem gravar nada no destino. É onde você descobre que a pasta de enviados na origem se chama INBOX.Sent e no destino Enviados. A opção --automap tenta casar as pastas especiais entre servidores com nomenclaturas diferentes:

imapsync \
  --host1 srv-origem.exemplo.com.br  --port1 993 --ssl1 \
  --user1 '[email protected]' --password1 'SENHA_ORIGEM' \
  --host2 srv-destino.exemplo.com.br --port2 993 --ssl2 \
  --user2 '[email protected]' --password2 'SENHA_DESTINO' \
  --automap --dry

Confira o mapeamento na saída. Se alguma pasta ficou fora ou foi para o lugar errado, corrija o mapeamento antes de rodar sem --dry.

Repetir para todas as caixas, com laço ou pelo Thunderbird

Com mais de três ou quatro contas, monte um arquivo de credenciais e um laço. Exemplo:

# caixas.csv -> usuario;senha_origem;senha_destino
mkdir -p logs
while IFS=';' read -r usuario senha1 senha2; do
  echo "== $usuario"
  imapsync \
    --host1 srv-origem.exemplo.com.br  --port1 993 --ssl1 \
    --user1 "$usuario" --password1 "$senha1" \
    --host2 srv-destino.exemplo.com.br --port2 993 --ssl2 \
    --user2 "$usuario" --password2 "$senha2" \
    --automap </dev/null >> "logs/${usuario}.log" 2>&1
done < caixas.csv

O </dev/null evita que o comando consuma as linhas restantes do arquivo. Depois de terminar, chmod 600 não basta: apague o CSV de senhas.

Sem terminal disponível, o plano B é o Thunderbird com as duas contas configuradas como IMAP, arrastando pastas da origem para o destino. Não é equivalente à cópia por ferramenta dedicada: o arrasto pode reescrever a data interna de parte das mensagens, que aparecem no destino com a data da cópia, e perder flags como respondido e favorito. Além disso é mais lento e engasga em pastas muito grandes. Se for esse o caminho, copie em blocos, confira ao final de cada bloco e avise o cliente de que a ordenação por data pode sair alterada em algumas pastas.

Conferir pasta por pasta com a tabela preenchida

Detalhado na próxima seção. É o passo que ninguém pula duas vezes.

Virar o DNS e rodar a segunda passada no dia seguinte

Com a conferência fechada, mude o MX e os demais registros. Enquanto o DNS propaga, mensagens novas ainda chegam na origem. Rode o mesmo comando outra vez no dia seguinte: em execução repetida, a ferramenta copia só o que falta e não duplica o que já foi. Aí sim libere o cliente para reconfigurar os dispositivos.

Sequência da migração sem acesso rootInventariar origemContas, filtros, encaminhadores, respondedoresCriar caixas no destinoMesma senha, cota igual ou maiorTestar conexão e credencialjustconnect e justfoldersizesRodar em secodry e automap, conferir mapeamentoCopiar todas as caixasLaço com log por caixaVirar DNS, segunda passadaRepetir no dia seguinte
Ordem de execução da migração IMAP a IMAP. Sem número: cada caixa é um passo, não uma medição.

Como contar as mensagens e qual diferença é aceitável

Contagem de mensagens na origem contra contagem no destino, pasta a pasta, incluindo as que ninguém lembra. Preencha uma linha por pasta de cada caixa:

Pasta na origem Nome no destino Msgs origem Msgs destino Confere
INBOX INBOX
INBOX.Sent Enviados
INBOX.Drafts Rascunhos
INBOX.Trash Lixeira
INBOX.Junk Spam
INBOX.Clientes Clientes
INBOX.Clientes.2023 Clientes/2023

Três observações sobre a contagem.

Diferença pequena na Lixeira e no Spam é comum e aceitável, porque muitos servidores apagam automaticamente mensagens antigas dessas pastas enquanto você copia. Diferença em INBOX, Enviados ou em qualquer pasta de arquivo do cliente não é aceitável, e a causa costuma estar no log: mensagem recusada por tamanho, cabeçalho malformado, cota estourada no destino.

Subpasta de terceiro nível é onde o mapeamento quebra. Servidores que usam ponto como separador e servidores que usam barra produzem árvores diferentes. Se a hierarquia saiu achatada no destino, pare, apague a caixa no destino, recrie e rode de novo com o mapeamento correto. Corrigir depois, com o cliente já usando, é muito pior.

Pastas com acento e pastas compartilhadas merecem verificação manual no webmail do destino, não só na contagem.

Quatro erros que custam caro nessa migração

Criar as contas no destino e liberar o cliente antes de copiar. O usuário reconfigura o celular, o celular conecta na caixa vazia do servidor novo, e se o cliente de e-mail estiver em POP3 com remoção do servidor, ele pode apagar da origem o que você ainda não copiou. Crie as contas, copie, confira, e só então avise.

Copiar só a INBOX. É o erro mais comum de quem arrasta pastas na mão e cansa no meio. Enviados costuma ser a pasta mais valiosa do escritório, porque é onde estão as propostas mandadas. Lixeira também: gente usa a lixeira como arquivo morto, gostemos ou não.

Apagar o domínio adicional da conta antiga no mesmo dia. Trate a remoção do domínio adicional como operação destrutiva sobre as caixas daquele domínio: elas deixam de existir dentro da conta principal junto com o domínio, e não há garantia de que o diretório de correio permaneça acessível depois. Não confie na memória nem neste texto para decidir, confirme o comportamento no seu servidor antes de confirmar a remoção, lendo o aviso que o próprio painel exibe na tela de remoção do domínio adicional e checando o conteúdo do diretório de correio em uma conta de teste. A regra prática continua a mesma nos dois casos: tire um backup completo da conta antiga antes de remover qualquer coisa e deixe a conta antiga intacta por pelo menos duas semanas depois da virada, tempo suficiente para o cliente descobrir a pasta que faltou.

Esquecer filtros, encaminhadores e respostas automáticas. Recrie tudo no destino no mesmo dia da virada, usando o inventário do passo 1. Encaminhador esquecido é o pior dos três, porque ninguém reclama: a mensagem simplesmente para de chegar no endereço de destino e a falha só aparece quando alguém cobra uma resposta.

Um quinto, menos caro mas irritante: usar mail.dominio.com.br nos parâmetros de conexão. Durante a janela esse nome muda de dono, e você pode acabar copiando o servidor novo para dentro dele mesmo.

A frase pronta para explicar a janela ao cliente

A conversa difícil não é técnica, é de expectativa. O cliente acha que o e-mail "vai junto com o site" porque para ele é o mesmo domínio. Frase pronta, adapte os horários:

Duas coisas importam nessa frase. Ela explica a causa sem jargão, e ela transforma "não mexa" em uma instrução operacional com prazo. A caixa não fica tecnicamente em somente leitura no servidor, quem impõe isso é o combinado; se o cliente apagar cem mensagens durante a janela, elas voltam na sincronização seguinte e ele vai achar que o servidor novo está com defeito.

A janela explicada ao clienteQuinta à noiteCópia das caixas, cliente não mexeSextaConferência pasta a pasta, DNS alteradoSábadoSegunda passada, só o que faltaSegundaReconfiguração dos aparelhos
Janela combinada com o cliente, do jeito que a frase pronta descreve.

Checklist para reutilizar em todo desmembramento

O item que você mais vai querer pular é a tabela de conferência. É justamente o único que prova, para você e para o cliente, que nada ficou para trás antes de apagar a origem.

Referências

  1. Documentação oficial (cpanel) — How to Migrate the Contents of Email Accounts in Addon Domains. Consultado em 2026-09-20.
Leia também