S3-Kanal hinzufügen

Geeignet für

Nutze den S3-Kanal, wenn:

• du einen S3-kompatiblen Objektspeicher anbinden möchtest, etwa Cloudflare R2, Backblaze B2, MinIO, AWS S3 oder einen anderen kompatiblen Anbieter.
• du das klassische S3-Konfigurationsmodell mit Endpoint, Access Key und Secret Key bevorzugst.
• du nicht den nativen Cloudflare-R2-Binding-Kanal verwenden möchtest oder dein Anbieter nicht Cloudflare R2 ist.

Was du vorher brauchst

Voraussetzung	Zweck
S3 Endpoint	API-Endpunkt des Objektspeichers.
Bucket-Name	Bucket, in dem Dateien gespeichert werden.
Region	Speicherregion. Bei Cloudflare R2 meistens auto.
Access Key ID	S3-Zugriffsschlüssel-ID.
Secret Access Key	Geheimer S3-Zugriffsschlüssel.
CDN-Domain	Optionaler eigener Zugriffsdomainname.

Beispiel für Cloudflare R2 über die S3-API:

Endpoint: https://your-account-id.r2.cloudflarestorage.com
Bucket: your-r2-bucket-name
Region: auto
Access Key ID: aus dem Cloudflare-R2-API-Token kopiert
Secret Access Key: aus dem Cloudflare-R2-API-Token kopiert

Wo hinzufügen

1. Öffne die Systemeinstellungen.
2. Gehe zu Upload-Einstellungen.
3. Klicke oben rechts auf Kanal hinzufügen.
4. Wähle S3.

Feldübersicht

Feld	Funktion	Erforderlich
Kanalname	Ein gut erkennbarer Name für diesen S3-Kanal, z. B. s3test oder R2-S3.	Ja
Kanal aktivieren	Legt fest, ob dieser Kanal bei der Upload-Auswahl verwendet wird.	Empfohlen
Endpoint	Vollständiger S3-Service-Endpunkt inklusive https://.	Ja
Eigene CDN-Domain	Optional. Wenn gesetzt, bevorzugen generierte Dateilinks diese Domain.	Nein
Bucket-Name	Bucket-Name, z. B. s3test oder img-r2.	Ja
Bucket-Region	Region. Bei Cloudflare R2 meistens auto.	Ja
Access Key ID	S3-Zugriffsschlüssel-ID.	Ja
Secret Access Key	Geheimer S3-Zugriffsschlüssel.	Ja
Path-style access	Kompatibilitätsschalter. Standardmäßig aus. Manche MinIO-, OpenList- oder selbst gehostete S3-Dienste benötigen ihn.	Nein
Quotenlimit	Steuert, ob dieser S3-Kanal abhängig von der Kapazität bei Uploads berücksichtigt wird.	Nein
Kapazitätslimit	Nach Aktivierung des Quotenlimits erforderlich, z. B. 10 GB.	Erforderlich bei aktivem Quotenlimit
Schwellenwert	Stoppt Schreibvorgänge nach Erreichen dieses Prozentsatzes, z. B. 90%.	Erforderlich bei aktivem Quotenlimit
Bemerkung	Notizen für deine eigene Wartung.	Nein

Cloudflare-R2-S3-API-Schlüssel erstellen

1. Öffne das Cloudflare Dashboard.
2. Gehe zu R2 Object Storage.
3. Suche Manage R2 API Tokens oder den Eintrag zur API-Token-Verwaltung.


4. Erstelle ein R2-API-Token mit Zugriff auf den Ziel-Bucket.

5. Kopiere die erzeugten Werte Access Key ID und Secret Access Key.

6. Kehre zur R2-Bucket-Seite zurück und prüfe den Bucket-Namen.
7. Notiere den S3-API-Endpunkt des Kontos. Er sieht normalerweise so aus:

https://your-account-id.r2.cloudflarestorage.com

Einrichtungsschritte

1. Öffne die Upload-Einstellungen.
2. Klicke auf Kanal hinzufügen.
3. Wähle S3.
4. Trage einen gut erkennbaren Kanalnamen ein, z. B. s3test.
5. Trage den S3-API-Endpunkt bei Endpoint ein.
6. Wenn du ein eigenes CDN nutzt, trage es bei Custom CDN domain ein; sonst leer lassen.
7. Trage den Bucket-Namen ein.
8. Trage die Region ein. Für Cloudflare R2 im Beispiel ist das auto.
9. Trage Access Key ID und Secret Access Key ein.
10. Lasse Path-style access ausgeschaltet, sofern dein Anbieter ihn nicht ausdrücklich verlangt.
11. Wenn du Kapazitätssteuerung möchtest, aktiviere das Quotenlimit und trage Kapazitätslimit sowie Schwellenwert ein.
12. Klicke auf Speichern.

Prüfung

Prüfung	So prüfst du es
Kanalkarte erscheint	Nach dem Speichern sollte in den Upload-Einstellungen eine S3-Kanalkarte sichtbar sein.
Kanal ist aktiv	Der Schalter oben rechts auf der Karte bleibt eingeschaltet.
Wichtige Felder sind gespeichert	Die Detailansicht zeigt Endpoint, Bucket, Region, Path-style access und verwandte Felder.
Upload funktioniert	Lade ein Testbild hoch und prüfe, ob das Objekt im Ziel-Bucket erscheint.
Link öffnet sich	Der nach dem Upload zurückgegebene Bildlink lässt sich normal öffnen.
Kapazitätsanzeige funktioniert	Bei aktivem Quotenlimit zeigt die Karte belegten Speicher und konfiguriertes Limit.

S3-Kapazitätsstatistiken werden aus den lokalen Dateidatensätzen von ImgBed berechnet, nicht in Echtzeit aus dem Anbieter-Bucket abgefragt. Nach dem Speichern einer S3-Konfiguration berechnet das System die Quotenübersicht anhand der aktuellen D1-Einträge neu.

FAQ

Soll ich Path-style access aktivieren?

In der Regel nein.

Aktiviere ihn nur, wenn dein S3-kompatibler Anbieter keine Virtual-hosted-style-URLs unterstützt oder die Dokumentation des Anbieters Path-style access ausdrücklich verlangt. Manche MinIO-, selbst gehostete S3- und OpenList-kompatible Endpunkte benötigen das.

Wofür ist die CDN-Domain?

Wenn du ein CDN oder eine eigene Zugriffsdomain vor den Bucket schaltest, trägst du sie hier ein.

Nach der Konfiguration bevorzugt ImgBed diese Domain für generierte Dateilinks. Wenn du kein CDN nutzt, lässt du das Feld leer.

Warum schlägt der Upload fehl?

Prüfe zuerst diese Punkte:

1. Der Endpoint enthält die vollständige https://-URL.
2. Der Bucket-Name stimmt.
3. Die Region passt zu den Vorgaben des Anbieters.
4. Access Key ID und Secret Access Key wurden vollständig kopiert.
5. Der Schlüssel hat Schreibrechte für den Ziel-Bucket.
6. Der Anbieter benötigt keinen Path-style access, oder er wurde aktiviert, falls nötig.

Kurzcheck

S3 Endpoint, Bucket, Region, Access Key und Secret Key vorbereiten
-> Upload-Einstellungen öffnen
-> Kanal hinzufügen
-> S3 wählen
-> Endpoint / Bucket / Region / Access Key / Secret Key eintragen
-> Bei Bedarf CDN-Domain eintragen
-> Path-style access standardmäßig ausgeschaltet lassen
-> Bei Bedarf Quotenlimit aktivieren
-> Speichern
-> Testbild hochladen und Ergebnis prüfen