Migrando de Zimbra para Mailcow
publicado em 08/07/2026 às 08:14 atualizado em 20/11/2026 às 07:35
Documentação Oficial de Migração: Zimbra para Mailcow
Responsável Técnico: Luiz Henrique Marques Fagundes (Analista de Infraestrutura)
Ambiente de Origem: Zimbra Server (8.8.15)
Ambiente de Destino: Mailcow Dockerized
Diretório de Instalação (Mailcow): /srv/mailcow-dockerized
Estratégia Utilizada: Provisão via API (JSON Blindado com Identificação de Usuário e Aliases), Sincronização via Imapsync (Autenticação Administrativa/Temporária) e Injeção de Hashes via Banco de Dados.
1. Preparação do Ambiente
Antes de iniciar os scripts, é crucial preparar o servidor de destino para evitar bloqueios de provisionamento por limite de armazenamento imposto pela cota global dos domínios.
1.1. Liberação de Cota nos Domínios (Mailcow)
- Acesse o painel web do Mailcow como Administrador.
- Navegue até E-mail > Domínios.
- Edite os domínios desejados (ex:
meudominio.com.br,outrodominio.com.br). - Altere o campo Cota máxima do domínio (Quota) para 0 (infinito).
- Salve as alterações.
2. Fase 1: Extração e Provisionamento de Contas Principais
Esta fase extrai as contas do Zimbra (incluindo o hash de senha e o nome de exibição do usuário) e as provisiona no Mailcow através da API REST, gerando o arquivo SQL para a restauração futura das senhas originais.
2.1. Script de Extração Avançada no Zimbra (exportar_contas.sh)
Execute este script no servidor Zimbra logado como o usuário zimbra.
#!/bin/bash
DOMINIOS=("meudominio.com.br" "outrodominio.com.br")
ARQUIVO_SAIDA="/tmp/contas_zimbra_nomes.txt"
> "$ARQUIVO_SAIDA"
echo "Iniciando extração com Nomes Completos..."
for dominio in "${DOMINIOS[@]}"; do
echo "Processando domínio: $dominio..."
contas=$(zmprov -l gaa $dominio)
for conta in $contas; do
if [[ $conta == galsync* ]] || [[ $conta == spam.* ]] || [[ $conta == ham.* ]] || [[ $conta == virus-quarantine* ]]; then
continue
fi
hash=$(zmprov -l ga $conta userPassword | grep "userPassword: " | sed 's/userPassword: //')
nome=$(zmprov -l ga $conta displayName | grep "displayName: " | sed 's/displayName: //')
# Fallback: Se o usuário não tiver nome cadastrado no Zimbra, utiliza o local_part do e-mail
if [ -z "$nome" ]; then
nome="${conta%@*}"
fi
if [ ! -z "$hash" ]; then
echo "$conta:$hash:$nome" >> "$ARQUIVO_SAIDA"
fi
done
done
echo "Extração concluída! Verifique o arquivo $ARQUIVO_SAIDA"
2.2. Script de Provisionamento via API (importar_mailcow.sh)
Com o arquivo contas_zimbra_nomes.txt em mãos, execute este script para enviar as contas ao Mailcow (requer o pacote jq instalado).
#!/bin/bash
ARQUIVO_CONTAS="contas_zimbra_nomes.txt"
API_KEY="SUA_CHAVE_DE_API_AQUI"
URL_API="https://mailcow.meudominio.com.br/api/v1/add/mailbox"
SENHA_TEMP="MinhaSenhaAqui@123"
ARQUIVO_SQL="update_hashes.sql"
> "$ARQUIVO_SQL"
echo "Iniciando Provisionamento com Nomes Reais..."
while IFS=':' read -r raw_email raw_hash raw_name; do
email=$(echo "$raw_email" | tr -d '[:space:]')
hash=$(echo "$raw_hash" | tr -d '[:space:]')
# Preservação de espaços no nome e sobrenome, removendo apenas quebras de linha
nome=$(echo "$raw_name" | tr -d '\r\n')
if [ -z "$email" ] || [ -z "$hash" ]; then continue; fi
nome_usuario="${email%@*}"
dominio="${email#*@}"
echo "Criando caixa: $email -> Nome: $nome"
jq -n \
--arg lp "$nome_usuario" \
--arg dm "$dominio" \
--arg pw "$SENHA_TEMP" \
--arg pw2 "$SENHA_TEMP" \
--arg nm "$nome" \
'{
local_part: $lp,
domain: $dm,
password: $pw,
password2: $pw2,
name: $nm,
active: 1,
quota: 10240,
force_pw_update: 0,
tls_enforce_in: 0,
tls_enforce_out: 0
}' > /tmp/payload_mailcow.json
curl -s -X POST "$URL_API" \
-H "X-API-Key: $API_KEY" \
-H "Content-Type: application/json" \
-d @/tmp/payload_mailcow.json
echo -e "\n"
# Preparação da query para a fase de Cutover
echo "UPDATE mailbox SET password = '${hash}' WHERE username = '${email}';" >> "$ARQUIVO_SQL"
done < "$ARQUIVO_CONTAS"
echo "Provisionamento concluído! Arquivo $ARQUIVO_SQL gerado."
3. Fase 2: Migração de Aliases (Apelidos)
Para garantir o roteamento correto de mensagens institucionais (ex: contato@, diretoria@), os aliases são extraídos do servidor legado e mapeados no Mailcow.
3.1. Script de Extração de Aliases no Zimbra (exportar_aliases.sh)
Execute no servidor Zimbra para gerar o arquivo de mapeamento.
#!/bin/bash
DOMINIOS=("meudominio.com.br" "outrodominio.com.br")
ARQUIVO_SAIDA="/tmp/aliases_zimbra.txt"
> "$ARQUIVO_SAIDA"
echo "Iniciando varredura de Aliases..."
for dominio in "${DOMINIOS[@]}"; do
echo "Pesquisando no domínio: $dominio..."
contas=$(zmprov -l gaa $dominio)
for conta in $contas; do
if [[ $conta == galsync* ]] || [[ $conta == spam.* ]] || [[ $conta == ham.* ]] || [[ $conta == virus-quarantine* ]]; then
continue
fi
aliases=$(zmprov -l ga $conta zimbraMailAlias | grep "zimbraMailAlias: " | sed 's/zimbraMailAlias: //')
if [ ! -z "$aliases" ]; then
for alias in $aliases; do
echo "$alias:$conta" >> "$ARQUIVO_SAIDA"
done
fi
done
done
echo "Extração de Aliases concluída! Verifique o arquivo $ARQUIVO_SAIDA"
3.2. Script de Provisionamento de Aliases (importar_aliases.sh)
Com o arquivo aliases_zimbra.txt em mãos, execute este script para injetar as rotas via API no Mailcow.
#!/bin/bash
ARQUIVO_ALIAS="aliases_zimbra.txt"
API_KEY="SUA_CHAVE_DE_API_AQUI"
URL_API="https://mailcow.meudominio.com.br/api/v1/add/alias"
echo "Iniciando criação de Aliases no Mailcow..."
while IFS=':' read -r raw_alias raw_destino; do
alias=$(echo "$raw_alias" | tr -d '[:space:]')
destino=$(echo "$raw_destino" | tr -d '[:space:]')
if [ -z "$alias" ] || [ -z "$destino" ]; then continue; fi
echo "Criando Alias na API: $alias -> redirecionando para -> $destino"
jq -n \
--arg address "$alias" \
--arg goto "$destino" \
'{
address: $address,
goto: $goto,
active: 1
}' > /tmp/payload_alias.json
curl -s -X POST "$URL_API" \
-H "X-API-Key: $API_KEY" \
-H "Content-Type: application/json" \
-d @/tmp/payload_alias.json
echo -e "\n"
done < "$ARQUIVO_ALIAS"
echo "Migração de Aliases finalizada com sucesso!"
4. Fase 3: Migração de Dados (Imapsync)
Para viabilizar a transferência das mensagens sem o conhecimento prévio das senhas dos usuários, padroniza-se temporariamente o acesso no destino e utiliza-se a credencial administrativa na origem.
4.1. Padronização Temporária de Senhas no Mailcow
No servidor Mailcow, execute o bloco abaixo para forçar a senha temporária em todas as contas ativas, permitindo o login em massa do imapsync.
cd /srv/mailcow-dockerized
source mailcow.conf
# Gera um hash seguro padrão Dovecot
HASH=$(docker compose exec -T dovecot-mailcow doveadm pw -s SHA512-CRYPT -p 'MinhaSenhaAqui@123')
# Aplica o hash no banco de dados
docker compose exec -T mysql-mailcow mysql -u $DBUSER -p$DBPASS $DBNAME -e "UPDATE mailbox SET password = '${HASH}' WHERE active=1;"
4.2. Script de Sincronização (imapsync.sh)
Execute este script em um servidor com Docker instalado (recomendado rodar a partir da origem utilizando os IPs diretos para evitar bloqueios DNS).
#!/bin/bash
ARQUIVO_CONTAS="contas_zimbra_nomes.txt"
# Variáveis - Servidor Origem (Zimbra)
HOST_ZIMBRA="zimbra.meudominio.com.br" # Pode ser o IP
ADMIN_ZIMBRA="[email protected]"
SENHA_ADMIN_ZIMBRA="MinhaSenhaAqui@123"
# Variáveis - Servidor Destino (Mailcow)
HOST_MAILCOW="mailcow.meudominio.com.br" # Pode ser o IP
SENHA_TEMP_MAILCOW="MinhaSenhaAqui@123"
echo "Iniciando sincronização via Imapsync (Docker)..."
while IFS=':' read -r raw_email trash trash2; do
email=$(echo "$raw_email" | tr -d '[:space:]')
if [ -z "$email" ]; then continue; fi
echo "================================================="
echo "Sincronizando: $email"
echo "================================================="
docker run --rm gilleslamiral/imapsync imapsync \
--host1 "$HOST_ZIMBRA" \
--user1 "$email" \
--authuser1 "$ADMIN_ZIMBRA" \
--password1 "$SENHA_ADMIN_ZIMBRA" \
--host2 "$HOST_MAILCOW" \
--user2 "$email" \
--password2 "$SENHA_TEMP_MAILCOW" \
--ssl1 --ssl2 \
--noauthmd5 \
--exclude "Junk|Spam"
echo -e "\n"
done < "$ARQUIVO_CONTAS"
echo "Sincronização concluída!"
5. Fase 4: Cutover e Restauração Transparente de Senhas
Para finalizar a migração sem gerar atrito com os usuários, as senhas originais (em formato de hash) extraídas do Zimbra são devolvidas ao banco de dados do Mailcow.
- Transfira o arquivo
update_hashes.sqlgerado no Passo 2.2 para o servidor Mailcow. - No servidor Mailcow, injete os hashes diretamente no contêiner do banco de dados:
cd /srv/mailcow-dockerized
source mailcow.conf
cat /caminho/do/seu/update_hashes.sql | docker compose exec -T mysql-mailcow mysql -u $DBUSER -p$DBPASS $DBNAME
Validação Final da Migração
- Realize a virada de apontamentos de DNS (MX, entradas TXT de SPF, DKIM e DMARC) no provedor.
- Valide o roteamento dos Aliases enviando e-mails de teste para os apelidos corporativos.
- Acesse o Webmail (SOGo) utilizando as credenciais originais para confirmar o acesso à caixa restaurada e a exibição correta dos Nomes na Global Address List.