RustFS unter macOS installieren

Mac-Architektur prüfenCopy Anchor Link

RustFS stellt unterschiedliche Binaries für Apple Silicon (arm64) und Intel (x86_64) bereit. Öffnen Sie das Terminal und führen Sie Folgendes aus:

uname -m

Wählen Sie anhand des Ergebnisses das passende Paket:

Stellen Sie vor dem Fortfahren außerdem Folgendes sicher:

• 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 $HOME/rustfs/data.

mkdir -p "$HOME/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 klappen Sie Assets auf.
3. Laden Sie das macOS-Installationsprogramm herunter, das zu Ihrer Architektur passt: AArch64 für Apple Silicon oder x86-64 für Intel. Laden Sie Source code nur herunter, wenn Sie Launcher selbst bauen möchten.
4. Öffnen Sie das heruntergeladene Festplattenabbild und verschieben Sie RustFS Launcher nach Applications (Programme).
5. Öffnen Sie RustFS Launcher aus Applications.

Wenn macOS den ersten Start blockiert, prüfen Sie, dass das Paket von der offiziellen Release-Seite rustfs/launcher stammt. Öffnen Sie anschließend System Settings > Privacy & Security (Systemeinstellungen > Datenschutz und Sicherheit) und erlauben Sie genau diese Anwendung. Deaktivieren Sie Gatekeeper 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. Die macOS-Dateiauswahl zeigt den aufgelösten Pfad an, nicht die literale Variable $HOME.

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 Mac 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. Wenn Sie beispielsweise $HOME/rustfs/data wählen, liegen die Server-Protokolldateien unter $HOME/rustfs/logs.

Launcher anhalten oder beendenCopy Anchor Link

Wählen Sie Stop RustFS, bevor Sie die Konfiguration ändern, einen externen Datenträger trennen oder macOS herunterfahren.

Wenn Sie das Launcher-Fenster schließen, wird es in der Menüleiste ausgeblendet. RustFS wird dadurch nicht angehalten. Um den verwalteten Prozess anzuhalten und Launcher zu beenden, öffnen Sie das Launcher-Symbol in der Menüleiste und wählen Sie Quit. Wählen Sie Show oder das Symbol, um das Fenster wiederherzustellen.

Apple-Silicon-Binary herunterladenCopy Anchor Link

Verwenden Sie dieses Verfahren, wenn uname -m den Wert arm64 zurückgibt:

1. Öffnen Sie die RustFS-Release-Seite.
2. Wählen Sie das benötigte Release und laden Sie das macOS-AArch64-ZIP-Archiv aus Assets herunter. Der Asset-Name beginnt mit rustfs-macos-aarch64.
3. Legen Sie ein Programmverzeichnis an und entpacken Sie das Archiv. Ersetzen Sie <version> durch die Version im heruntergeladenen Dateinamen:

mkdir -p "$HOME/rustfs/bin"
unzip "$HOME/Downloads/rustfs-macos-aarch64-<version>.zip" -d "$HOME/rustfs/bin"
chmod +x "$HOME/rustfs/bin/rustfs"
"$HOME/rustfs/bin/rustfs" --help

Wenn das Archiv einen plattformspezifischen Binary-Namen anstelle von rustfs enthält, verwenden Sie diesen Dateinamen in den weiteren Befehlen oder benennen Sie die Datei in $HOME/rustfs/bin/rustfs um.

Intel-Binary aus dem Quellcode bauenCopy Anchor Link

Verwenden Sie dieses Verfahren, wenn uname -m den Wert x86_64 zurückgibt und Sie ein Release neuer als v1.0.0-beta.9 benötigen.

1. Installieren Sie die Xcode-Befehlszeilenwerkzeuge:

xcode-select --install

2. Installieren Sie die aktuelle stabile Rust-Toolchain von rustup.rs und öffnen Sie anschließend eine neue Terminal-Sitzung.
3. Klonen Sie RustFS und checken Sie das benötigte Release aus:

git clone https://github.com/rustfs/rustfs.git
cd rustfs
git checkout <release-tag>

4. Bauen Sie das Intel-macOS-Ziel mit dem Build-Skript des Repositorys:

./build-rustfs.sh --platform x86_64-apple-darwin

Das Build-Skript bindet die Console-Assets standardmäßig ein und prüft die erzeugte Binary. Verwenden Sie im nächsten Schritt die Binary, die am Ende der Build-Ausgabe gemeldet wird.

Eigenständigen Server startenCopy Anchor Link

Setzen Sie die Zugangsdaten für die aktuelle Terminal-Sitzung und weisen Sie den Pfad zu Ihrer heruntergeladenen oder gebauten Binary zu:

export RUSTFS_ACCESS_KEY="<your-access-key>"
export RUSTFS_SECRET_KEY="<your-secret-key>"
export RUSTFS_BIN="$HOME/rustfs/bin/rustfs"

"$RUSTFS_BIN" server \
	--address "127.0.0.1:9000" \
	--console-enable true \
	--console-address "127.0.0.1:9001" \
	"$HOME/rustfs/data"

Ersetzen Sie bei einem Intel-Quellcode-Build RUSTFS_BIN durch den Binary-Pfad, den build-rustfs.sh ausgibt. Lassen Sie das Terminal-Fenster geöffnet, solange RustFS läuft. Drücken Sie Control+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.