Como fazer backup e restaurar caixas de correio individuais no Zimbra CE

Para o Zimbra Open Source Edition (CE/FOSS), exporte a caixa de correio individual para zmmailboxum arquivo ZIP com metadados e, em seguida, importe esse arquivo para uma caixa de correio temporária e verifique-o antes de restaurar qualquer coisa na conta ativa. Isso fornece um caminho prático de exportação e recuperação de conteúdo por caixa de correio. Não é o mesmo que um backup pontual do servidor: o fluxo de trabalho integrado do Zimbra zmbackupé zmrestoredocumentado como funcionalidade da Network Edition, e a exportação de uma caixa de correio não faz backup do LDAP, da configuração do servidor, dos certificados ou da instalação completa do Zimbra.

Os comandos abaixo seguem a documentação de exportação via linha de comando e REST publicada pelo Zimbra. Execute-os em um servidor Zimbra como o zimbrausuário do sistema operacional, substitua os caminhos reais da sua caixa de correio e backup e teste com a mesma versão do Zimbra em uso. O guia de administração oficial distingue os conteúdos de arquivos ZIP e TGZ: para uma exportação completa da caixa de correio, use ZIP com a opção `--export` meta=1; o conteúdo padrão do TGZ omite calendários e tarefas.

O que este método comprova

zmmailboxA função chama as funções REST de exportação/importação do Zimbra para uma caixa de correio selecionada. Com os metadados ZIP ativados, o arquivo pode incluir e-mails, pastas, contatos, calendários, tarefas e outros itens da caixa de correio, conforme suportado pela versão instalada. Verifique a tabela de cobertura e as opções no Guia do Administrador do Zimbra correspondente antes de utilizá-la para fins de conformidade ou migração.

Se o seu objetivo é a recuperação completa do servidor em caso de desastre, combine a exportação de caixas de correio com um plano de backup completo do servidor e do LDAP, testado separadamente e compatível com a versão. Um arquivo ZIP sozinho não consegue reconstruir um servidor Zimbra.

Antes de começar

• Confirme a instalação e a versão com [comando/ferramenta] zmcontrol -v. Verifique se o servidor usa uma versão comunitária/FOSS ou uma versão licenciada da Network Edition antes de escolher suas ferramentas de backup.
• Identifique o endereço exato da caixa de correio e verifique seu tamanho. O gmscomando abaixo informa o tamanho da caixa de correio; reserve espaço suficiente para o arquivo morto e uma segunda cópia.
• Escolha um diretório de backup com permissões restritas. Prefira um sistema de arquivos ou host de backup separado para que uma falha de disco no servidor de e-mail não destrua ambas as cópias.
• Agende a exportação para um período de baixa atividade em caixas de correio grandes ou movimentadas. A opção de tempo limite (timeout) -t 0indica zmmailboxque o tempo limite normal do comando não deve ser aplicado; ela não torna a exportação atômica nem protege contra interrupções.
• Não armazene a única cópia de um arquivo não criptografado em um diretório de acesso amplo. Aplique criptografia no sistema de arquivos ou na camada de armazenamento de backup e restrinja quem pode ler o arquivo.

Exportar uma caixa de correio do Zimbra CE

1. Verifique o tamanho da compilação e da caixa de correio.

Abra um shell com privilégios de root ou utilize uma sessão administrativa aprovada e, em seguida, alterne para a zimbraconta. Confirme a versão e consulte a caixa de correio que pretende exportar. Por exemplo:

su - zimbra
zmcontrol -v
zmmailbox -z -m alice@example.com gms

Use o endereço real, como alice@example.com. Confirme se é a conta correta antes de prosseguir; o -margumento seleciona a caixa de correio que o comando irá ler ou modificar.

2. Prepare um destino restrito

Como usuário root, crie um diretório de backup pertencente à conta Zimbra e, em seguida, retorne ao shell do Zimbra. Ajuste o caminho de acordo com seu layout de armazenamento:

install -d -o zimbra -g zimbra -m 700 /srv/zimbra-mailbox-backups
su - zimbra
umask 077

O modo de diretório limita o acesso à conta Zimbra. Mantenha a cópia de segurança final em um sistema ou local de armazenamento protegido e separado, como parte do seu procedimento normal de backup. Não crie a única cópia de segurança dentro do repositório da caixa de correio ativa.

3. Exportar como ZIP com metadados

Execute a exportação da caixa de correio e redirecione a saída para um arquivo compactado com a data:

/opt/zimbra/bin/zmmailbox -z -m alice@example.com -t 0 gru "?fmt=zip&meta=1" > /srv/zimbra-mailbox-backups/alice-2026-10-07.zip

grué a abreviação documentada para getRestURL. A consulta entre aspas solicita o formato ZIP com metadados. A -t 0opção remove o tempo limite do comando, o que o Zimbra recomenda para exportações de caixas de correio grandes. Mantenha as aspas em torno da consulta para que o shell não interprete o e comercial como um operador em segundo plano.

Aguarde o comando retornar ao prompt e verifique o status de saída antes de mover o arquivo. Se a caixa de correio for muito grande, verifique o espaço livre e os logs do servidor em vez de presumir que um comando curto significa que a exportação foi concluída. Não permita que outro processo sobrescreva um backup com o mesmo nome.

4. Teste o arquivo e confirme o conteúdo.

Primeiro, verifique se a exportação existe e se possui um tamanho plausível e diferente de zero:

ls -lh /srv/zimbra-mailbox-backups/alice-2026-10-07.zip
unzip -t /srv/zimbra-mailbox-backups/alice-2026-10-07.zip

Um teste bem-sucedido unzip -tconfirma que o contêiner ZIP pode ser lido sem erros estruturais detectados. Isso não garante que todas as mensagens ou itens de calendário estejam presentes, portanto, inspecione também o arquivo em um teste de restauração. Registre um checksum se o seu processo de backup o utilizar; mantenha o checksum junto com a cópia que ele deve verificar.

5. Proteja e copie o arquivo.

Copie o arquivo para um destino de backup separado usando seu sistema de transferência ou backup seguro aprovado. Armazene-o com um identificador de caixa de correio legível, a versão do Zimbra e a data de exportação. Aplique criptografia em repouso e controles de acesso no destino de backup; não se deve presumir que o próprio arquivo ZIP exportado esteja criptografado. Mantenha mais de uma cópia de recuperação de acordo com sua política de retenção e teste periodicamente uma cópia do local fora do servidor, em vez de apenas o arquivo deixado no servidor de e-mail.

Restaure a caixa de correio com segurança.

6. Crie uma caixa de correio temporária para recuperação.

Antes de importar para uma caixa de correio de produção, crie uma conta temporária não utilizada em um servidor Zimbra de teste ou recuperação executando uma versão compatível. Use uma senha controlada e restrinja o acesso. Você pode criar a conta através do Console de Administração ou com seu processo de provisionamento normal. Uma caixa de correio de teste permite inspecionar o arquivo sem misturar seu conteúdo com a conta de produção.

Copie o arquivo para o servidor Zimbra e certifique-se de que o zimbrausuário possa lê-lo. A conta de destino deve existir antes de você fazer a chamada postRestURL.

7. Importe para a caixa de correio de recuperação.

Utilize postRestURLcom a conta de recuperação como destino e resolve=skippara um tratamento conservador de duplicados:

/opt/zimbra/bin/zmmailbox -z -m restore-check@example.com -t 0 postRestURL "?fmt=zip&resolve=skip" /srv/zimbra-mailbox-backups/alice-2026-10-07.zip

Aqui restore-check@example.comestá a conta temporária. O Zimbra documenta skipa opção padrão para conflitos: itens duplicados são ignorados. Em uma caixa de correio de teste vazia, isso fornece um primeiro teste de restauração simples. O comportamento de importação e os tipos de itens suportados podem variar entre as versões, portanto, consulte a documentação da versão de destino e verifique o resultado.

8. Verifique os dados restaurados antes da recuperação.

Abra a conta de teste no cliente web do Zimbra. Verifique uma amostra de mensagens recentes e antigas, nomes de pastas, contatos, entradas de calendário, tarefas e quaisquer outros dados relevantes para esta conta. Em seguida, liste suas pastas e a contagem de mensagens a partir da linha de comando (CLI):

/opt/zimbra/bin/zmmailbox -z -m restore-check@example.com gaf
/opt/zimbra/bin/zmmailbox -z -m restore-check@example.com gms

Compare o que você vê com a caixa de correio pretendida e a data de exportação. As contagens podem não corresponder exatamente se os usuários continuaram trabalhando após a exportação, se itens excluídos foram excluídos pelas configurações padrão de exportação ou se a versão de destino lida com alguns tipos de itens de forma diferente. O importante é verificar se o arquivo abre e se o conteúdo esperado está utilizável no cliente.

Importando para a caixa de correio original

Se precisar mesclar uma exportação de volta à caixa de correio existente, substitua o endereço de preparação no comando pelo endereço original da caixa de correio e mantenha-o resolve=skippara uma tentativa de mesclagem não destrutiva. Essa função foi projetada para ignorar itens duplicados e importar itens que ainda não estejam presentes; ela não reverte a caixa de correio para um ponto anterior no tempo nem remove conteúdo mais recente.

Não utilize este comando indiscriminadamente resolve=resetem resolve=replaceuma conta de produção. O Zimbra redefine os documentos excluindo o conteúdo da pasta de destino existente antes da importação; quando o destino é a raiz da caixa de correio, isso pode limpar a caixa de correio. A opção "Substituir" exclui e recria os itens correspondentes. Teste o comando exato em uma conta descartável primeiro e faça um backup completo antes de qualquer importação em produção. Se for necessário um rollback completo para um ponto específico no tempo, utilize o fluxo de trabalho de restauração da Network Edition licenciada ou um procedimento de recuperação em nível de servidor cuidadosamente planejado e adequado à sua configuração.

Problemas comuns e verificações de recuperação

• O arquivo de exportação está vazio ou inesperadamente pequeno: verifique o status de saída do comando, o espaço livre em disco, as permissões da caixa de correio e os logs da caixa de correio do Zimbra. Execute a exportação novamente com um novo nome de arquivo após resolver a causa.
• O arquivo falhou unzip -t: não o importe. Exporte-o novamente para um novo arquivo e verifique o espaço de armazenamento disponível e se houve alguma interrupção no shell, SSH ou transferência de backup.
• O calendário ou as tarefas estão faltando: verifique se a exportação usou ZIP meta=1. A tabela de formatos do Zimbra distingue o conteúdo ZIP do conteúdo TGZ padrão.
• Os relatórios de importação duplicam dados ou mantêm informações mais recentes: isso é esperado com a mesclagem do tipo "skip". Use uma conta de teste separada para inspecionar o arquivo e selecionar itens de recuperação específicos, em vez de redefinir a caixa de correio ativa.
• O comando expirou em uma caixa de correio grande: verifique se -t 0há alguma restrição e monitore o servidor até que o processo seja concluído. Evite encerrar uma exportação ou importação ativa sem antes avaliar seu estado.
• Você precisa de uma recuperação completa do servidor: a exportação da caixa de correio não inclui LDAP, provisionamento de domínio/conta, configuração do sistema, certificados ou uma cópia consistente de todo o repositório de mensagens. Siga um plano de backup completo do servidor, separado e testado.

Referências oficiais

• Documentação do produto Zimbra e guias de versão atuais
• Guia do Administrador do Zimbra Fonte: zmmailbox Formatos de exportação e metadados
• Centro Técnico do Zimbra: opções de exportação/importação e conflito de contas inteiras do zmmailbox
• Referência da API REST do Zimbra para formatos de arquivo e uso do zmmailbox.
• Centro Técnico Zimbra: disponibilidade da edição zmbackup
• Centro Técnico Zimbra: disponibilidade da edição zmrestore

Referências e documentação de lançamento verificadas em 7 de outubro de 2026. Como os formatos de arquivo e o comportamento da CLI podem mudar, verifique a documentação correspondente à sua versão do Zimbra instalada antes de executar uma restauração em uma caixa de correio de produção.