Monter MinIO sur macOS avec NetDrive

Votre équipe a monté un cluster MinIO sur bare-metal le trimestre dernier. Les ingénieurs DevOps sont à l’aise avec le CLI mc et le SDK S3. Les designers et les chefs de projet ne le sont pas—ils ont simplement besoin d’ouvrir des fichiers PSD du bucket assets sans passer par un ticket IT. NetDrive fait apparaître les buckets MinIO directement dans le Finder macOS, si bien que le bucket ressemble à une clé USB et ne gêne personne.

Parcourez vos buckets MinIO dans le Finder—sans CLI

Avec NetDrive, Google Drive, OneDrive, S3, SFTP, WebDAV et plus apparaissent comme des lecteurs natifs sur Windows et macOS — sans synchronisation ni téléchargement complet.

• Fonctionne avec toute instance MinIO : VM locale, bare-metal ou hébergée dans le cloud
• Natif Apple Silicon depuis NetDrive 3.14—aucune surcharge Rosetta
• Les téléversements asynchrones gardent votre application réactive pendant les transferts en arrière-plan

WindowsmacOS

Télécharger NetDrive pour macOS →

Essai gratuit. Licences à vie et abonnements disponibles.

Ce dont vous avez besoin avant de vous connecter

MinIO expose une API compatible S3, donc NetDrive y accède via le fournisseur Amazon S3 avec un point de terminaison personnalisé. Rassemblez les éléments suivants avant d’ouvrir NetDrive :

• Clé d’accès et clé secrète — depuis la console MinIO sous Identity → Service Accounts, ou fournies par votre administrateur MinIO.
• URL du point de terminaison — l’URL de base du port de l’API MinIO. Pour un serveur local : http://192.168.1.50:9000. Pour un déploiement avec terminaison TLS : https://minio.example.com.
• Nom du bucket — visible dans l’onglet Buckets de la console MinIO.
• Région — sauf si votre instance MinIO est configurée avec une région personnalisée, utilisez us-east-1. MinIO ignore cette valeur, mais les clients S3 doivent l’envoyer.

NetDrive 3.18 et versions ultérieures nécessite macOS 14 (Sonoma) ou supérieur. Les Mac Apple Silicon exécutent NetDrive nativement depuis la version 3.14.309—aucune couche de compatibilité impliquée.

Connecter NetDrive à MinIO

Cliquez sur l’icône NetDrive dans la barre de menus (l’icône en forme de nuage en haut de votre écran) et sélectionnez Open Drive Manager :

1. Cliquez sur + pour ajouter un nouveau lecteur.
2. Sélectionnez Amazon S3 dans la liste des fournisseurs — MinIO utilise la même API.
3. Dans le champ Endpoint, saisissez l’URL de base de votre serveur MinIO : http://192.168.1.50:9000 ou https://minio.example.com. N’incluez pas le nom du bucket ici.
4. Collez votre Access Key et votre Secret Key MinIO dans les champs correspondants.
5. Réglez Region sur us-east-1 (ou votre région configurée si vous en avez explicitement défini une dans MinIO).
6. Cliquez sur Connect. NetDrive contacte votre serveur MinIO et récupère la liste des buckets.
7. Sélectionnez le bucket à monter et cliquez sur OK.
8. Donnez un nom au lecteur — MinIO Assets, par exemple — et réglez Auto Mount sur At Login pour un accès persistant.
9. Cliquez sur Mount.

Le bucket apparaît dans la barre latérale du Finder sous Locations, aux côtés de vos partages AirDrop ou réseau. Glissez-déposez des fichiers, ouvrez-les d’un double-clic, et le Finder se charge du reste.

TLS et adressage path-style

Deux détails de configuration piègent la plupart des déploiements MinIO :

Certificats auto-signés. Si votre serveur MinIO utilise un certificat que macOS ne reconnaît pas (fréquent dans les déploiements homelab et internes), les connexions échouent avec une erreur de handshake TLS. La solution la plus propre consiste à ajouter votre CA interne au trousseau macOS : ouvrez Keychain Access, choisissez File → Import Items, puis importez le certificat CA. Marquez-le comme Always Trust. Autre option, basculez en HTTP pour le trafic purement local en saisissant http:// dans le champ endpoint.

Adressage path-style des buckets. MinIO utilise par défaut l’adressage path-style (http://server:9000/bucket-name) plutôt que le style virtual-hosted (http://bucket-name.server:9000). Le fournisseur compatible S3 de NetDrive utilise également le path-style par défaut, si bien que les deux s’alignent sans configuration supplémentaire. Si votre déploiement MinIO est configuré pour le style virtual-hosted, assurez-vous d’avoir un wildcard DNS correspondant à *.minio.example.com et mettez à jour le endpoint en conséquence.

Fichiers volumineux et téléversements multipart

Pour les buckets contenant des objets volumineux—snapshots de VM, dumps de base de données, vidéo non compressée—deux réglages améliorent la fiabilité :

Mode de téléversement asynchrone. Faites un clic droit sur le lecteur MinIO dans Drive Manager et choisissez Properties → Upload Mode → Async. Votre application reçoit immédiatement un accusé d’écriture réussi, et NetDrive met en file d’attente le téléversement réel vers MinIO en arrière-plan. L’icône de la barre de menus affiche la progression en direct, et vous pouvez annuler des transferts individuels sans interrompre les autres téléversements en cours.

Seuil multipart. NetDrive utilise les téléversements S3 multipart pour les objets de plus de 5 Go, introduits dans la version 3.5.434. Un snapshot de base de données de 20 Go se téléverse en blocs parallèles plutôt qu’en un seul flux série, ce qui est plus résilient sur les liens VPN ou WAN qui relient généralement les serveurs MinIO distants.

Pour conclure

L’API compatible S3 de MinIO en fait une cible immédiate pour tout outil compatible S3—y compris NetDrive. Une fois monté, le bucket se comporte comme n’importe quel dossier : les aperçus Finder fonctionnent, Spotlight peut indexer les noms de fichiers, et aucune application n’a besoin de savoir que le stockage réside sur un serveur distinct.

Le même chemin via le fournisseur S3 fonctionne pour d’autres services compatibles S3. Voir Mount Wasabi on macOS pour les différences d’endpoint, et Mount Amazon S3 on macOS si votre équipe combine MinIO avec l’offre AWS hébergée.

— Steve, NetDrive