Ongeveer 5 minuten

Zo upload je bestanden naar Cloudflare R2 en deel je links

Cloudflare R2 past uitstekend bij Aktar: geen kosten voor uitgaand verkeer, een gratis tegoed dat voor de meeste screenshots ruim genoeg is, en eigen domeinen die via het netwerk van Cloudflare worden geserveerd. Aktar heeft een eigen voorinstelling voor R2, dus je hebt alleen je Account-ID, een API-token en een bucket nodig.

Wat je nodig hebt

  • Een Cloudflare-account met R2 ingeschakeld
  • Een domein bij Cloudflare als je links op je eigen domein wilt (optioneel)
  • Aktar geïnstalleerd op je Mac

Stap voor stap

  1. 1

    Maak een bucket

    Open in het Cloudflare-dashboard R2 Object Storage en klik op Create bucket. Kies een korte naam zoals screenshots en houd de automatische locatie aan.

  2. 2

    Geef de bucket een openbaar adres

    Open de Settings van de bucket. Koppel onder Custom Domains een domein of subdomein dat je bij Cloudflare beheert, bijvoorbeeld files.example.com. Dat is de beste optie voor echt gebruik.

    Voor een snelle test kun je in plaats daarvan de Public Development URL (pub-….r2.dev) inschakelen. Cloudflare beperkt het aantal verzoeken op die URL en raadt hem af voor productie.

  3. 3

    Maak een API-token

    Open op de overzichtspagina van R2 Manage API tokens en maak een token met de toestemming Object Read & Write, beperkt tot je bucket. Kopieer de Access Key ID en de Secret Access Key: de secret wordt maar één keer getoond.

    Je Account ID staat op dezelfde pagina, en is ook het eerste deel van het S3-endpoint https://<ACCOUNT_ID>.r2.cloudflarestorage.com.

  4. 4

    Voeg de bestemming toe in Aktar

    Open in Aktar Instellingen → Bestemmingen → Voeg bestemming toe, kies Cloudflare R2 en vul de velden uit de tabel hieronder in. Aktar leidt het endpoint af van je Account-ID.

  5. 5

    Test en bewaar

    Klik op Test verbinding. Aktar uploadt een klein testbestand, controleert of het bereikbaar is via je openbare adres en verwijdert het weer. Is alles groen, klik dan op Bewaar en sleep je eerste bestand naar het menubalksymbool.

Instellingen in Aktar

Vul deze waarden in bij Instellingen → Bestemmingen → Voeg bestemming toe. De veldnamen komen overeen met de app.

VeldVoorbeeldwaarde
ProviderCloudflare R2
ProfielnaamPersoonlijkElke naam die je wilt.
Account-ID3f9a71c0e2b8…Van de overzichtspagina van R2.
RegioautoHoud de standaard aan.
Access Key IDa1b2c3d4…Uit het R2-API-token.
Secret Access Key••••••••Bewaard in de macOS-sleutelhanger.
Bucketscreenshots
Openbare basis-URLfiles.example.comJe eigen domein of de r2.dev-URL.
Objectpad{year}/{month}/{uuid}.{ext}Optioneel, zie bestandsnamen en mappen.

Tips

  • Beperk het API-token tot de ene bucket die Aktar gebruikt. Lekt het token ooit uit, dan ligt er verder niets open.
  • Een eigen domein wordt door Cloudflare in de cache bewaard, dus populaire links laden wereldwijd snel, zonder extra kosten.
  • Wil je nette mappen? Wijzig het objectpad, bijvoorbeeld in shots/{date}/{filename}-{random}.{ext}. Zie bestandsnamen en mappen.
  • Wil je uploads die zichzelf na 1 tot 30 dagen verwijderen? Met een token met Admin Read & Write voegt Aktar de levenscyclusregels van de bucket voor je toe. Met een token met Object Read & Write voeg je ze zelf toe onder Object Lifecycle Rules in de Settings van de bucket. Zie verlopende uploads.

Problemen oplossen

De link geeft Access Denied of 403

Zorg dat de Openbare basis-URL je eigen domein of de r2.dev-URL is. Het endpoint …r2.cloudflarestorage.com is alleen voor de API en serveert nooit openbare bestanden. Meer in Access Denied-fouten.

Test verbinding meldt dat de inloggegevens ongeldig zijn

Gebruik de Access Key ID en Secret Access Key van het R2-API-token, niet een gewoon Cloudflare-API-token of je Global API Key. Controleer of er geen extra spaties in de Account-ID staan.

Uploads werken, maar links zijn traag of worden beperkt

Je gebruikt waarschijnlijk de r2.dev-ontwikkel-URL. Koppel een eigen domein voor productiegebruik.

Kom je er nog niet uit?Bekijk de FAQ of stel je vraag op GitHub.