Bunny Storage Adapter

Über

Der Adapter basiert auf `@payloadcms/plugin-cloud-storage` und lädt Dateien, Bilder und Dokumente in eine Bunny Storage Zone hoch, die über das Bunny CDN ausgeliefert wird. Für jede konfigurierte Upload-Collection setzt das Plugin `disableLocalStorage`, sodass Dateien nicht auf dem Server landen. Es registriert `afterChange`-, `beforeRead`- und `beforeValidate`-Hooks, optionale Stream-Endpunkte und einen Cleanup-Task im Payload-Jobs-System. Eine optionale Bunny-Stream-Integration verarbeitet Videos mit HLS- und MP4-Wiedergabe, adaptiven Bitraten und Thumbnail-Extraktion. Wenn Bunny Stream und TUS gemeinsam aktiviert sind, injiziert das Plugin eine `TusUpload`-React-Komponente in den Admin-Editor und ein Media-Preview-Feld. Große Videodateien werden über TUS-Resumable-Uploads mit automatischer Fortsetzung bei Verbindungsabbrüchen über `tus-js-client` hochgeladen. Die Konfiguration erfolgt pro Collection mit globalen Defaults. Zu den Optionen gehören ein Speicher-`prefix`, `disablePayloadAccessControl` zur direkten CDN-Auslieferung unter Umgehung der Payload-Authentifizierung, signierte URLs mit Zeitlimits und Geo-Beschränkungen, automatisches Cache-Purging beim Upload und Löschen, Thumbnails mit anpassbaren URL-Transforms sowie eigene URL-Transformationen. Das Plugin benötigt einen Bunny Storage API-Key, einen Hostnamen und einen Zone-Namen; Bunny Stream ist optional. Voraussetzung ist Payload 3.53.0 oder neuer, für Payload 3.0.0 bis 3.52.x steht Version 1.x zur Verfügung. Mehrsprachige i18n-Übersetzungen für die Admin-Oberfläche sind enthalten.

Paketinformationen

Paketname

@seshuk/payload-storage-bunny

Neueste Version

3.1.2

Entpackte Größe

1 MB

Lizenz

MIT

Wöchentliche Downloads

3506

Zuletzt veröffentlicht

1. Okt. 2026