Montar MinIO en Windows — Guía de configuración S3 con NetDrive

Has levantado un clúster de MinIO para los artefactos de build de tu equipo — dos terabytes de fixtures de pruebas, cachés de capas Docker y exportaciones nocturnas en hardware que tú controlas. Ahora quieres que cada desarrollador de Windows abra una letra de unidad familiar y arrastre archivos directamente en el Explorador, sin instalar el cliente propio de MinIO ni envolver todo en scripts. NetDrive resuelve esto con elegancia: se conecta a la API compatible con S3 de MinIO y presenta el bucket como una unidad nativa en segundos.

Monta MinIO como unidad de Windows

NetDrive hace que Google Drive, OneDrive, S3, SFTP, WebDAV y más aparezcan como unidades nativas en Windows y macOS — sin sincronizar, sin descargas completas.

• Conexión compatible con S3 — funciona con cualquier endpoint de MinIO
• Explora buckets y objetos directamente en el Explorador de Windows
• Subidas en segundo plano con seguimiento de progreso en tiempo real

WindowsmacOS

Descargar NetDrive →

Prueba gratuita. Planes de por vida y de suscripción disponibles.

Lo que necesitas antes de empezar

Reúne esto antes de abrir NetDrive:

• URL del endpoint de MinIO — normalmente http://your-server:9000 para una instancia local o LAN, o https://minio.yourdomain.com para un servidor detrás de un proxy inverso. El puerto de API por defecto de MinIO es 9000; la consola corre en el 9001 y no es a donde se conecta NetDrive.
• Access Key y Secret Key — crea una cuenta de servicio en la Consola de MinIO en Identity → Service Accounts, o genera una con mc admin user svcacct add. Usa una cuenta de servicio en lugar de tus credenciales root; limítala al bucket específico para un acceso de mínimo privilegio.
• Nombre del bucket — NetDrive se conecta a nivel de bucket. Si quieres exponer varios buckets, agregas una unidad distinta para cada uno en NetDrive.
• NetDrive instalado en Windows 8, 8.1, 10 u 11. Descarga el instalador aquí.

Las versiones modernas de MinIO usan direccionamiento de estilo de ruta (path-style) por defecto, que es el modo que NetDrive usa para proveedores compatibles con S3. Si tu versión de MinIO es anterior a RELEASE.2022-10-08, verifica que el acceso de estilo de ruta no esté deshabilitado explícitamente en tu configuración de MinIO (MINIO_API_REQUESTS_MAX y ajustes de virtual-hosted).

Conectar NetDrive a MinIO en Windows

Abre NetDrive y haz clic en el botón + del Gestor de Unidades para agregar una nueva unidad. En la lista de proveedores, selecciona Amazon S3 — MinIO habla la API de S3, así que esta es la entrada correcta para todo almacenamiento compatible con S3, incluyendo MinIO, Wasabi y otras soluciones autoalojadas.

Completa los campos de conexión:

• Access Key ID: tu access key de MinIO
• Secret Access Key: tu secret key de MinIO
• Region: escribe us-east-1 — MinIO ignora este valor pero el campo no puede estar vacío
• Endpoint: la URL de la API de tu MinIO, p. ej. http://192.168.1.50:9000 o https://minio.example.com
• Bucket: el bucket específico a montar, p. ej. build-artifacts

Activa Path style (a veces etiquetado Force path style según tu versión de NetDrive). Las URL de estilo virtual-hosted como bucket.minio.example.com requieren entradas DNS que normalmente no existen en un MinIO autoalojado. El estilo de ruta — donde el bucket aparece como un componente de ruta tipo minio.example.com/bucket — es lo que quieres aquí.

Haz clic en Test para verificar la conectividad. Una marca verde confirma que NetDrive puede alcanzar MinIO y autenticarse. Si la prueba falla, las causas más comunes son un firewall bloqueando el puerto 9000, un endpoint HTTPS con certificado autofirmado, o que la access key carezca del permiso s3:ListBucket sobre el bucket objetivo.

Asignar una letra de unidad y montaje automático

Una vez que la prueba de conexión pase, desplázate a la sección Mount:

1. Drive letter — elige una letra libre. Para estaciones de trabajo compartidas, una convención de equipo como M: (de MinIO) mantiene la consistencia entre máquinas.
2. Mount type — Network drive para acceso completo de lectura/escritura, o Read-only drive si este bucket contiene conjuntos de datos de referencia que no deben modificarse desde las estaciones de trabajo.
3. Opciones de Auto-mount:
   • On login — la unidad aparece tras iniciar sesión en Windows. Ideal para estaciones de desarrollo.
   • On boot — la unidad se monta antes del inicio de sesión, útil para tareas programadas o servicios que corren bajo una cuenta de sistema y necesitan leer de MinIO al arrancar.
   • Disabled — monta manualmente desde el Gestor de Unidades. Útil para buckets de acceso poco frecuente.

Haz clic en el botón Mount (reproducir). En pocos segundos, el Explorador de Windows mostrará la nueva letra de unidad. Navega a ella y verás las carpetas y objetos de nivel superior de tu bucket de MinIO como si fueran locales.

Trabajar con archivos en el Explorador de Windows

Las subidas por arrastrar y soltar funcionan exactamente como esperas. NetDrive encola las transferencias en segundo plano y reporta el progreso a través del icono de la bandeja del sistema. Para objetos mayores a 5 GB, NetDrive cambia automáticamente a subida multipart de S3 — sin necesidad de configuración para paquetes de artefactos grandes o archivos de datasets.

Si otro proceso escribe en el bucket mientras lo estás explorando — una pipeline de CI subiendo nuevos fixtures de prueba, por ejemplo — el listado de la unidad puede no actualizarse de inmediato. Haz clic derecho en la unidad montada en el Explorador y elige Force folder refresh en el menú contextual de NetDrive para obtener el listado de directorio más reciente.

Para scripting o acceso desde runners de CI, la herramienta de línea de comandos nd3cmd (disponible desde NetDrive 3.8.921) permite montar y desmontar unidades desde la línea de comandos, útil cuando necesitas automatizar la conexión desde un script de build en lugar de la interfaz gráfica.

Resumen

Conectar MinIO a NetDrive en Windows toma de tres a cinco minutos con las credenciales en mano. El mismo método de conexión compatible con S3 funciona con otros almacenes compatibles con S3, autoalojados o gestionados — Wasabi, Backblaze B2 y otros — así que el patrón de configuración escala en toda tu flota de almacenamiento. Para el equivalente en macOS, consulta Montar MinIO en macOS con NetDrive. Para Amazon S3 propiamente dicho, Montar Amazon S3 en Windows con NetDrive cubre la selección de región y la configuración de credenciales IAM.

— Steve, NetDrive