Montar MinIO en macOS: accede a almacenamiento S3 autoalojado con NetDrive

5 min de lectura provider-guide minio macos
Steve
SteveSenior Engineer
Cómo montar un bucket de MinIO como unidad de macOS con NetDrive. Funciona en macOS 14 Sonoma y posterior, incluido Apple Silicon. Sin CLI tras la configuración.

Tu equipo levantó un clúster de MinIO en bare-metal el trimestre pasado. Los ingenieros de DevOps se manejan bien con la CLI mc y el SDK de S3. Los diseñadores y los gestores de proyecto no—solo necesitan abrir archivos PSD del bucket assets sin tener que abrir un ticket a IT. NetDrive mapea los buckets de MinIO directamente al Finder de macOS, de modo que el bucket se ve como una unidad USB y no molesta a nadie.

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

Explora buckets de MinIO en Finder, sin necesidad de CLI

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.

  • Funciona con cualquier instancia de MinIO: VM local, bare-metal o alojada en la nube
  • Nativo en Apple Silicon desde NetDrive 3.14, sin sobrecarga de Rosetta
  • Las subidas asíncronas mantienen tu aplicación fluida mientras las transferencias se ejecutan en segundo plano
WindowsmacOS
Descargar NetDrive para macOS →

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

Qué necesitas antes de conectarte

MinIO expone una API compatible con S3, por lo que NetDrive accede a través del proveedor Amazon S3 con un endpoint personalizado. Reúne lo siguiente antes de abrir NetDrive:

  • Access Key y Secret Key — desde la consola de MinIO en Identity → Service Accounts, o proporcionadas por tu administrador de MinIO.
  • URL del endpoint — la URL base del puerto de la API de MinIO. Para un servidor local: http://192.168.1.50:9000. Para un despliegue con terminación TLS: https://minio.example.com.
  • Nombre del bucket — visible en la pestaña Buckets de la consola de MinIO.
  • Región — salvo que tu instancia de MinIO esté configurada con una región personalizada, usa us-east-1. MinIO ignora este valor, pero los clientes S3 deben enviarlo igualmente.

NetDrive 3.18 y posterior requiere macOS 14 (Sonoma) o superior. Los Mac con Apple Silicon ejecutan NetDrive de forma nativa desde la versión 3.14.309, sin ninguna capa de compatibilidad de por medio.

NetDrive drive manager on macOS showing multiple S3-compatible providers configured

Conectar NetDrive a MinIO

Haz clic en el icono de NetDrive en la barra de menú (el icono de nube en la parte superior de la pantalla) y selecciona Open Drive Manager:

  1. Haz clic en + para añadir una nueva unidad.
  2. Selecciona Amazon S3 de la lista de proveedores — MinIO usa la misma API.
  3. En el campo Endpoint, introduce la URL base de tu servidor MinIO: http://192.168.1.50:9000 o https://minio.example.com. No incluyas aquí el nombre del bucket.
  4. Pega tu Access Key y Secret Key de MinIO en los campos correspondientes.
  5. Ajusta Region a us-east-1 (o la región configurada si has definido una explícitamente en MinIO).
  6. Haz clic en Connect. NetDrive contacta con tu servidor MinIO y recupera la lista de buckets.
  7. Selecciona el bucket que quieres montar y haz clic en OK.
  8. Dale un nombre a la unidad — por ejemplo, MinIO Assets — y ajusta Auto Mount a At Login para acceso persistente.
  9. Haz clic en Mount.

El bucket aparece en la barra lateral del Finder bajo Locations, junto a cualquier recurso compartido de AirDrop o de red. Arrastra archivos, ábrelos con doble clic, y el Finder se encarga del resto.

TLS y direccionamiento de estilo path

Hay dos detalles de configuración que suelen complicar la mayoría de los despliegues de MinIO:

Certificados autofirmados. Si tu servidor MinIO usa un certificado que macOS no reconoce (algo habitual en despliegues de homelab e internos), las conexiones fallan con un error de negociación TLS. La solución más limpia es añadir tu CA interna al Keychain de macOS: abre Keychain Access, elige File → Import Items e importa el certificado de la CA. Márcalo como Always Trust. Alternativamente, cambia a HTTP para tráfico puramente local introduciendo http:// en el campo del endpoint.

Direccionamiento de bucket estilo path. MinIO usa por defecto el direccionamiento estilo path (http://server:9000/bucket-name) en lugar del estilo virtual-hosted (http://bucket-name.server:9000). El proveedor compatible con S3 de NetDrive también usa el estilo path por defecto, así que ambos coinciden sin configuración adicional. Si tu despliegue de MinIO está configurado para estilo virtual-hosted, asegúrate de tener un comodín DNS que coincida con *.minio.example.com y actualiza el endpoint en consecuencia.

MinIO bucket appearing as a local drive in macOS Finder

Archivos grandes y subidas multipart

Para buckets que contienen objetos grandes—instantáneas de VM, volcados de bases de datos, vídeo sin comprimir—dos ajustes mejoran la fiabilidad:

Modo de subida asíncrono. Haz clic derecho en la unidad de MinIO en Drive Manager y elige Properties → Upload Mode → Async. Tu aplicación recibe de inmediato una confirmación de escritura exitosa, y NetDrive encola la subida real a MinIO en segundo plano. El icono de la barra de menú muestra el progreso en vivo, y puedes cancelar transferencias individuales sin interrumpir otras subidas en curso.

Umbral multipart. NetDrive usa subidas multipart de S3 para objetos mayores de 5 GB, función introducida en la versión 3.5.434. Una instantánea de base de datos de 20 GB se sube como fragmentos en paralelo en lugar de un único flujo serial, lo cual es más resistente en los enlaces VPN o WAN que suelen conectar los servidores MinIO remotos.

Resumen

La API compatible con S3 de MinIO lo convierte en un objetivo directo para cualquier herramienta compatible con S3—incluido NetDrive. Una vez montado, el bucket se comporta como cualquier carpeta: las vistas previas del Finder funcionan, Spotlight puede indexar los nombres de archivo, y ninguna aplicación necesita saber que el almacenamiento vive en un servidor separado.

El mismo camino del proveedor S3 funciona con otros servicios compatibles con S3. Consulta Mount Wasabi on macOS para conocer las diferencias de endpoint, y Mount Amazon S3 on macOS si tu equipo combina MinIO con la oferta alojada de AWS.

— Steve, NetDrive