Hörbücher in S3-kompatiblem Speicher ablegen
Aktualisiert am 27. Oktober 2026
Berth kann Bücher statt auf der Festplatte des Servers in jedem S3-kompatiblen Bucket speichern. Der Server verwaltet die Bibliothek und entscheidet, wer hören darf; das Audio selbst kann aus dem Bucket oder einem CDN direkt auf die Handys gelangen.
Warum Objektspeicher
- Ein kleiner VPS oder ein Raspberry Pi braucht keine große Festplatte.
- Handys laden direkt aus dem Speicher, sodass die Bandbreite des Servers nicht zum Engpass wird.
- Die Datenbank und ihre Backups bleiben klein; mit S3 kann der Server außerdem täglich eine Kopie der Datenbank in den Bucket legen.
Unterstützte Anbieter
Jeder S3-kompatible Dienst funktioniert. Der Admin hat Vorlagen, die Endpoint und Region ausfüllen für: AWS S3, Cloudflare R2, Yandex Cloud, Backblaze B2, Bunny Storage und MinIO. Für Cloudflare R2 gibt es außerdem einen Assistenten, der Bucket und Schlüssel für dich anlegt.
Einen Bucket verbinden
- Leg in der Konsole deines Anbieters einen Bucket und einen Zugriffsschlüssel mit Lese- und Schreibzugriff darauf an.
- Füge dem Bucket eine CORS-Regel hinzu: Origin ist deine Berth-Adresse, Methoden GET, HEAD, PUT, Header
*. Der Admin lädt Dateien aus dem Browser direkt in den Bucket hoch, daher ist diese Regel Pflicht. - Öffne im Berth-Admin die Speichereinstellungen, füge Speicher hinzu, wähle „S3-Bucket“ und nimm eine Vorlage oder fülle die Felder selbst aus.
- Trag Name, Bucket, Endpoint (leer für AWS), Region (
us-east-1, wenn leer), Access-Key-ID und Secret Access Key ein. Schalte für MinIO Pfad-Adressen (Path-Style) ein; bei einer IP-Adresse oder localhost werden sie von selbst eingeschaltet. - Klick auf „Verbindung prüfen“: Berth schreibt eine kleine Testdatei, liest sie zurück, löscht sie und prüft CORS von deinen Serveradressen aus.
- Mach den Speicher zum Standard: Neue Bücher landen im Standardspeicher.
Die Schlüssel werden mit dem Serverschlüssel secret.key verschlüsselt gespeichert und nie wieder angezeigt.
Wie das Audio auf die Handys kommt
Ohne Signierung öffnen sich Dateien hinter einem CDN über einen Link, der nie abläuft. Ihre Namen sind SHA-256-Hashes und nicht zu erraten, aber das Trennen eines Geräts schließt keine Links, die es bereits hat. Mit der Token-Authentifizierung von Bunny CDN laufen Links nach 6 Stunden ab.
| Modus | So funktioniert’s | Wann nutzen |
|---|---|---|
| Direkte Links (Standard) | Handys erhalten einen signierten Link zum Bucket, der 15 Minuten gilt | Entlastet den Server |
| Über den Server | Der Server streamt die Datei; Links gelten 6 Stunden und funktionieren sofort nicht mehr, wenn ein Gerät getrennt wird | Handys erreichen den Bucket nicht |
| Über ein CDN | Links zeigen auf ein CDN oder eine öffentliche Adresse des Buckets | Am schnellsten, wenn der Bucket ein CDN hat |
Gut zu wissen
- Du kannst mehrere Speicher gleichzeitig haben; bei jedem Buch steht, in welchem es liegt.
- Bestehende Bücher zwischen Speichern zu verschieben ist noch nicht möglich: Wähle den Standardspeicher vor dem Hochladen.
- Ein Speicher, der Bücher enthält, kann nicht gelöscht werden. Das Entfernen eines Profils löscht nie Dateien im Bucket.
Fragen
Braucht Berth öffentlichen Zugriff auf den Bucket?
Nein. Im Standardmodus bleibt der Bucket privat, und Handys erhalten signierte Links, die nach 15 Minuten ablaufen.
Die Prüfung meldet, dass der Bucket keine Uploads aus einem Browser annimmt. Was nun?
Füge die CORS-Regel hinzu: Origin ist die Berth-Adresse, Methoden GET, HEAD, PUT, Header *. Führe die Prüfung dann erneut aus.