macOS に RustFS をインストールする

Mac のアーキテクチャを確認するCopy Anchor Link

RustFS は、Apple シリコン（arm64）と Intel（x86_64）の Mac 向けに異なるビルドを提供しています。Terminal を開いて次を実行します。

uname -m

結果を見て、正しいパッケージを選びます。

続ける前に、次も確認します。

• アプリケーションのインストールまたは実行と、選択したデータディレクトリへの書き込みの権限があります。
• TCP ポート 9000 と 9001 が空いているか、ほかの未使用ポートを 2 つ選んでいます。
• $HOME/rustfs/data のような専用のデータディレクトリを作成しています。

mkdir -p "$HOME/rustfs/data"

インストール方法を選ぶCopy Anchor Link

Launcher をダウンロードしてインストールするCopy Anchor Link

1. RustFS Launcher の Releases ページ を開きます。
2. 最新のリリースを選び、Assets（アセット）を展開します。
3. アーキテクチャに一致する macOS インストーラーをダウンロードします。Apple シリコンは AArch64、Intel は x86-64 です。自分で Launcher をビルドする場合を除き、Source code（ソースコード）はダウンロードしないでください。
4. ダウンロードしたディスクイメージを開き、RustFS Launcher を Applications（アプリケーション）に移動します。
5. Applications から RustFS Launcher を開きます。

macOS が初回起動をブロックした場合は、パッケージが公式の rustfs/launcher Releases ページから入手したものであることを確認します。その後、System Settings > Privacy & Security（システム設定 > プライバシーとセキュリティ）を開き、そのアプリケーションだけを許可します。Gatekeeper をシステム全体で無効にしないでください。

Launcher を設定するCopy Anchor Link

Launcher ウィンドウの各フィールドを設定します。

Browse（参照）でデータディレクトリを選ぶか、Launcher にドラッグします。Launcher は、起動前にディレクトリが存在していることを要求します。macOS のファイル選択ダイアログは、リテラルの $HOME 変数ではなく、展開されたパスを表示します。

認証情報のプレースホルダーを独自の値に置き換えます。Launcher は最初、ローカルテスト用の既定の認証情報を表示します。ほかのユーザーがアクセスできる Mac では、その値を残さないでください。

RustFS を起動して確認するCopy Anchor Link

1. Launch RustFS（RustFS を起動）を選びます。
2. 設定したエンドポイントがオンラインになったと Launcher が報告するまで待ちます。
3. http://localhost:9001 を開き、設定したアクセスキーとシークレットキーでサインインします。
4. S3 互換クライアントのエンドポイントとして http://localhost:9000 を使います。

ホストまたはポートを変更した場合は、その値を使います。Console の URL は、Console Endpoint が有効な場合にのみ使えます。

Launcher は、実行中のプロセスを管理している間、設定をロックします。また、データディレクトリの隣に logs ディレクトリを作成します。たとえば、$HOME/rustfs/data を選んだ場合、サーバーのログファイルは $HOME/rustfs/logs に置かれます。

Launcher を停止または終了するCopy Anchor Link

設定を変更する前、外付けのデータディスクを取り外す前、または macOS をシャットダウンする前に、Stop RustFS（RustFS を停止）を選びます。

Launcher ウィンドウを閉じると、メニューバーに隠れるだけで、RustFS は停止しません。管理対象のプロセスを停止して Launcher を終了するには、Launcher のメニューバーアイコンを開き、Quit（終了）を選びます。ウィンドウを戻すには、Show（表示）を選ぶか、アイコンを選択します。

Apple シリコンのバイナリをダウンロードするCopy Anchor Link

uname -m が arm64 を返す場合は、この手順を使います。

1. RustFS の Releases ページ を開きます。
2. 必要なリリースを選び、Assets から macOS AArch64 の ZIP アーカイブをダウンロードします。アセット名は rustfs-macos-aarch64 で始まります。
3. プログラム用のディレクトリを作成し、アーカイブを展開します。<version> は、ダウンロードしたファイル名のバージョンに置き換えます。

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

アーカイブに rustfs ではなくプラットフォーム固有のバイナリ名が含まれている場合は、残りのコマンドでそのファイル名を使うか、$HOME/rustfs/bin/rustfs に名前を変更します。

Intel のバイナリをソースからビルドするCopy Anchor Link

uname -m が x86_64 を返し、v1.0.0-beta.9 より新しいリリースが必要な場合は、この手順を使います。

1. Xcode コマンドラインツールをインストールします。

xcode-select --install

2. rustup.rs から現行の安定版 Rust ツールチェーンをインストールし、新しい Terminal セッションを開きます。
3. RustFS をクローンし、必要なリリースをチェックアウトします。

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

4. リポジトリのビルドスクリプトで、Intel macOS 向けターゲットをビルドします。

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

ビルドスクリプトは既定で Console のアセットを含め、生成されたバイナリを検証します。次の手順では、ビルド出力の末尾に表示されたバイナリを使います。

スタンドアロンサーバーを起動するCopy Anchor Link

現在の Terminal セッションに認証情報を設定し、ダウンロードまたはコンパイルしたバイナリのパスを割り当てます。

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"

Intel のソースビルドでは、RUSTFS_BIN を build-rustfs.sh が表示したバイナリパスに置き換えます。RustFS の実行中は Terminal ウィンドウを開いたままにします。Control+C でサーバーを停止します。

スタンドアロンサーバーを確認するCopy Anchor Link

http://localhost:9001 を開き、設定した認証情報でサインインします。S3 互換クライアントのエンドポイントとして http://localhost:9000 を使います。RustFS は既定でパススタイルアクセスになるため、クライアントもそれに合わせて設定します。

エンドツーエンドで確認するには、my-bucket という名前のバケットを作成し、hello.txt をアップロードして、オブジェクトがバケットに表示されることを確認します。