Een S3-kanaal toevoegen

Wanneer dit geschikt is

Gebruik het S3-kanaal wanneer:

• je een S3-compatibele objectopslagdienst wilt koppelen, zoals Cloudflare R2, Backblaze B2, MinIO, AWS S3 of een andere compatibele provider.
• je het standaard S3-configuratiemodel met Endpoint, Access Key en Secret Key wilt gebruiken.
• je niet het native Cloudflare R2-bindingkanaal gebruikt, of je opslagprovider geen Cloudflare R2 is.

Wat je vooraf nodig hebt

Vereiste	Doel
S3 Endpoint	De S3 API-endpoint van de objectopslagdienst.
Bucketnaam	De bucket waarin bestanden worden opgeslagen.
Region	Opslagregio. Voor Cloudflare R2 is dit meestal auto.
Access Key ID	S3 access key ID.
Secret Access Key	S3 secret access key.
CDN-domein	Optioneel aangepast domein voor bestandstoegang.

Voorbeeld voor Cloudflare R2 via de S3 API:

Endpoint: https://your-account-id.r2.cloudflarestorage.com
Bucket: your-r2-bucket-name
Region: auto
Access Key ID: gekopieerd uit het Cloudflare R2 API-token
Secret Access Key: gekopieerd uit het Cloudflare R2 API-token

Waar je het toevoegt

1. Open Systeeminstellingen.
2. Ga naar Uploadinstellingen.
3. Klik rechtsboven op Kanaal toevoegen.
4. Selecteer S3.

Veldreferentie

Veld	Functie	Verplicht
Kanaalnaam	Een herkenbare naam, bijvoorbeeld s3test of R2-S3.	Ja
Kanaal inschakelen	Bepaalt of dit kanaal meedoet aan uploadselectie.	Aanbevolen
Endpoint	Volledige S3-service-endpoint, inclusief https://.	Ja
Aangepast CDN-domein	Optioneel. Als dit is ingesteld, gebruiken gegenereerde bestandslinks bij voorkeur dit domein.	Nee
Bucketnaam	Bucketnaam, bijvoorbeeld s3test of img-r2.	Ja
Bucketregio	Regio. Voor Cloudflare R2 meestal auto.	Ja
Access Key ID	S3 access key ID.	Ja
Secret Access Key	S3 secret access key.	Ja
Path-style access	Compatibiliteitsschakelaar. Standaard uit. Sommige MinIO-, OpenList- of zelf gehoste S3-diensten hebben dit nodig.	Nee
Quotalimiet	Bepaalt of dit kanaal op basis van capaciteit wordt meegenomen bij uploads.	Nee
Capaciteitslimiet	Verplicht nadat quotalimiet is ingeschakeld, bijvoorbeeld 10 GB.	Verplicht bij quotalimiet
Drempel	Stopt schrijven nadat dit percentage is bereikt, bijvoorbeeld 90%.	Verplicht bij quotalimiet
Opmerking	Notities voor eigen beheer.	Nee

Cloudflare R2 S3 API-sleutels maken

1. Open het Cloudflare Dashboard.
2. Ga naar R2 Object Storage.
3. Zoek Manage R2 API Tokens of de ingang voor API-tokenbeheer.


4. Maak een R2 API-token dat toegang heeft tot de doelbucket.

5. Kopieer de gegenereerde Access Key ID en Secret Access Key.

6. Ga terug naar de R2-bucketpagina en controleer de bucketnaam.
7. Noteer de S3 API-endpoint van het account. Die ziet er meestal zo uit:

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

Instelstappen

1. Open Uploadinstellingen.
2. Klik op Kanaal toevoegen.
3. Selecteer S3.
4. Vul een herkenbare kanaalnaam in, bijvoorbeeld s3test.
5. Vul de S3 API-endpoint in bij Endpoint.
6. Gebruik je een eigen CDN, vul dat dan in bij Custom CDN domain; anders laat je het leeg.
7. Vul de bucketnaam in.
8. Vul de regio in. Voor Cloudflare R2 gebruik je in dit voorbeeld auto.
9. Vul Access Key ID en Secret Access Key in.
10. Laat Path-style access uit, tenzij je provider dit expliciet vereist.
11. Wil je capaciteitsbeheer, schakel dan de quotalimiet in en vul capaciteitslimiet en drempel in.
12. Klik op Opslaan.

Controleren

Controle	Hoe je controleert
Kanaalkaart verschijnt	Na opslaan moet in Uploadinstellingen een S3-kanaalkaart zichtbaar zijn.
Kanaal is actief	De schakelaar rechtsboven op de kaart blijft aan.
Belangrijke velden zijn opgeslagen	De detailweergave toont Endpoint, Bucket, Region, Path-style access en verwante velden.
Upload werkt	Upload een testafbeelding en controleer of het object in de doelbucket verschijnt.
Link opent	De afbeeldingslink die na upload wordt teruggegeven opent normaal.
Capaciteitsweergave werkt	Als quotalimiet actief is, toont de kaart gebruikte capaciteit en de ingestelde limiet.

S3-capaciteitsstatistieken worden berekend op basis van ImgBeds lokale bestandsrecords, niet door de bucket realtime bij de provider op te vragen. Na het opslaan van een S3-configuratie berekent het systeem het quota-overzicht opnieuw vanuit de huidige D1-records.

FAQ

Moet ik Path-style access inschakelen?

Meestal niet.

Schakel dit alleen in als je S3-compatibele provider geen virtual-hosted-style URL's ondersteunt of als de documentatie dit expliciet vereist. Sommige MinIO-, zelf gehoste S3- en OpenList-compatibele endpoints hebben het nodig.

Waar is het CDN-domein voor?

Als je een CDN of aangepast toegangsdomein voor de bucket zet, vul je dat hier in.

Na configuratie gebruikt ImgBed dit domein bij voorkeur voor gegenereerde bestandslinks. Gebruik je geen CDN, laat het veld leeg.

Waarom mislukt uploaden?

Controleer eerst:

1. De Endpoint bevat de volledige https://-URL.
2. De bucketnaam klopt.
3. De Region past bij de eisen van de provider.
4. Access Key ID en Secret Access Key zijn volledig gekopieerd.
5. De sleutel heeft schrijfrechten op de doelbucket.
6. De provider vereist geen Path-style access, of dit is ingeschakeld als het wel nodig is.

Snelle checklist

Bereid S3 Endpoint, Bucket, Region, Access Key en Secret Key voor
-> Open Uploadinstellingen
-> Kanaal toevoegen
-> Selecteer S3
-> Vul Endpoint / Bucket / Region / Access Key / Secret Key in
-> Vul eventueel een CDN-domein in
-> Laat Path-style access standaard uit
-> Schakel quotalimiet in als dat nodig is
-> Sla op
-> Upload een testafbeelding en controleer het resultaat