~/conhecimento/migrando-de-zimbra-para-mailcow

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)

  1. Acesse o painel web do Mailcow como Administrador.
  2. Navegue até E-mail > Domínios.
  3. Edite os domínios desejados (ex: meudominio.com.br, outrodominio.com.br).
  4. Altere o campo Cota máxima do domínio (Quota) para 0 (infinito).
  5. 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.

  1. Transfira o arquivo update_hashes.sql gerado no Passo 2.2 para o servidor Mailcow.
  2. 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.

Precisa disso implementado na sua empresa?

Eu faço o trabalho para você, com segurança e documentação.

>_ SOLICITAR ORÇAMENTO