Garage¶
Binden Sie einen Bucket auf einem Garage-Cluster — leichtgewichtigem, selbst gehostetem S3-Speicher — als Windows-Laufwerk ein.
Bevor Sie beginnen¶
Bereiten Sie Folgendes im Voraus vor:
- Die S3-Endpunkt-URL Ihres Garage-Clusters.
- Ein Zugriffsschlüssel-ID/Geheimer Zugangsschlüssel-Paar mit Zugriff auf den Ziel-Bucket.
- Die für den Cluster konfigurierte Region (Garages Standard ist
garage).
Wo Sie die Schlüssel erhalten — auf der Maschine, die den Cluster verwaltet:
garage key create raidrive-key
garage bucket allow --read --write YOUR-BUCKET --key raidrive-key
Der erste Befehl gibt die Key ID und den Secret Key aus.
Hilfe von Garage
Verbinden¶
- Klicken Sie in der Symbolleiste auf Hinzufügen.
- Wählen Sie Enterprise → Garage.
- Geben Sie die Endpunkt-URL, die Region, die Zugriffsschlüssel-ID und den Geheimer Zugangsschlüssel ein, klicken Sie dann auf die Schaltfläche Aktualisieren neben dem Bucket-Feld.
- Wählen Sie den Bucket und klicken Sie auf Verbinden.
Manuelle Bucket-Eingabe
Darf Ihr Schlüssel keine Buckets auflisten, aktivieren Sie das Kästchen links neben dem Bucket-Feld und geben Sie den Bucket-Namen direkt ein.
Einstellungen¶
| Einstellung | Beschreibung | Standard |
|---|---|---|
| Endpunkt | Garage-S3-API-URL | — |
| Region | Regionswert des Clusters (für das Signieren von Anfragen benötigt) | — |
| Zugriffsschlüssel-ID / Geheimer Zugangsschlüssel | Garage-Schlüsselpaar | — |
| Bucket | Der einzubindende Bucket (aus Liste oder manuelle Eingabe) | — |
| Schreibgeschützt | Blockiert Schreibvorgänge auf dem eingebundenen Laufwerk | aus |
Verhalten & Einschränkungen¶
- Verbindungen verwenden Path-Style-Adressierung, und private oder selbstsignierte TLS-Zertifikate werden akzeptiert — geeignet für LAN- und Homelab-Einsätze.
Fehlerbehebung¶
| Symptom | Ursache | Lösung |
|---|---|---|
| Signaturfehler | Region stimmt nicht mit der Cluster-Konfiguration überein | Das Feld Region auf den s3_region-Wert des Clusters setzen |
| Bucket-Liste leer | Schlüssel hat keine Berechtigung auf dem Bucket | Den Schlüssel mit garage bucket allow berechtigen, oder den Bucket manuell eingeben |