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

前提条件を確認するCopy Anchor Link

始める前に、次を確認します。

• 使用しているのは、x86-64 プロセッサー上の 64 ビット Windows です。Launcher は現在、Windows x86-64 の RustFS バイナリを同梱しています。
• アプリケーションのインストールまたは実行と、選択したデータディレクトリへの書き込みの権限があります。
• TCP ポート 9000 と 9001 が空いているか、ほかの未使用ポートを 2 つ選んでいます。
• D:\rustfs\data のような専用のデータディレクトリを作成しています。

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

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

1. RustFS Launcher の Releases ページ を開きます。
2. 最新のリリースを選び、Assets（アセット）から Windows x86-64 のインストーラーをダウンロードします。ソースから Launcher をビルドするための Source code（ソースコード）はダウンロードしないでください。
3. インストーラーをダブルクリックし、画面の指示に従います。
4. 自動で開かない場合は、スタートメニューから RustFS Launcher を開きます。

Microsoft Defender SmartScreen が警告を表示した場合は、実行を許可する前に、インストーラーが公式の rustfs/launcher Releases ページから入手したものであることを確認します。Windows のセキュリティ機能をシステム全体で無効にしないでください。

Launcher を設定するCopy Anchor Link

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

Browse（参照）でデータディレクトリを選ぶか、Launcher にドラッグします。Launcher は、起動前にディレクトリが存在していることを要求します。

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

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 ディレクトリを作成します。たとえば、データパスが D:\rustfs\data の場合、サーバーのログファイルは D:\rustfs\logs に置かれます。

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

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

Launcher ウィンドウを閉じると、Windows のシステムトレイに隠れるだけで、RustFS は停止しません。管理対象のプロセスを停止して Launcher を終了するには、トレイアイコンを右クリックして Quit（終了）を選びます。ウィンドウを戻すには、Show（表示）を選ぶか、トレイアイコンを左クリックします。

バイナリをダウンロードして展開するCopy Anchor Link

1. RustFS の Releases ページ を開きます。
2. 必要なリリースを選び、Assets から Windows x86-64 の ZIP アーカイブをダウンロードします。アセット名は rustfs-windows-x86_64 で始まります。
3. PowerShell を開き、プログラムとデータのディレクトリを作成します。

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

4. ダウンロードしたアーカイブを展開します。<version> は、ダウンロードしたファイル名のバージョンに置き換えます。

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

5. 展開したバイナリが実行できることを確認します。

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

アーカイブが rustfs.exe をネストしたディレクトリに展開した場合は、続ける前にそのディレクトリへ移動するか、実行ファイルを C:\rustfs\bin に移動します。

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

現在の PowerShell セッションだけに認証情報を設定し、明示的なアドレスで RustFS を起動します。

$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"

RustFS の実行中は、PowerShell ウィンドウを開いたままにします。そのウィンドウで Ctrl+C を押すと、サーバーが停止します。

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

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

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