Gestionnaire de fichiers pour MinIO et S3 auto-hébergé : connectez-le à Nubbo

Nubbo se connecte à tout stockage compatible S3 qui signe avec Signature V4, comme MinIO, Ceph ou SeaweedFS, sur votre propre serveur ou chez un autre fournisseur. Il vous suffit de l’URL de l’endpoint, d’une clé et de la région. 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 votre serveur. 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 stockage compatible S3 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. L’endpoint doit être une URL publique accessible à la fois par les serveurs de Nubbo et par le navigateur, et il doit être en HTTPS, car le navigateur ne charge pas de contenu HTTP depuis https://nubbo.app. Nubbo refuse les endpoints qui pointent vers des adresses privées ou locales. Si votre serveur n’a pas de régions, laissez us-east-1.

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.

Connexion automatique

Étape 1 : créez la clé sur votre serveur

1. Vérifiez que votre serveur expose l’API S3 avec des signatures V4 sur une URL HTTPS publique, par exemple https://s3.your-domain.com.
2. Créez une clé capable de créer des buckets et de modifier leur CORS.
3. Notez l’URL de l’endpoint et la région. Si votre serveur n’a pas de régions, utilisez us-east-1.

Étape 2 : connectez le bucket dans Nubbo

1. Dans Nubbo, ouvrez Buckets et appuyez sur Connecter un bucket. Choisissez S3 personnalisé / auto-hébergé et appuyez sur Continuer.

   

2. Choisissez Automatique et appuyez sur Continuer.

   

3. À l’étape Votre clé, collez la clé d’accès, la clé secrète, l’URL de l’endpoint et la région. Appuyez sur Vérifier la clé. Nubbo vérifie que la clé fonctionne et qu’elle a accès à tout le compte.

   

4. 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.

   

5. 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é sur votre serveur

1. Créez le bucket sur votre serveur (sur MinIO, par exemple, avec mc mb).
2. Créez une clé avec des permissions de lecture et d’écriture sur ce bucket.
3. Notez l’URL de l’endpoint et la région.

Étape 2 : connectez le bucket dans Nubbo

1. Dans Buckets, appuyez sur Connecter un bucket, choisissez S3 personnalisé / auto-hébergé puis Avec une clé limitée.
2. Collez la clé d’accès, la clé secrète, l’endpoint et la région. Appuyez sur Vérifier la clé.
3. Saisissez le nom exact du bucket et appuyez sur Vérifier l’accès.
4. 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.

La configuration de CORS dépend du logiciel :

• MinIO (community edition) n’accepte pas le CORS par bucket : il utilise un réglage global (MINIO_API_CORS_ALLOW_ORIGIN) qui autorise par défaut n’importe quelle origine. Si vous ne l’avez pas modifié, il n’y a rien à faire : appuyez sur Je l’ai ajoutée, vérifier et la vérification passera. Si vous l’avez modifié, incluez https://nubbo.app.
• Ceph et SeaweedFS acceptent le CORS par bucket via l’API S3. Appliquez cette règle avec votre outil habituel (par exemple aws s3api put-bucket-cors avec votre endpoint), ou laissez Nubbo s’en charger avec la voie automatique.

[
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
    "AllowedOrigins": ["https://nubbo.app"],
    "ExposeHeaders": ["ETag"],
    "MaxAgeSeconds": 3600
  }
]

Une fois la règle en place, revenez dans Nubbo et appuyez sur Je l’ai ajoutée, vérifier. Sur Ceph et SeaweedFS, si votre clé peut modifier CORS, Essayer de le configurer pour moi s’en charge pour vous.

En cas de problème

Combien ça coûte

Si vous hésitez entre votre propre stockage et un fournisseur, comparez les prix et les limites dans S3, R2, Spaces, Wasabi et Backblaze B2 comparés.