Sichern und Wiederherstellen eines Zimbra CE-Postfachs mithilfe von TGZ-Exporten

Um ein Zimbra Community Edition (CE)-Postfach zu sichern, exportieren Sie es als TGZ-Datei zmmailbox getRestURL, überprüfen Sie das Archiv und stellen Sie es wieder her postRestURL. Beim Import in ein Konto, das bereits E-Mails enthält, beginnen Sie mit resolve=skip; ​​die Verwendung resolve=resetvon im Stammverzeichnis des Postfachs kann vorhandene Elemente löschen.

Verstehen, was ein Export pro Postfach schützt

Zimbra dokumentiert den Export und Import von TGZ-Dateien über seine REST-Schnittstelle und zmmailboxsein Hilfsprogramm. Das Archiv enthält Postfachinhalte und Ordnerstruktur, einschließlich E-Mails im EML-Format sowie zugehörige Kalender-, Kontakt-, Aufgaben- oder Briefcase-Daten. Welche Inhalte und Metadaten beim Import erhalten bleiben, hängt von den Quell- und Zielversionen sowie den zu übertragenden Elementen ab.

Verwechseln Sie dies nicht mit einer vollständigen Konto- oder Serversicherung. Ein TGZ-Inhaltsexport stellt kein fehlendes Konto wieder her und speichert auch nicht automatisch alle LDAP-Attribute, Passwörter, Aliase, Dienstklassenzuweisungen, Routing-Einstellungen, Filter, Berechtigungen oder Serverkonfigurationen. Dokumentieren Sie alle benötigten Kontoeinstellungen separat mithilfe administrativer Verfahren. Das zmbackupin der älteren Zimbra-Dokumentation beschriebene Dienstprogramm gehört zur Network Edition, nicht zum Standard-CE-Workflow.

Die Befehlsbeispiele orientieren sich an den dokumentierten Schnittstellen von Zimbra, stellen aber keinen Live-Test für jede unabhängig erstellte CE-Version dar. Prüfen Sie zmcontrol -vdie verfügbare zmmailboxHilfe und die Versionshinweise Ihres Builds, bevor Sie eine Produktionswiederherstellung planen. Ein Live-REST-Export erfasst zudem nicht zwangsläufig einen perfekt konsistenten Moment, wenn der Benutzer während der Ausführung Änderungen vornimmt. Planen Sie ein Zeitfenster mit geringer Aktivität ein, wenn Konsistenz wichtig ist.

Exportieren Sie die einzelne Mailbox

1. Identifizieren Sie das Konto und seinen Mail-Host.

Stellen Sie mit einem Betriebssystemkonto mit Administratorrechten eine Verbindung zum Zimbra-Server her. Wechseln Sie zum Zimbra-Dienstbenutzer und überprüfen Sie, ob das Zielkonto existiert. Stellen Sie in einer Umgebung mit mehreren Servern sicher, dass Sie die Verbindung zum richtigen Postfachdienst herstellen.

sudo -iu zimbra
zmcontrol -v
zmprov ga user@example.com zimbraMailHost zimbraAccountStatus
zmmailbox -z -m user@example.com getAllFolders

Ersetzen Sie dies user@example.comdurch das tatsächliche Benutzerkonto. Der -zSchalter verwendet die lokalen Administratoranmeldeinformationen von Zimbra; es handelt sich nicht um das Passwort des Endbenutzers. Falls Ihnen die erforderlichen Administratorrechte fehlen, verwenden Sie einen genehmigten Workflow für den Kontozugriff, anstatt Passwörter in einen Shell-Befehl einzubetten.

2. Erstellen Sie einen privaten Archivspeicherort

Erstellen Sie als privilegierter Betriebssystembenutzer ein Verzeichnis, in das der Zimbra-Dienstbenutzer schreiben kann. Führen Sie dies außerhalb öffentlich zugänglicher Verzeichnisse durch und prüfen Sie vorher den verfügbaren Speicherplatz. Führen Sie den Installationsbefehl aus, bevor Sie wechseln zimbra, oder kehren Sie zu Ihrem privilegierten Benutzerkonto zurück.

sudo install -d -o zimbra -g zimbra -m 0700 /srv/zimbra-mailbox-backups
df -h /srv/zimbra-mailbox-backups
ls -ld /srv/zimbra-mailbox-backups

E-Mail-Archive können vertrauliche Nachrichten und Anhänge enthalten. Beschränken Sie den Dateisystemzugriff, schützen Sie alle externen Kopien und wenden Sie eine angemessene Aufbewahrungsrichtlinie an.

3. Exportieren Sie das Postfach als TGZ-Datei.

Verwenden Sie in der zimbraShell den unten stehenden REST-Exporter. Die -t 0Option deaktiviert das CLI-Timeout für große Operationen; es wird jedoch nicht garantiert, dass Proxys, Festplatten-E/A oder Serverbeschränkungen den Export nicht unterbrechen.

umask 077
zmmailbox -z -m user@example.com -t 0 getRestURL '//?fmt=tgz' > /srv/zimbra-mailbox-backups/user-20261010.tgz

Führen Sie pro Konto einen Export durch und wählen Sie einen datierten, eindeutigen Dateinamen. Verwenden Sie keinen vorherigen Archivpfad wieder, da dieser durch die Shell-Umleitung abgeschnitten wird. Falls der Befehl einen Fehler meldet, behandeln Sie die resultierende Datei als unvollständig, bis sie die folgenden Prüfungen besteht.

4. Archiv validieren und Prüfsumme protokollieren

Eine nicht leere TGZ-Datei ist kein Beweis für ein wiederherstellbares Backup. Testen Sie den gesamten TAR-Stream, prüfen Sie repräsentative Ordner-Einträge und berechnen Sie einen Hashwert. Ein fehlgeschlagener TAR-Check bedeutet, dass Sie den Export und nicht den Import der Datei untersuchen sollten.

test -s /srv/zimbra-mailbox-backups/user-20261010.tgz
tar -tzf /srv/zimbra-mailbox-backups/user-20261010.tgz > /dev/null
tar -tzf /srv/zimbra-mailbox-backups/user-20261010.tgz | head -n 20
cd /srv/zimbra-mailbox-backups
sha256sum user-20261010.tgz > user-20261010.tgz.sha256

Speichern Sie die Prüfsumme neben dem Archiv und verschieben Sie beides auf einen geschützten Speicher außerhalb des ursprünglichen Servers. Führen Sie nach dem Kopieren sha256sum -c user-20261010.tgz.sha256den Befehl im Verzeichnis mit den beiden Dateien aus. Eine erfolgreiche Prüfsumme bestätigt die Byte-Integrität, jedoch nicht die korrekte Wiederherstellung aller Mailbox-Funktionen.

Das Archiv wiederherstellen, ohne die Live-E-Mails zu überschreiben.

5. Bereiten Sie das Ziel-Postfach vor und überprüfen Sie es.

Erstellen Sie das Zielkonto über Ihren üblichen, genehmigten Zimbra-Bereitstellungsprozess, falls es noch nicht existiert; der TGZ-Import erstellt es nicht. Überprüfen Sie Adresse, Kontingent, Dienstzugriff und vorhandene Ordner. Verwenden Sie für den ersten Test ein isoliertes Nicht-Produktionskonto, insbesondere für versionsübergreifende Übertragungen.

sudo -iu zimbra
zmprov ga user@example.com zimbraMailHost zimbraAccountStatus
zmmailbox -z -m user@example.com getAllFolders

Kopieren Sie das validierte Archiv in ein Verzeichnis, das für den Zimbra-Dienstbenutzer lesbar ist, wobei die eingeschränkten Berechtigungen beibehalten werden. Überprüfen Sie bei einer Remote-Übertragung die Prüfsumme am Zielort erneut. Gehen Sie nicht davon aus, dass ein Konto mit derselben Adresse leer ist.

6. Importieren Sie mit einer Konfliktrichtlinie, die zum Zielland passt.

Um fehlende Elemente hinzuzufügen und gleichzeitig übereinstimmende Elemente beizubehalten, verwenden Sie resolve=skip. Dies ist das dokumentierte Standardverhalten für die Duplikatsbehandlung, garantiert jedoch keine perfekte Zusammenführung für jeden Elementtyp oder jede Version.

zmmailbox -z -m user@example.com -t 0 postRestURL '//?fmt=tgz&resolve=skip' /srv/zimbra-mailbox-backups/user-20261010.tgz

Vermeiden Sie es, ein destruktives Beispiel in die Produktionsumgebung zu kopieren. Zimbra-Dokumente resolve=resetsollten vor dem Import als Zielobjekte gelöscht werden. Die replaceRichtlinien modifyändern auch die Handhabung bestehender Elemente. Ziehen Sie sie für eine kontrollierte Wiederherstellung nur in Betracht, nachdem Sie diese getestet und die Genehmigung für den genauen Konto- und Ordnerumfang erhalten haben.

Exportfehler behandeln und Wiederherstellung überprüfen

Sollte es zu einem Timeout kommen, notieren -t 0und überprüfen Sie die Timeout- und Speichergrenzen des Servers oder Proxys. Ein Timeout von Null in der Befehlszeile behebt nicht jedes Netzwerkproblem. Das Support-Wiki von Zimbra warnt außerdem vor beschädigten Archiven und E/A-Fehlern beim Export großer Postfächer. Bei einem zu großen oder unzuverlässigen Export teilen Sie die Arbeit nach Ordnern oder Datum auf und testen Sie jedes Archiv und dessen Import auf einem Testkonto.

Die dokumentierte Suchanfrage wählt beispielsweise under:Inboxden Posteingang und seine Unterordner aus. Die Anführungszeichen um die REST-URL sind unerlässlich, da das kaufmännische Und-Zeichen (&) Zimbra und nicht die Shell erreichen muss.

zmmailbox -z -m user@example.com -t 0 getRestURL '//?fmt=tgz&query=under:Inbox' > /srv/zimbra-mailbox-backups/inbox-20261010.tgz

Ein ordnerbezogenes Archiv ersetzt nicht den vollständigen Postfachexport. Überprüfen Sie dessen Inhalt separat und dokumentieren Sie, welche Ordner oder Daten fehlen. Wenn das Konto deaktiviert ist oder die Anfrage einen Autorisierungsfehler zurückgibt, überprüfen Sie den Kontostatus und die administrative Authentifizierung, anstatt TLS-Zertifikatprüfungen zu umgehen oder Anmeldeinformationen preiszugeben.

7. Überprüfen Sie die wiederhergestellten Elemente, nicht nur den Befehl „exit“.

Listen Sie die Zielordner auf und vergleichen Sie sie mit den aufgezeichneten Quellordnern und dem TGZ-Inventar:

zmmailbox -z -m user@example.com getAllFolders
zmmailbox -z -m user@example.com getMailboxSize

Melden Sie sich anschließend im Ziel-Testkonto an und öffnen Sie eine Beispielausgabe empfangener und gesendeter Nachrichten, Anhänge, Kontakte und Kalenderereignisse. Überprüfen Sie Datumsangaben und Ordnerpfade sowie etwaige Importfehler. Erstellen oder überprüfen Sie bei Bedarf Aliase, Freigabeberechtigungen, Regeln und andere Kontoeinstellungen separat. Die Wiederherstellung gilt erst dann als erfolgreich, wenn die erwarteten Daten zugänglich sind und die Prüfungen protokolliert wurden.

Primäre Referenzen: Zimbra-Befehlsreferenz für zmmailbox , Zimbra-REST-API-Referenz , Zimbra-Administrationsreferenz für zmprov und Zimbra-Artikel zu Scoped Exports und Vorsichtsmaßnahmen bei großen Archiven . Einige Beispiele im Zimbra-Wiki sind älter oder als „in Bearbeitung“ gekennzeichnet; überprüfen Sie deren Verhalten auf Ihrer installierten CE-Version, bevor Sie sie produktiv einsetzen.