Monter MinIO sur Windows — Guide NetDrive compatible S3

5 min de lecture provider-guide minio windows
Steve
SteveSenior Engineer
Guide pour monter un bucket MinIO comme lecteur Windows avec NetDrive. Parcourez votre stockage S3 privé depuis l'Explorateur Windows.

Vous avez déployé un cluster MinIO pour les artefacts de build de votre équipe — deux téraoctets de fixtures de test, de caches de couches Docker et d’exports nocturnes sur du matériel que vous contrôlez. Vous voulez maintenant que chaque développeur Windows ouvre une lettre de lecteur familière et glisse-dépose des fichiers directement dans l’Explorateur, sans installer le client MinIO ni tout envelopper dans des scripts. NetDrive gère cela proprement : il se connecte à l’API compatible S3 de MinIO et présente le bucket comme un lecteur natif en quelques secondes.

NetDrive drive manager showing Google Drive, S3 and pCloud mounted as drive lettersMounted clouds appearing as native drives in Windows File Explorer

Monter MinIO comme lecteur Windows

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.

  • Connexion compatible S3 — fonctionne avec tout endpoint MinIO
  • Parcourez buckets et objets directement dans l'Explorateur Windows
  • Téléversements en arrière-plan avec suivi de progression en temps réel
WindowsmacOS
Télécharger NetDrive →

Essai gratuit. Licences à vie et abonnements disponibles.

Ce dont vous avez besoin avant de commencer

Rassemblez ces éléments avant d’ouvrir NetDrive :

  • URL de l’endpoint MinIO — typiquement http://your-server:9000 pour une instance locale ou LAN, ou https://minio.yourdomain.com pour un serveur derrière un reverse proxy. Le port API par défaut de MinIO est 9000 ; la console tourne sur 9001 et ce n’est pas à cela que NetDrive se connecte.
  • Access Key et Secret Key — créez un compte de service dans la MinIO Console sous Identity → Service Accounts, ou générez-en un avec mc admin user svcacct add. Utilisez un compte de service plutôt que vos identifiants root ; limitez-le au bucket spécifique pour un accès au moindre privilège.
  • Nom du bucket — NetDrive se connecte au niveau du bucket. Pour exposer plusieurs buckets, ajoutez un lecteur distinct pour chacun dans NetDrive.
  • NetDrive installé sur Windows 8, 8.1, 10 ou 11. Téléchargez l’installeur ici.

Les versions récentes de MinIO utilisent par défaut l’adressage de type path-style, le mode que NetDrive utilise pour les fournisseurs compatibles S3. Si votre version de MinIO est antérieure à RELEASE.2022-10-08, vérifiez que l’accès path-style n’est pas explicitement désactivé dans votre configuration MinIO (MINIO_API_REQUESTS_MAX et paramètres virtual-hosted).

Connecter NetDrive à MinIO sur Windows

Ouvrez NetDrive et cliquez sur le bouton + dans le Drive Manager pour ajouter un nouveau lecteur. Dans la liste des fournisseurs, sélectionnez Amazon S3 — MinIO parle l’API S3, c’est donc l’entrée correcte pour tout stockage compatible S3, y compris MinIO, Wasabi et d’autres solutions auto-hébergées.

Remplissez les champs de connexion :

  • Access Key ID : votre clé d’accès MinIO
  • Secret Access Key : votre clé secrète MinIO
  • Region : saisissez us-east-1 — MinIO ignore cette valeur mais le champ doit être non vide
  • Endpoint : votre URL d’API MinIO, par ex. http://192.168.1.50:9000 ou https://minio.example.com
  • Bucket : le bucket spécifique à monter, par ex. build-artifacts

Activez Path style (parfois nommé Force path style selon votre version de NetDrive). Les URL de type virtual-hosted comme bucket.minio.example.com nécessitent des entrées DNS qui n’existent généralement pas sur un MinIO auto-hébergé. Le path style — où le bucket apparaît comme composant de chemin, par ex. minio.example.com/bucket — est ce qu’il vous faut ici.

Cliquez sur Test pour vérifier la connectivité. Une coche verte confirme que NetDrive peut joindre MinIO et s’authentifier. Si le test échoue, les causes les plus fréquentes sont un pare-feu bloquant le port 9000, un endpoint HTTPS avec un certificat auto-signé, ou une clé d’accès sans permission s3:ListBucket sur le bucket cible.

Drive Manager de NetDrive montrant plusieurs lecteurs cloud, dont du stockage compatible S3 monté sur Windows

Attribuer une lettre de lecteur et le montage automatique

Une fois le test de connexion réussi, allez à la section Mount :

  1. Drive letter — choisissez une lettre libre. Pour des postes partagés, une convention d’équipe comme M: (pour MinIO) garde les choses cohérentes entre machines.
  2. Mount typeNetwork drive pour un accès complet en lecture-écriture, ou Read-only drive si ce bucket contient des jeux de données de référence qui ne doivent pas être modifiés depuis les postes de travail.
  3. Options d’Auto-mount :
    • On login — le lecteur apparaît après la connexion de l’utilisateur à Windows. Idéal pour les postes de développement.
    • On boot — le lecteur se monte avant la connexion, utile pour les tâches planifiées ou services tournant sous un compte système qui doivent lire depuis MinIO au démarrage.
    • Disabled — montage manuel depuis le Drive Manager. Utile pour les buckets rarement consultés.

Cliquez sur le bouton Mount (lecture). En quelques secondes, l’Explorateur Windows affiche la nouvelle lettre de lecteur. Naviguez-y et vous verrez les dossiers et objets de premier niveau de votre bucket MinIO comme s’ils étaient locaux.

Contenu d'un bucket MinIO visible comme lettre de lecteur montée dans l'Explorateur Windows

Travailler avec les fichiers dans l’Explorateur Windows

Le glisser-déposer fonctionne exactement comme attendu. NetDrive met les transferts en file d’attente en arrière-plan et affiche la progression via l’icône de la barre système. Pour les objets de plus de 5 Go, NetDrive bascule automatiquement en upload multipart S3 — aucune configuration nécessaire pour les gros lots d’artefacts ou fichiers de données.

Si un autre processus écrit dans le bucket pendant que vous le parcourez — un pipeline CI qui pousse de nouvelles fixtures de test, par exemple — le listing du lecteur peut ne pas se mettre à jour immédiatement. Faites un clic droit sur le lecteur monté dans l’Explorateur et choisissez Force folder refresh dans le menu contextuel de NetDrive pour récupérer le dernier listing du répertoire.

Pour un accès scripté ou depuis un runner CI, l’outil CLI nd3cmd (disponible depuis NetDrive 3.8.921) permet de monter et démonter des lecteurs en ligne de commande, utile pour automatiser la connexion depuis un script de build plutôt que via l’interface graphique.

Progression d'un upload en arrière-plan montrant plusieurs fichiers transférés vers le stockage MinIO

Pour conclure

Connecter MinIO à NetDrive sur Windows prend trois à cinq minutes une fois les identifiants en main. La même méthode de connexion compatible S3 fonctionne pour d’autres stockages compatibles S3 auto-hébergés ou managés — Wasabi, Backblaze B2 et d’autres — le schéma de configuration s’applique donc à toute votre flotte de stockage. Pour l’équivalent macOS, voir Monter MinIO sur macOS avec NetDrive. Pour AWS S3 proprement dit, Monter Amazon S3 sur Windows avec NetDrive couvre la sélection de région et la configuration des identifiants IAM.

— Steve, NetDrive