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.

Terminal, das eine Zimbra-Kontoabfrage mit Mailbox-Host und aktivem Status anzeigt
Überprüfen Sie vor dem Start des Exports die E-Mail-Adresse, den Hosting-Server und den Kontostatus.

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.

Terminal mit Anzeige eines privaten Mailbox-Backup-Verzeichnisses und einer Unix-Berechtigungsliste
Verwenden Sie ein privates Backup-Verzeichnis und überprüfen Sie dessen Dateisystemberechtigungen.

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.

Terminalanzeige, die zmmailbox getRestURL beim Exportieren eines Postfachs in eine TGZ-Datei anzeigt
Der Befehl getRestURL schreibt ein komprimiertes Mailbox-Archiv in das gewählte Verzeichnis.

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.

Terminalanzeige mit Archivbestand, Gzip-Integrität und einer Liste der Mailbox-Ordner
Prüfen Sie das Archiv, bevor Sie den Export als nutzbare Wiederherstellungskopie behandeln.
Terminalanzeige mit SHA-256-Prüfsumme für eine Mailbox-TGZ-Datei
Speichern Sie einen SHA-256-Digest, damit das übertragene Archiv auf Änderungen überprüft werden kann.

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.

Terminal mit Anzeige der Kontoattribute des Zimbra-Bereitstellungsbefehls
Vergewissern Sie sich vor dem Importieren von Postfachelementen, dass das gewünschte Zielkonto existiert.

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.

Terminalanzeige für zmmailbox postRestURL mit der Option resolve=skip
Importieren Sie das Archiv mit der Option „Konflikte überspringen“, wenn vorhandene Postfachinhalte erhalten bleiben müssen.

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.

Terminal mit Anzeige der von getAllFolders zurückgegebenen Zimbra-Ordnernamen
Vergleichen Sie den wiederhergestellten Posteingang, die Ordner „Gesendet“, den Kalender und andere Ordner mit dem erwarteten Archivinhalt.

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.

Einen Kommentar hinterlassen

Automatisieren Sie ownCloud-Datenbank-Dumps mit einem sicheren nächtlichen Cron-Job

Automatisieren Sie ownCloud-Datenbank-Dumps mit einem sicheren nächtlichen Cron-Job

Planen Sie geschützte MariaDB-Dumps für ownCloud Server, handhaben Sie den Wartungsmodus sicher und überprüfen Sie jedes Backup, bevor Sie sich darauf verlassen.

Wechseln Sie ownCloud Classic mit einer unterstützten Migration zu oCIS.

Planen Sie eine Migration von ownCloud 10 zu oCIS mit der unterstützten App, geordneten Befehlen, Identitätsprüfungen und einer klaren Liste der Daten, die eine separate Behandlung erfordern.

ownCloud Classic 10 mit Theme-App und CSS

Ersetzen Sie die ownCloud Classic 10-Logos und passen Sie die Farben der Web-Benutzeroberfläche mit einer Design-App an, ohne dabei Probleme bei Upgrades und Integritätsprüfungen zu riskieren.

Festlegen von Standard-Speicherkontingenten nach Benutzerrolle in ownCloud oCIS

Festlegen von Standard-Speicherkontingenten nach Benutzerrolle in ownCloud oCIS

Weisen Sie neuen ownCloud Infinite Scale-Benutzern rollenbasierte Speicherlimits auf Byte-Basis zu, inklusive eines proxy.yaml-Beispiels und einer Checkliste zur sicheren Überprüfung.

Behebung von ownCloud-Synchronisierungszertifikatfehlern an der TLS-Quelle

Behebung von ownCloud-Synchronisierungszertifikatfehlern an der TLS-Quelle

Stellen Sie die ownCloud-Desktop-Synchronisierung wieder her, indem Sie den Server-Hostnamen, die Zertifikatskette, die Vertrauensstellung der privaten Zertifizierungsstelle und Probleme mit dem Captive Portal überprüfen, ohne die TLS-Verifizierung zu deaktivieren.

ownCloud-Integritätswarnung nach einem Upgrade löschen

Verwenden Sie den Bericht über ungültige Dateien, um nicht übereinstimmende Kerndateien oder App-Signaturen zu identifizieren, die korrekten Release-Dateien wiederherzustellen und die Integritätsprüfung sicher durchzuführen.

ownCloud Infinite Scale mit Docker Compose installieren

Stellen Sie ownCloud Infinite Scale anhand des offiziellen Compose-Beispiels bereit, konfigurieren Sie Domänen und persistenten Speicher und überprüfen Sie anschließend TLS, Container und die erste Anmeldung.

Konfigurieren Sie S3 Blob Storage für ownCloud Infinite Scale

Konfigurieren Sie S3 Blob Storage für ownCloud Infinite Scale

Richten Sie den S3NG-Treiber, die Bucket-Berechtigungen, die persistente Metadatenspeicherung und die Upload-Größe so ein, dass ownCloud Infinite Scale Dateiinhalte zuverlässig speichern kann.

Wenn ownCloud-Uploads bei 99 % hängen bleiben, überprüfen Sie diese Grenzwerte.

Wenn ownCloud-Uploads bei 99 % hängen bleiben, überprüfen Sie diese Grenzwerte.

Finden Sie heraus, warum ein Upload auf einem ownCloud-Server kurz vor Abschluss abbricht, indem Sie den Dateistatus, das Kontingent, den temporären Speicherplatz, die PHP-Limits und die Proxy-Timeouts überprüfen.

ownCloud Apache .htaccess-Warnung sicher löschen

ownCloud Apache .htaccess-Warnung sicher löschen

Setzen Sie AllowOverride All nur für das Web-Root-Verzeichnis von ownCloud, überprüfen Sie den aktiven Apache-Vhost und laden Sie die Seite sicher neu, um die .htaccess-Regeln wiederherzustellen.