MinIO unter macOS einbinden — Self-Hosted S3-Speicher mit NetDrive

Ihr Team hat letztes Quartal einen MinIO-Cluster auf Bare-Metal-Hardware aufgesetzt. Die DevOps-Ingenieure kommen mit der mc-CLI und dem S3-SDK gut zurecht. Die Designer und Projektmanager nicht — sie wollen einfach nur PSD-Dateien aus dem assets-Bucket öffnen, ohne ein Ticket bei der IT zu eröffnen. NetDrive bindet MinIO-Buckets direkt in den macOS Finder ein, sodass der Bucket wie ein USB-Laufwerk aussieht und niemandem im Weg steht.

MinIO-Buckets im Finder durchsuchen — ohne CLI

Mit NetDrive erscheinen Google Drive, OneDrive, S3, SFTP, WebDAV und mehr als native Laufwerke unter Windows und macOS — ohne Synchronisation, ohne vollständige Downloads.

• Funktioniert mit jeder MinIO-Instanz: lokale VM, Bare-Metal oder Cloud-gehostet
• Nativ für Apple Silicon seit NetDrive 3.14 — kein Rosetta-Overhead
• Asynchrone Uploads halten Ihre App reaktionsfähig, während die Übertragung im Hintergrund läuft

WindowsmacOS

NetDrive für macOS herunterladen →

Kostenlose Testversion. Lifetime- und Abo-Pläne verfügbar.

Was Sie vor der Verbindung brauchen

MinIO stellt eine S3-kompatible API bereit, daher greift NetDrive über den Provider Amazon S3 mit einem benutzerdefinierten Endpoint darauf zu. Halten Sie Folgendes bereit, bevor Sie NetDrive öffnen:

• Access Key und Secret Key — aus der MinIO-Konsole unter Identity → Service Accounts, oder von Ihrem MinIO-Administrator.
• Endpoint-URL — die Basis-URL Ihres MinIO-API-Ports. Für einen lokalen Server: http://192.168.1.50:9000. Für ein TLS-terminiertes Deployment: https://minio.example.com.
• Bucket-Name — sichtbar im Tab Buckets der MinIO-Konsole.
• Region — sofern Ihre MinIO-Instanz nicht mit einer benutzerdefinierten Region konfiguriert ist, verwenden Sie us-east-1. MinIO ignoriert diesen Wert, aber S3-Clients müssen ihn trotzdem senden.

NetDrive 3.18 und höher setzt macOS 14 (Sonoma) oder neuer voraus. Macs mit Apple Silicon führen NetDrive seit Version 3.14.309 nativ aus — ganz ohne Kompatibilitätsschicht.

NetDrive mit MinIO verbinden

Klicken Sie auf das NetDrive-Symbol in der Menüleiste (das Cloud-Symbol oben auf Ihrem Bildschirm) und wählen Sie Open Drive Manager:

1. Klicken Sie auf +, um ein neues Laufwerk hinzuzufügen.
2. Wählen Sie Amazon S3 aus der Provider-Liste — MinIO nutzt dieselbe API.
3. Geben Sie im Feld Endpoint die Basis-URL Ihres MinIO-Servers ein: http://192.168.1.50:9000 oder https://minio.example.com. Den Bucket-Namen geben Sie hier nicht mit an.
4. Fügen Sie Ihren MinIO-Access Key und Secret Key in die entsprechenden Felder ein.
5. Setzen Sie Region auf us-east-1 (oder Ihre konfigurierte Region, falls Sie in MinIO explizit eine festgelegt haben).
6. Klicken Sie auf Connect. NetDrive kontaktiert Ihren MinIO-Server und ruft die Bucket-Liste ab.
7. Wählen Sie den zu mountenden Bucket aus und klicken Sie auf OK.
8. Geben Sie dem Laufwerk einen Namen — etwa MinIO Assets — und stellen Sie Auto Mount für dauerhaften Zugriff auf At Login.
9. Klicken Sie auf Mount.

Der Bucket erscheint in der Finder-Seitenleiste unter Locations, neben AirDrop oder Netzwerkfreigaben. Ziehen Sie Dateien hinein, öffnen Sie sie per Doppelklick — den Rest erledigt der Finder.

TLS und Path-Style-Adressierung

Zwei Konfigurationsdetails bringen die meisten MinIO-Deployments ins Straucheln:

Selbstsignierte Zertifikate. Wenn Ihr MinIO-Server ein Zertifikat verwendet, das macOS nicht kennt (üblich bei Homelab- und internen Deployments), schlägt die Verbindung mit einem TLS-Handshake-Fehler fehl. Am saubersten beheben Sie das, indem Sie Ihre interne CA im macOS-Schlüsselbund hinzufügen: Öffnen Sie Keychain Access, wählen Sie File → Import Items und importieren Sie das CA-Zertifikat. Markieren Sie es als Always Trust. Alternativ wechseln Sie für rein lokalen Traffic zu HTTP, indem Sie http:// im Endpoint-Feld eingeben.

Path-Style-Bucket-Adressierung. MinIO verwendet standardmäßig Path-Style-Adressierung (http://server:9000/bucket-name) statt Virtual-Hosted-Style (http://bucket-name.server:9000). Auch NetDrives S3-kompatibler Provider nutzt standardmäßig Path-Style, sodass beide ohne zusätzliche Konfiguration zusammenpassen. Ist Ihr MinIO-Deployment auf Virtual-Hosted-Style konfiguriert, stellen Sie sicher, dass ein DNS-Wildcard für *.minio.example.com existiert, und passen Sie den Endpoint entsprechend an.

Große Dateien und Multipart-Uploads

Für Buckets mit großen Objekten — VM-Snapshots, Datenbank-Dumps, unkomprimiertes Video — verbessern zwei Einstellungen die Zuverlässigkeit:

Asynchroner Upload-Modus. Klicken Sie mit der rechten Maustaste im Drive Manager auf das MinIO-Laufwerk und wählen Sie Properties → Upload Mode → Async. Ihre Anwendung erhält sofort eine erfolgreiche Schreibbestätigung, während NetDrive den eigentlichen Upload zu MinIO im Hintergrund einreiht. Das Symbol in der Menüleiste zeigt den Fortschritt live an, und Sie können einzelne Übertragungen abbrechen, ohne andere laufende Uploads zu unterbrechen.

Multipart-Schwellenwert. NetDrive nutzt S3-Multipart-Uploads für Objekte über 5 GB, eingeführt in Version 3.5.434. Ein 20-GB-Datenbank-Snapshot wird als parallele Chunks statt als einzelner serieller Stream hochgeladen — das macht ihn robuster auf den VPN- oder WAN-Verbindungen, über die entfernte MinIO-Server typischerweise angebunden sind.

Fazit

Dank der S3-kompatiblen API ist MinIO ein Drop-in-Ziel für jedes S3-fähige Tool — auch für NetDrive. Einmal gemountet, verhält sich der Bucket wie jeder andere Ordner: Finder-Vorschauen funktionieren, Spotlight kann Dateinamen indexieren, und keine Anwendung muss wissen, dass der Speicher auf einem separaten Server liegt.

Derselbe S3-Provider-Weg funktioniert auch für andere S3-kompatible Dienste. Siehe Mount Wasabi on macOS für die Unterschiede beim Endpoint, und Mount Amazon S3 on macOS, falls Ihr Team MinIO mit dem gehosteten AWS-Angebot kombiniert.

— Steve, NetDrive