Nubbo se connecte à Cloudflare R2 avec un jeton API R2 et l’Account ID de votre compte. En quelques minutes, vos buckets se retrouvent dans un explorateur de fichiers avec envois directs, liens de partage et galeries. Ce guide suit l’assistant de Nubbo pas à pas, avec les deux voies : automatique ou avec une clé limitée à un seul bucket.
Ce que vous obtenez
- Parcourez le bucket comme un disque : dossiers, vues, recherche, corbeille, labels et favoris.
- Envoyez et téléchargez des fichiers directement entre votre navigateur et Cloudflare R2. Les fichiers ne passent jamais par les serveurs de Nubbo.
- Partagez fichiers et dossiers avec mot de passe, expiration et limite de téléchargements, recevez des fichiers dans votre bucket et créez des galeries.
- Vos clés sont stockées chiffrées en AES-256-GCM et vous pouvez déconnecter le bucket à tout moment.
Avant de commencer
Il vous faut un compte Cloudflare R2 et un compte Nubbo. Chaque bucket connecté compte dans la limite de votre forfait : Gratuit en permet 2, Personal 5 et Pro n’a pas de limite. Avant votre premier bucket, Cloudflare vous demande d’activer l’abonnement R2 depuis le tableau de bord. Si votre bucket a une juridiction (EU, FedRAMP ou US), vous la choisissez dans l’assistant et Nubbo utilise l’endpoint de cette juridiction.
Choisissez comment vous connecter
L’assistant de Nubbo propose deux voies. Les deux aboutissent au même résultat : le bucket connecté et prêt pour les envois depuis le navigateur.
| Automatique | Avec une clé limitée | |
|---|---|---|
| Clé | Accès à tout le compte | Limitée à un seul bucket |
| Bucket | Nubbo utilise l’un des vôtres ou en crée un nouveau | Vous le créez d’abord |
| CORS | Nubbo ajoute la règle pour vous | Vous ajoutez la règle |
| Quand la choisir | La voie la plus rapide | Quand vous ne voulez pas donner accès à tout le compte |
La clé limitée est l’accès minimal dont Nubbo a besoin : Object Read & Write sur un bucket. Avec elle, Nubbo ne peut ni lister vos buckets ni en créer un, vous saisissez donc le nom du bucket et ajoutez vous-même la règle CORS.
Connexion automatique
Étape 1 : créez la clé dans Cloudflare R2
- Connectez-vous à dash.cloudflare.com et ouvrez R2 object storage. Le tableau de bord peut afficher les menus dans votre langue.
- Ouvrez API Tokens et appuyez sur Create Account API token. Vous y accédez aussi depuis Overview, sous Account Details, Manage.
- Choisissez la permission Admin Read & Write et créez le jeton.
- Copiez l’Access Key ID et la Secret Access Key. Cloudflare n’affiche la clé secrète qu’une seule fois. Utilisez ces deux clés, pas la valeur du jeton.
- Copiez aussi votre Account ID, affiché sur la page Overview de R2.
Étape 2 : connectez le bucket dans Nubbo
Dans Nubbo, ouvrez Buckets et appuyez sur Connecter un bucket. Choisissez Cloudflare R2 et appuyez sur Continuer.

Choisissez Automatique et appuyez sur Continuer.

À l’étape Votre clé, collez l’Access Key ID, la Secret Access Key et l’Account ID. Nubbo construit l’endpoint de votre compte à partir de l’Account ID. La région de R2 est toujours
auto. Avant d’appuyer sur Vérifier la clé, choisissez la Juridiction de votre bucket : Par défaut (sans juridiction) pour la plupart des buckets, ou EU, FedRAMP ou US. L’endpoint change avec elle (https://<ACCOUNT_ID>.eu.r2.cloudflarestorage.compour l’UE) et la liste n’affiche que les buckets de cette juridiction. Appuyez sur Vérifier la clé. Nubbo vérifie que la clé fonctionne et qu’elle a accès à tout le compte.

Choisissez l’un de vos buckets et appuyez sur Utiliser ce bucket, ou sélectionnez En créer un nouveau, saisissez un nom (et choisissez la région, si elle est demandée) et appuyez sur Créer et préparer. Nubbo ajoute au bucket une règle CORS qui n’autorise les envois et téléchargements que depuis l’app, et conserve les règles existantes.

Passez en revue les trois vérifications, modifiez le Nom dans Nubbo si vous le souhaitez et appuyez sur Terminer. Le bucket apparaît dans Buckets et vous pouvez l’ouvrir dans l’explorateur.

Si Nubbo ne peut pas ajouter la règle CORS avec votre clé, l’assistant vous amène à l’étape CORS. Suivez alors la section Ajoutez la règle CORS.
Connexion avec une clé limitée
Étape 1 : préparez le bucket et la clé dans Cloudflare R2
- Dans R2, Overview, appuyez sur Create bucket et donnez-lui un nom (lettres minuscules, chiffres et tirets). Il n’y a pas de région à choisir. Si les données doivent rester dans l’UE, choisissez la juridiction EU : l’endpoint change avec elle.
- Ouvrez API Tokens et appuyez sur Create Account API token.
- Choisissez la permission Object Read & Write et limitez-la à votre bucket.
- Copiez l’Access Key ID, la Secret Access Key et votre Account ID.
Étape 2 : connectez le bucket dans Nubbo
- Dans Buckets, appuyez sur Connecter un bucket, choisissez Cloudflare R2 puis Avec une clé limitée.
- Collez l’Access Key ID, la Secret Access Key et l’Account ID. Avant d’appuyer sur Vérifier la clé, choisissez la même Juridiction que le bucket. Appuyez sur Vérifier la clé.
- Saisissez le nom exact du bucket et appuyez sur Vérifier l’accès.
- L’assistant passe à l’étape CORS avec la règle à ajouter.
Ajoutez la règle CORS
La règle CORS permet au navigateur d’envoyer et de télécharger des fichiers de votre bucket sur https://nubbo.app. C’est la même règle que l’assistant affiche à l’étape CORS.
- Dans R2, ouvrez le bucket et allez dans Settings.
- Sous CORS Policy, appuyez sur Add CORS policy et choisissez l’onglet JSON.
- Collez la règle et appuyez sur Save. Cloudflare peut mettre jusqu’à 30 secondes à l’appliquer.
[
{
"AllowedHeaders": ["*"],
"AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
"AllowedOrigins": ["https://nubbo.app"],
"ExposeHeaders": ["ETag"],
"MaxAgeSeconds": 3600
}
]

Une fois la règle enregistrée, revenez dans Nubbo et appuyez sur Je l’ai ajoutée, vérifier. Si votre clé a le droit de modifier CORS, Essayer de le configurer pour moi s’en charge pour vous.
En cas de problème
| Message dans Nubbo | Que faire |
|---|---|
| « Cette clé semble limitée à un seul bucket. Vous pouvez continuer avec la voie limitée ou créer une clé avec un accès complet. » | Appuyez sur Continuer avec une clé limitée, ou créez une clé avec accès à tout le compte et appuyez sur Essayer une autre clé. |
| « Votre clé n’a pas l’autorisation de créer des buckets. » | Utilisez une clé avec un accès complet, ou créez le bucket dans votre panneau et appuyez sur Je l’ai créé dans mon panneau. |
| « Ce nom est déjà utilisé chez ce fournisseur ; essayez-en un autre. » | Les noms de bucket sont uniques chez tout le fournisseur : choisissez-en un autre. |
| « Votre clé n’a pas l’autorisation de le configurer. » | Ajoutez la règle CORS à la main, comme expliqué plus haut. |
| « Cela ne fonctionne pas encore. Vérifiez la règle et réessayez ; certains fournisseurs mettent une minute à l’appliquer. » | Vérifiez que l’origine est exactement https://nubbo.app, sans barre oblique finale, attendez une minute et vérifiez de nouveau. |
| « Ce bucket est déjà utilisé. » | Ce bucket est déjà connecté dans Nubbo, dans votre compte ou dans un autre. |
| « Identifiants invalides. Vérifiez la clé d’accès et la clé d’accès secrète. » | Vérifiez que vous avez collé l’Access Key ID et la Secret Access Key du jeton, et non la valeur du jeton API Cloudflare. |
| « Bucket introuvable. Vérifiez le nom et la région. » | Vérifiez le nom et que la juridiction dans Nubbo est celle du bucket (R2 l’affiche dans les Settings du bucket). |
Combien ça coûte
R2 ne facture pas le trafic sortant et propose une offre gratuite mensuelle. Nous l’expliquons dans L’offre gratuite de Cloudflare R2.
Questions fréquentes
Où trouver mon Account ID Cloudflare ?
Sur la page Overview de R2, sous Account Details. C'est une chaîne de 32 caractères composée de chiffres et des lettres a à f.
De quelle permission le jeton R2 a-t-il besoin ?
L'accès minimal dont Nubbo a besoin est Object Read & Write limité à votre bucket, avec le parcours à clé limitée : vous saisissez le nom du bucket et ajoutez vous-même la règle CORS. Le parcours automatique demande Admin Read & Write, qui permet à Nubbo de lister vos buckets, d'en créer un et de configurer son CORS.
Quelle région utiliser avec R2 ?
Aucune : R2 utilise la région auto et Nubbo la règle pour vous. Les indications d'emplacement (location hints) de Cloudflare ne changent rien à la connexion du bucket.
Puis-je connecter un bucket R2 avec une juridiction, comme celle de l'UE ?
Oui. À l'étape Votre clé, choisissez la juridiction du bucket (EU, FedRAMP ou US). Chacune a son propre endpoint, comme https://<ACCOUNT_ID>.eu.r2.cloudflarestorage.com, et n'affiche que les buckets créés dans celle-ci.
Les téléchargements depuis Nubbo coûtent-ils du trafic sortant sur R2 ?
Non. R2 ne facture pas le transfert de données sortant. Les téléchargements comptent en revanche comme des opérations de lecture.
Sources
Les prix et les limites proviennent des pages officielles ci-dessous. Les fournisseurs les modifient, alors vérifiez avant de vous engager.