Environ 5 minutes

Utiliser Aktar avec Cloudflare R2

Cloudflare R2 est un excellent choix pour Aktar : aucuns frais de trafic sortant, une offre gratuite qui couvre la plupart des usages de captures d'écran, et des domaines personnalisés servis par le réseau de Cloudflare. Aktar dispose d'un préréglage R2 dédié : il vous suffit de votre Account ID, d'un jeton d'API et d'un bucket.

Ce qu'il vous faut

  • Un compte Cloudflare avec R2 activé
  • Un domaine sur Cloudflare si vous voulez des liens sur votre propre domaine (facultatif)
  • Aktar installé sur votre Mac

Pas à pas

  1. 1

    Créer un bucket

    Dans le tableau de bord Cloudflare, ouvrez R2 Object Storage et cliquez sur Create bucket. Choisissez un nom court comme screenshots et gardez l'emplacement automatique.

  2. 2

    Donner une adresse publique au bucket

    Ouvrez les Settings du bucket. Sous Custom Domains, connectez un domaine ou sous-domaine que vous gérez sur Cloudflare, par exemple files.example.com. C'est la meilleure option pour un usage réel.

    Pour un test rapide, vous pouvez plutôt activer la Public Development URL (pub-….r2.dev). Cloudflare limite le débit de cette URL et ne la recommande pas en production.

  3. 3

    Créer un jeton d'API

    De retour sur la page d'aperçu R2, ouvrez Manage API tokens et créez un jeton avec l'autorisation Object Read & Write, limité à votre bucket. Copiez l'Access Key ID et la Secret Access Key : la clé secrète n'est affichée qu'une seule fois.

    Votre Account ID figure sur la même page ; c'est aussi la première partie de l'endpoint S3 https://<ACCOUNT_ID>.r2.cloudflarestorage.com.

  4. 4

    Ajouter la destination dans Aktar

    Ouvrez Settings → Destinations → Add Destination dans Aktar, choisissez Cloudflare R2 et remplissez les champs d'après le tableau ci-dessous. Aktar déduit l'endpoint de votre Account ID.

  5. 5

    Tester et enregistrer

    Cliquez sur Test Connection. Aktar envoie un minuscule fichier de test, vérifie qu'il est accessible via votre adresse publique, puis le supprime. Quand tout est au vert, cliquez sur Save et déposez votre premier fichier sur l'icône de la barre des menus.

Réglages dans Aktar

Saisissez ces valeurs dans Settings → Destinations → Add Destination. Les noms des champs correspondent à ceux de l'app.

ChampExemple de valeur
ProviderCloudflare R2
Profile NamePersonalLe nom de votre choix.
Account ID3f9a71c0e2b8…Sur la page d'aperçu R2.
RegionautoGardez la valeur par défaut.
Access Key IDa1b2c3d4…Issue du jeton d'API R2.
Secret Access Key••••••••Stockée dans le trousseau macOS.
Bucketscreenshots
Public Base URLfiles.example.comVotre domaine personnalisé ou l'URL r2.dev.
Object Path{year}/{month}/{uuid}.{ext}Facultatif, voir noms de fichiers et dossiers.

Astuces

  • Limitez le jeton d'API au seul bucket utilisé par Aktar. Si le jeton fuite un jour, rien d'autre n'est exposé.
  • Un domaine personnalisé est mis en cache par Cloudflare : les liens populaires se chargent vite partout dans le monde, sans surcoût.
  • Envie de dossiers bien rangés ? Modifiez le chemin d'objet, par exemple en shots/{date}/{filename}-{random}.{ext}. Voir noms de fichiers et dossiers.

Dépannage

Le lien renvoie Access Denied ou 403

Vérifiez que la Public Base URL est bien votre domaine personnalisé ou l'URL r2.dev. L'endpoint …r2.cloudflarestorage.com sert uniquement à l'API et ne diffuse jamais de fichiers publics. Plus de détails dans erreurs Access Denied.

Test Connection indique que les identifiants sont invalides

Utilisez l'Access Key ID et la Secret Access Key du jeton d'API R2, et non un jeton d'API Cloudflare classique ni votre Global API Key. Vérifiez que l'Account ID ne contient pas d'espaces en trop.

Les envois fonctionnent, mais les liens sont lents ou limités en débit

Vous utilisez probablement l'URL de développement r2.dev. Connectez un domaine personnalisé pour un usage en production.

Toujours bloqué ?Parcourez la FAQ ou posez votre question sur GitHub.