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
Créer un bucket
Dans le tableau de bord Cloudflare, ouvrez R2 Object Storage et cliquez sur Create bucket. Choisissez un nom court comme
screenshotset gardez l'emplacement automatique. - 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
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
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
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.
| Champ | Exemple de valeur |
|---|---|
| Provider | Cloudflare R2 |
| Profile Name | PersonalLe nom de votre choix. |
| Account ID | 3f9a71c0e2b8…Sur la page d'aperçu R2. |
| Region | autoGardez la valeur par défaut. |
| Access Key ID | a1b2c3d4…Issue du jeton d'API R2. |
| Secret Access Key | ••••••••Stockée dans le trousseau macOS. |
| Bucket | screenshots |
| Public Base URL | files.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.