MongoDB Backup

Über

Dieses Plugin fügt einem Payload-v3-Projekt mit Mongoose-Adapter Backup- und Restore-Funktionen für MongoDB hinzu. Backups werden als Archive in Vercel Blob Storage gespeichert. Die Blob-Namen sind selbsterklärend und codieren Typ, Datenbank, Host, Collection-Anzahl und Zeitstempel, sodass eine frische Installation frühere Archive ohne vorherigen Datenbank-Bootstrap listen und wiederherstellen kann. Das Plugin registriert ein BackupDashboard-Widget über den afterDashboard-Slot der Payload-Admin-Oberfläche sowie eigene REST-Endpunkte unter /api/backup-mongodb/*. Next.js-Routendateien sind nicht erforderlich. Ein Backup umfasst alle MongoDB-Collections einschließlich System-Collections wie users, payload-preferences und payload-migrations. Einzelne Collections lassen sich pro Durchlauf über die UI oder API ausschließen. Medien können als .tar.gz zusätzlich zum Dump in das Archiv gebündelt werden. Zeitgesteuerte Backups laufen über einen HTTP-Cron-Endpunkt unter /api/backup-mongodb/cron/run, der sich an Vercel Cron oder einen beliebigen Scheduler anbinden lässt. Die Authentifizierung erfolgt über einen Bearer-Token mit CRON_SECRET. Eine konfigurierbare Aufbewahrungsregel prüft ältere Archive anhand von BACKUPS_TO_KEEP, Standard ist 10. Manuelle Backups und Restores werden in einer verborgenen backup-tasks-Collection mit einer TTL von 30 Minuten nachverfolgt. Das Dashboard pollt den Fortschritt mit einem kurzlebigen Secret, sodass lang laufende Aufgaben auch über Seitenwechsel hinweg beobachtbar bleiben. Die Konfiguration benötigt MONGODB_URI und BLOB_READ_WRITE_TOKEN. Optional sind CRON_SECRET, BACKUPS_TO_KEEP und PAYLOAD_BACKUP_ALLOWED_ROLES für die Zugriffskontrolle. Die Zugriffsregelung erfolgt entweder über die access-Option des Plugins oder über PAYLOAD_BACKUP_ALLOWED_ROLES, die Rollen-Slugs oder * für alle authentifizierten Nutzer akzeptiert. Restore unterstützt eine Collection-Blacklist und einen mergeData-Upsert-Modus für Teilwiederherstellungen. Peer-Dependencies sind payload ^3, @payloadcms/db-mongodb ^3, next ^15 und react ^19. Der Speicher ist auf Vercel Blob beschränkt.

Paketinformationen

Paketname

@trieb.work/payload-plugin-backup-mongodb

Neueste Version

0.2.0

Entpackte Größe

876 kB

Lizenz

MIT

Wöchentliche Downloads

41

Zuletzt veröffentlicht

15. Sep. 2026