Etwa 5 Minuten

Aktar mit Cloudflare R2 verwenden

Cloudflare R2 passt hervorragend zu Aktar: keine Gebühren für ausgehenden Traffic, ein kostenloses Kontingent, das für die meisten Screenshots reicht, und eigene Domains, die über das Cloudflare-Netzwerk ausgeliefert werden. Aktar hat eine eigene R2-Vorlage, du brauchst also nur deine Account ID, ein API-Token und einen Bucket.

Was du brauchst

  • Ein Cloudflare-Konto mit aktiviertem R2
  • Eine Domain bei Cloudflare, wenn deine Links deine eigene Domain nutzen sollen (optional)
  • Aktar auf deinem Mac installiert

Schritt für Schritt

  1. 1

    Bucket erstellen

    Öffne im Cloudflare-Dashboard R2 Object Storage und klick auf Create bucket. Wähle einen kurzen Namen wie screenshots und behalte den automatischen Standort bei.

  2. 2

    Dem Bucket eine öffentliche Adresse geben

    Öffne die Settings des Buckets. Verbinde unter Custom Domains eine Domain oder Subdomain, die du bei Cloudflare verwaltest, zum Beispiel files.example.com. Das ist die beste Option für den echten Einsatz.

    Für einen schnellen Test kannst du stattdessen die Public Development URL (pub-….r2.dev) aktivieren. Cloudflare drosselt diese URL und empfiehlt sie nicht für den Produktivbetrieb.

  3. 3

    API-Token erstellen

    Öffne auf der R2-Übersichtsseite Manage API tokens und erstelle ein Token mit der Berechtigung Object Read & Write, beschränkt auf deinen Bucket. Kopiere Access Key ID und Secret Access Key: Der Secret wird nur einmal angezeigt.

    Deine Account ID steht auf derselben Seite und ist außerdem der erste Teil des S3-Endpunkts https://<ACCOUNT_ID>.r2.cloudflarestorage.com.

  4. 4

    Ziel in Aktar hinzufügen

    Öffne in Aktar Settings → Destinations → Add Destination, wähle Cloudflare R2 und füll die Felder aus der Tabelle unten aus. Aktar leitet den Endpunkt aus deiner Account ID ab.

  5. 5

    Testen und speichern

    Klick auf Test Connection. Aktar lädt eine winzige Testdatei hoch, prüft, ob sie über deine öffentliche Adresse erreichbar ist, und löscht sie wieder. Wenn alles grün ist, klick auf Save und zieh deine erste Datei auf das Menüleisten-Symbol.

Einstellungen in Aktar

Trag diese Werte unter Settings → Destinations → Add Destination ein. Die Feldnamen entsprechen der App.

FeldBeispielwert
ProviderCloudflare R2
Profile NamePersonalEin beliebiger Name.
Account ID3f9a71c0e2b8…Von der R2-Übersichtsseite.
RegionautoStandard beibehalten.
Access Key IDa1b2c3d4…Aus dem R2-API-Token.
Secret Access Key••••••••Wird im macOS-Schlüsselbund gespeichert.
Bucketscreenshots
Public Base URLfiles.example.comDeine eigene Domain oder die r2.dev-URL.
Object Path{year}/{month}/{uuid}.{ext}Optional, siehe Dateinamen und Ordner.

Tipps

  • Beschränke das API-Token auf den einen Bucket, den Aktar nutzt. Sollte das Token je in falsche Hände geraten, ist sonst nichts betroffen.
  • Eine eigene Domain wird von Cloudflare gecacht, sodass beliebte Links weltweit schnell laden, ohne Zusatzkosten.
  • Lieber aufgeräumte Ordner? Ändere den Objektpfad, zum Beispiel in shots/{date}/{filename}-{random}.{ext}. Siehe Dateinamen und Ordner.

Fehlerbehebung

Der Link liefert Access Denied oder 403

Stell sicher, dass die Public Base URL deine eigene Domain oder die r2.dev-URL ist. Der Endpunkt …r2.cloudflarestorage.com ist nur für die API gedacht und liefert nie öffentliche Dateien aus. Mehr dazu unter Access-Denied-Fehler.

Test Connection meldet ungültige Zugangsdaten

Verwende Access Key ID und Secret Access Key aus dem R2-API-Token, nicht ein normales Cloudflare-API-Token oder deinen Global API Key. Prüfe, ob die Account ID keine zusätzlichen Leerzeichen enthält.

Uploads funktionieren, aber Links sind langsam oder gedrosselt

Wahrscheinlich nutzt du die r2.dev-Entwicklungs-URL. Verbinde für den Produktivbetrieb eine eigene Domain.

Kommst du nicht weiter?Schau in die FAQ oder frag auf GitHub.