RustFS unter Windows installieren

Voraussetzungen prüfenCopy Anchor Link

Stellen Sie vor dem Start Folgendes sicher:

• Sie verwenden 64-Bit-Windows auf einem x86-64-Prozessor. Launcher bündelt derzeit die Windows-x86-64-Binary von RustFS.
• Sie dürfen Anwendungen installieren oder ausführen und in das gewählte Datenverzeichnis schreiben.
• Die TCP-Ports 9000 und 9001 sind frei, oder Sie haben zwei andere ungenutzte Ports gewählt.
• Sie haben ein eigenes Datenverzeichnis angelegt, zum Beispiel D:\rustfs\data.

Installationsmethode wählenCopy Anchor Link

Launcher herunterladen und installierenCopy Anchor Link

1. Öffnen Sie die Release-Seite von RustFS Launcher.
2. Wählen Sie das neueste Release und laden Sie das Windows-x86-64-Installationsprogramm aus Assets herunter. Laden Sie Source code nicht herunter. Es dient dazu, Launcher aus dem Quellcode zu bauen.
3. Doppelklicken Sie auf das Installationsprogramm und folgen Sie den Eingabeaufforderungen.
4. Öffnen Sie RustFS Launcher aus dem Startmenü, falls die Anwendung nicht automatisch startet.

Wenn Microsoft Defender SmartScreen eine Warnung anzeigt, prüfen Sie, dass das Installationsprogramm von der offiziellen Release-Seite rustfs/launcher stammt, bevor Sie die Ausführung zulassen. Deaktivieren Sie Windows-Sicherheitsfunktionen nicht global.

Launcher konfigurierenCopy Anchor Link

Konfigurieren Sie die Felder im Launcher-Fenster:

Wählen Sie das Datenverzeichnis mit Browse oder ziehen Sie es in Launcher. Launcher setzt voraus, dass das Verzeichnis vor dem Start existiert.

Ersetzen Sie die Platzhalter für die Zugangsdaten durch eigene Werte. Launcher zeigt anfangs die standardmäßigen lokalen Test-Zugangsdaten an. Behalten Sie sie nicht auf einem Computer bei, auf den andere Benutzer zugreifen können.

RustFS starten und prüfenCopy Anchor Link

1. Wählen Sie Launch RustFS.
2. Warten Sie, bis Launcher meldet, dass der konfigurierte Endpunkt online ist.
3. Öffnen Sie http://localhost:9001 und melden Sie sich mit dem Zugriffsschlüssel und dem geheimen Zugriffsschlüssel an, die Sie konfiguriert haben.
4. Verwenden Sie http://localhost:9000 als Endpunkt für S3-kompatible Clients.

Wenn Sie Host oder Ports geändert haben, verwenden Sie diese Werte. Die Console-URL ist nur verfügbar, wenn Console Endpoint aktiviert ist.

Launcher sperrt seine Konfiguration, solange er einen laufenden Prozess verwaltet. Er legt außerdem ein Verzeichnis logs neben dem Datenverzeichnis an. Bei einem Datenpfad D:\rustfs\data liegen die Server-Protokolldateien beispielsweise unter D:\rustfs\logs.

Launcher anhalten oder beendenCopy Anchor Link

Wählen Sie Stop RustFS, bevor Sie die Konfiguration ändern, den Datenträger trennen oder Windows herunterfahren.

Wenn Sie das Launcher-Fenster schließen, wird es im Infobereich von Windows ausgeblendet. RustFS wird dadurch nicht angehalten. Um den verwalteten Prozess anzuhalten und Launcher zu beenden, klicken Sie mit der rechten Maustaste auf das Symbol im Infobereich und wählen Sie Quit. Wählen Sie Show oder klicken Sie mit der linken Maustaste auf das Symbol, um das Fenster wiederherzustellen.

Binary herunterladen und entpackenCopy Anchor Link

1. Öffnen Sie die RustFS-Release-Seite.
2. Wählen Sie das benötigte Release und laden Sie das Windows-x86-64-ZIP-Archiv aus Assets herunter. Der Asset-Name beginnt mit rustfs-windows-x86_64.
3. Öffnen Sie PowerShell und legen Sie Verzeichnisse für das Programm und seine Daten an:

New-Item -ItemType Directory -Force -Path C:\rustfs\bin
New-Item -ItemType Directory -Force -Path D:\rustfs\data

4. Entpacken Sie das heruntergeladene Archiv. Ersetzen Sie <version> durch die Version im heruntergeladenen Dateinamen:

Expand-Archive -Path "$HOME\Downloads\rustfs-windows-x86_64-<version>.zip" -DestinationPath C:\rustfs\bin -Force

5. Prüfen Sie, dass die entpackte Binary startet:

Set-Location C:\rustfs\bin
.\rustfs.exe --help

Wenn das Archiv rustfs.exe in ein verschachteltes Verzeichnis entpackt, wechseln Sie in dieses Verzeichnis oder verschieben Sie die ausführbare Datei nach C:\rustfs\bin, bevor Sie fortfahren.

Eigenständigen Server startenCopy Anchor Link

Setzen Sie die Zugangsdaten nur für die aktuelle PowerShell-Sitzung und starten Sie RustFS anschließend mit expliziten Adressen:

$env:RUSTFS_ACCESS_KEY = "<your-access-key>"
$env:RUSTFS_SECRET_KEY = "<your-secret-key>"

Set-Location C:\rustfs\bin
.\rustfs.exe server `
	--address "127.0.0.1:9000" `
	--console-enable true `
	--console-address "127.0.0.1:9001" `
	"D:\rustfs\data"

Lassen Sie das PowerShell-Fenster geöffnet, solange RustFS läuft. Drücken Sie in diesem Fenster Ctrl+C, um den Server anzuhalten.

Eigenständigen Server prüfenCopy Anchor Link

Öffnen Sie http://localhost:9001 und melden Sie sich mit den konfigurierten Zugangsdaten an. Verwenden Sie http://localhost:9000 als Endpunkt für S3-kompatible Clients. RustFS verwendet standardmäßig pfadbasierte Adressierung (Path-Style). Konfigurieren Sie die Clients entsprechend.

Prüfen Sie den Ablauf durchgehend: Legen Sie einen Bucket namens my-bucket an, laden Sie hello.txt hoch und prüfen Sie, dass das Objekt im Bucket erscheint.