Passo a passo para migrar email do cPanel

17 min de leitura  ·  Guia técnico

Passo a passo para migrar email do cPanel: reduza o TTL do MX, recrie as contas no servidor de destino, sincronize as caixas por IMAP com imapsync, altere o MX e faça uma sincronização final antes de desligar o servidor antigo. Assim, você preserva mensagens, pastas e flags sem downtime e com risco mínimo de perda.

1. Reduza o TTL do registro MX para 300 segundos com 24 horas de antecedência.
2. Crie as contas de email no servidor de destino com as mesmas credenciais.
3. Sincronize as mensagens com imapsync enquanto o servidor antigo ainda está ativo.
4. Atualize o registro MX para apontar para o novo servidor.
5. Execute uma sincronização final com imapsync para capturar emails recebidos durante a propagação.
6. Confirme a propagação e desative o servidor antigo somente após validar o recebimento no novo.

Pré-requisitos para migrar email corporativo do cPanel

• Acesso root via SSH no servidor de origem e no servidor de destino (ou acesso WHM em ambos) se você for usar o Transfer Tool do WHM ou instalar o imapsync diretamente no servidor.
• cPanel/WHM instalado e funcional nos dois servidores — a versão mínima recomendada é cPanel 110 ou superior.
• imapsync instalado no servidor de destino (ou em uma máquina intermediária com acesso IMAP a ambos os servidores).
• Lista completa de contas de email com usuário e senha de cada conta de origem e destino.
• Acesso ao painel de controle do DNS do domínio para alterar os registros MX.
• TTL atual dos registros MX — anote o valor antes de qualquer alteração.
• Janela de manutenção planejada (recomendado: madrugada ou fim de semana com baixo volume de emails).

Se você ainda não tem familiaridade com acesso SSH ao servidor, consulte o guia Acessando servidores VPS Linux da AviraHost antes de prosseguir.

Etapa 1: Reduzir o TTL do registro MX antes da migração de email

Diminuir o TTL (Time to Live) do registro MX é o primeiro passo crítico para garantir que a propagação de DNS ocorra rapidamente no momento da virada. Com um TTL alto (como 86400 segundos, equivalente a 24 horas), os resolvedores de DNS ao redor do mundo continuarão enviando emails para o servidor antigo por até um dia após a troca.

Acesse o painel de gerenciamento do DNS do seu domínio e localize o registro MX. Altere o TTL para 300 segundos (5 minutos). Faça isso com pelo menos 24 horas de antecedência para que os caches existentes expirem antes da migração.

Para verificar o TTL atual do seu registro MX via linha de comando, execute:

dig MX seudominio.com.br +noall +answer

seudominio.com.br.  300  IN  MX  10  mail.seudominio.com.br.

O número 300 na saída confirma que o TTL já foi reduzido com sucesso. Anote o valor do servidor de email atual (campo mail.seudominio.com.br) — você precisará dele para configurar o imapsync.

Para gerenciar registros DNS de forma detalhada, veja o artigo Como Configurar DNS Personalizado para Seu Domínio na AviraHost.

Etapa 2: Criar contas de email no servidor de destino via cPanel

Antes de sincronizar as mensagens, todas as contas de email precisam existir no servidor de destino. A forma mais eficiente de recriar contas em lote é usando o Transfer Tool do WHM, que copia contas cPanel inteiras incluindo emails, configurações de filtros e autoresponders.

Usando o Transfer Tool do WHM para migrar contas cPanel

No servidor de destino, acesse o WHM e navegue até Transfers > Transfer Tool. Preencha os dados do servidor de origem:

• Remote Server Address: IP ou hostname do servidor antigo.
• Root Password ou SSH Key: credenciais de acesso root do servidor de origem.
• Transfer Method: selecione Copy para manter o servidor antigo intacto.

Clique em Fetch Account List, selecione as contas desejadas e inicie a transferência. O WHM copiará os arquivos de email (armazenados em /home/usuario/mail/) e recriará as contas automaticamente.

Atenção: o Transfer Tool copia o estado das mensagens no momento da execução. Emails recebidos após essa cópia precisarão ser sincronizados novamente com o imapsync na etapa seguinte.

Criando contas manualmente no cPanel de destino

Se preferir criar as contas manualmente, acesse o cPanel do domínio no servidor de destino, vá em Email > Email Accounts e crie cada conta com o mesmo nome de usuário e uma senha temporária. Anote as senhas — você precisará delas para o imapsync.

Etapa 3: Instalar e executar o imapsync para sincronizar mensagens

O imapsync é a ferramenta mais confiável para sincronizar caixas de entrada IMAP entre servidores, preservando pastas, flags de leitura e metadados das mensagens. Ele funciona com qualquer servidor que implemente o protocolo IMAP, incluindo o Dovecot usado pelo cPanel.

Instalando o imapsync no servidor de destino

Conecte-se ao servidor de destino via SSH como root e instale as dependências:

apt-get update && apt-get install -y \
  libauthen-ntlm-perl \
  libcrypt-ssleay-perl \
  libdigest-hmac-perl \
  libfile-copy-recursive-perl \
  libio-compress-perl \
  libio-socket-inet6-perl \
  libio-socket-ssl-perl \
  libio-tee-perl \
  libmodule-scandeps-perl \
  libnet-ssleay-perl \
  libpar-packer-perl \
  libterm-readkey-perl \
  libunicode-string-perl \
  liburi-perl \
  libmail-imapclient-perl \
  make cpanminus

Em seguida, instale o imapsync via CPAN:

cpanm Mail::IMAPClient
wget -O /usr/local/bin/imapsync https://raw.githubusercontent.com/imapsync/imapsync/master/imapsync
chmod +x /usr/local/bin/imapsync

Verifique a instalação:

imapsync --version

imapsync 2.229

Executando a sincronização IMAP entre os servidores cPanel

Com o imapsync instalado, execute o comando de sincronização para cada conta de email. Substitua os valores pelos dados reais do seu ambiente:

imapsync \
  --host1 mail.servidorantigo.com.br \
  --user1 [email protected] \
  --password1 "SenhaOrigem123" \
  --ssl1 \
  --host2 mail.servidornovo.com.br \
  --user2 [email protected] \
  --password2 "SenhaDestino456" \
  --ssl2 \
  --automap \
  --skipcrossduplicates \
  --useuid

Explicação dos parâmetros principais:

• --ssl1 / --ssl2: força conexão TLS na porta 993 (IMAPS) em ambos os servidores.
• --automap: mapeia automaticamente pastas com nomes diferentes (ex: Sent para Enviados).
• --skipcrossduplicates: evita copiar mensagens já existentes no destino.
• --useuid: usa o UID IMAP para identificar mensagens de forma única, evitando duplicatas.

Ao rodar este comando, você verá uma saída progressiva indicando quantas mensagens foram copiadas por pasta:

Host1: Found 1 folder: INBOX
Host2: Found 1 folder: INBOX
Folder [INBOX]: 342 messages on host1, 0 on host2
Copying 342 messages from INBOX
...
Transfer completed in 47 seconds. 342 messages transferred.

Automatizando a sincronização contínua com cron

Para capturar emails recebidos durante a janela de migração, configure uma tarefa cron que execute o imapsync a cada 15 minutos:

crontab -e

*/15 * * * * /usr/local/bin/imapsync \
  --host1 mail.servidorantigo.com.br \
  --user1 [email protected] \
  --password1 "SenhaOrigem123" \
  --ssl1 \
  --host2 mail.servidornovo.com.br \
  --user2 [email protected] \
  --password2 "SenhaDestino456" \
  --ssl2 \
  --automap --skipcrossduplicates --useuid \
  >> /var/log/imapsync_usuario.log 2>&1

Como o IMAP é incremental, execuções subsequentes copiam apenas mensagens novas ou alteradas, tornando o processo eficiente mesmo com caixas grandes.

Etapa 4: Atualizar o registro MX e executar sincronização final

Com as mensagens sincronizadas e o servidor de destino validado, chegou o momento de redirecionar o fluxo de emails. Esta etapa exige atenção para minimizar o risco de perda de mensagens durante a propagação de DNS.

Atenção: não desative o servidor antigo antes de confirmar que o DNS MX já propagou para o novo servidor. Emails enviados durante a propagação ainda podem chegar ao servidor antigo.

1. Acesse o painel de DNS do seu domínio.
2. Altere o registro MX para apontar para o hostname do novo servidor (ex: mail.servidornovo.com.br).
3. Mantenha o TTL em 300 segundos.
4. Aguarde de 5 a 30 minutos e verifique a propagação com:

dig MX seudominio.com.br @8.8.8.8 +short

10 mail.servidornovo.com.br.

Quando a saída mostrar o novo servidor, execute uma última sincronização manual com o imapsync para capturar qualquer email recebido no servidor antigo durante a propagação:

imapsync \
  --host1 mail.servidorantigo.com.br \
  --user1 [email protected] \
  --password1 "SenhaOrigem123" \
  --ssl1 \
  --host2 mail.servidornovo.com.br \
  --user2 [email protected] \
  --password2 "SenhaDestino456" \
  --ssl2 \
  --automap --skipcrossduplicates --useuid

Etapa 5: Validar o funcionamento do email no novo servidor cPanel

Após a virada de DNS, valide cada aspecto do serviço de email antes de encerrar a migração. Testes superficiais podem deixar passar problemas que só aparecem dias depois.

• Envio e recebimento: envie um email de uma conta externa (Gmail, Outlook) para o domínio migrado e verifique se ele chega na caixa do novo servidor.
• Autenticação SMTP: configure um cliente de email (Thunderbird, Outlook) com as configurações do novo servidor e teste o envio.
• Registros SPF, DKIM e DMARC: verifique se os registros de autenticação de email foram recriados no DNS do novo servidor. No cPanel, acesse Email > Email Deliverability para checar e corrigir automaticamente.
• Webmail: acesse o Roundcube ou Horde via https://seudominio.com.br/webmail e confirme que as pastas e mensagens antigas estão presentes.
• Filtros e autoresponders: verifique se regras de filtro e respostas automáticas foram migradas corretamente.

dig TXT seudominio.com.br +short | grep spf

"v=spf1 include:servidornovo.com.br ~all"

Se o registro SPF ainda apontar para o servidor antigo, atualize-o no painel de DNS imediatamente para evitar que emails enviados pelo novo servidor sejam marcados como spam.

Problemas comuns e como resolver

Sintoma: imapsync retorna erro "Login failed" ou "Authentication failed"

Causa: credenciais incorretas, conta bloqueada por tentativas falhas ou o servidor bloqueando conexões externas na porta IMAP.
Solução: verifique as credenciais acessando o webmail do servidor de origem diretamente. Confirme que a porta 993 (IMAPS) está aberta no firewall do servidor de origem com telnet mail.servidorantigo.com.br 993. Se o cPanel tiver proteção contra força bruta (cPHulk), adicione o IP do servidor de destino na whitelist em WHM > Security Center > cPHulk Brute Force Protection.

Sintoma: Emails duplicados na caixa de destino após a migração

Causa: o imapsync foi executado sem os parâmetros --skipcrossduplicates e --useuid, ou o servidor de destino não suporta UIDs IMAP persistentes.
Solução: execute o imapsync com a flag --delete2duplicates para remover duplicatas no destino. Antes de executar, faça um backup da caixa de destino. Adicione também --useuid --usecache para que o imapsync mantenha um cache local de mensagens já sincronizadas.

imapsync \
  --host1 mail.servidorantigo.com.br --user1 [email protected] --password1 "Senha" --ssl1 \
  --host2 mail.servidornovo.com.br --user2 [email protected] --password2 "Senha" --ssl2 \
  --delete2duplicates --useuid --usecache

Sintoma: Emails enviados pelo novo servidor caem em spam

Causa: registros SPF, DKIM ou DMARC não foram atualizados para refletir o novo servidor, ou o IP do novo servidor tem reputação baixa.
Solução: no cPanel do novo servidor, acesse Email > Email Deliverability e clique em Repair para cada domínio. Isso recria automaticamente os registros DKIM e corrige o SPF. Verifique também se o IP do novo servidor não está em listas negras usando ferramentas como MXToolbox. Se o IP estiver listado, solicite remoção diretamente nas listas identificadas.

Sintoma: Pastas personalizadas não aparecem no servidor de destino

Causa: o mapeamento de pastas entre os dois servidores é incompatível, especialmente quando um usa o separador / e o outro usa . para subpastas IMAP.
Solução: adicione o parâmetro --sep1 "/" e --sep2 "." (ou vice-versa) ao comando imapsync para forçar a conversão correta do separador de pastas. Use também --f1f2 "Pasta Origem=Pasta Destino" para mapear pastas com nomes diferentes manualmente.

Perguntas frequentes sobre migração de email corporativo do cPanel

É possível migrar email do cPanel sem perder mensagens antigas?

Sim. Usando o protocolo IMAP com ferramentas como imapsync ou o próprio Transfer Tool do WHM, todas as mensagens, pastas e flags são copiadas para o novo servidor antes de qualquer corte de DNS. O segredo é sincronizar enquanto o servidor antigo ainda está ativo e repetir a sincronização final minutos antes da virada, garantindo que nenhuma mensagem recebida durante o processo seja perdida.

Quanto tempo leva a propagação de DNS após migrar o email?

A propagação de DNS pode levar de alguns minutos até 48 horas, dependendo do TTL configurado no registro MX antes da migração. Para reduzir esse tempo, reduza o TTL para 300 segundos (5 minutos) pelo menos 24 horas antes da migração. Assim, a maioria dos resolvedores atualizará o registro em poucos minutos após a troca, minimizando o período de incerteza.

O imapsync funciona com cPanel e Dovecot?

Sim. O imapsync se conecta via IMAP padrão (porta 993 com TLS ou porta 143 com STARTTLS) e é compatível com qualquer servidor que implemente o protocolo, incluindo o Dovecot usado pelo cPanel. Você precisa das credenciais de cada conta de email de origem e destino para executar a sincronização. Se o imapsync já estiver instalado em uma máquina intermediária ou no servidor de destino, a execução da sincronização em si não exige acesso root ao servidor de email.

Como evitar que emails novos se percam durante a migração?

Execute o imapsync em modo de sincronização contínua ou repita o comando várias vezes durante a janela de migração. Como o IMAP é incremental, apenas mensagens novas ou alteradas são copiadas nas execuções subsequentes. Mantenha o servidor antigo ativo e recebendo emails até confirmar que o DNS MX já propagou para o novo servidor, e então execute uma sincronização final para capturar os últimos emails.

Preciso de acesso root para migrar email no cPanel?

Para usar o Transfer Tool do WHM ou instalar o imapsync no servidor, é necessário acesso root via SSH. Se você não tem acesso root, ainda pode migrar usando um cliente IMAP como Thunderbird para arrastar e soltar mensagens entre contas, usar o imapsync em uma máquina intermediária já preparada ou solicitar ao suporte da hospedagem que execute a migração via WHM. Para acessar seu servidor via SSH, consulte o guia Acessando servidores VPS Linux da AviraHost.

Conclusão

Migrar email corporativo do cPanel sem perder mensagens é totalmente viável quando o processo é executado na ordem correta e com as ferramentas certas. Os pontos mais importantes para garantir o sucesso da migração são:

• Reduza o TTL do registro MX com antecedência: fazer isso 24 horas antes da migração é o que permite uma virada de DNS rápida e controlada, reduzindo o período de incerteza para minutos em vez de horas.
• Use o imapsync com sincronizações incrementais repetidas: executar o imapsync múltiplas vezes durante a janela de migração garante que nenhuma mensagem recebida no servidor antigo seja perdida, aproveitando a natureza incremental do protocolo IMAP.
• Valide SPF, DKIM e DMARC antes de encerrar: registros de autenticação de email incorretos são a causa mais comum de emails caindo em spam após uma migração — verifique e corrija via Email Deliverability do cPanel antes de considerar a migração concluída.

Leia também

• Passo a passo para configurar email profissional com domínio próprio no cPanel
• Guia Completo para Configurar E-mails Profissionais no cPanel
• Solucionar erro de conexão FTP no cPanel: passo a passo definitivo

Precisa de ajuda com migração de email corporativo?

Migrar email corporativo envolve múltiplas etapas críticas que, se executadas fora de ordem, podem resultar em perda de mensagens ou interrupção do serviço. A equipe da AviraHost oferece planos de hospedagem com suporte técnico especializado em cPanel, podendo auxiliar na configuração e validação de todo o processo de migração.

Conheça os planos de hospedagem com cPanel da AviraHost