ホームドキュメントインストールMCPSDKデモコミュニティブログ
リファレンス

環境変数

RustFS サーバー、Console、TLS、KMS、オブザーバビリティ、スキャナー、データ修復、ストレージクラス、認証情報、イベントターゲットを設定する環境変数のリファレンスです。

このページでは、rustfs サーバーバイナリが認識する環境変数を一覧します。対象は、RustFS のソースコードで確認した、運用に関係する変数に限ります。内部向けの調整項目の一部は、意図的に省略しています。対応するコマンドラインフラグがある変数は、そのフラグでも指定できます（CLI リファレンス を参照）。

真偽値

真偽値の変数は true/false を受け付けます。「unset」と示した値には既定値がなく、対応する機能は無効のままか、組み込みの動作にフォールバックします。

コアサーバー

変数既定値説明
RUSTFS_VOLUMESunset (required)ストレージボリュームまたはエンドポイントを、空白区切りで指定します。{N...M} 形式の省略記号展開に対応します。例: /data/rustfs{0...3}、http://node{1...4}:9000/data/rustfs{0...3}。Docker イメージの既定値は /data です。
RUSTFS_ADDRESS:9000S3 API リスナーのバインドアドレスとポートです（ノード間の内部 RPC もこのリスナーを使います）。
RUSTFS_SERVER_DOMAINSunset仮想ホスト形式の S3 リクエストに使うドメイン名を、カンマ区切りで指定します。例: s3.example.com を指定すると、bucket.s3.example.com はバケット bucket として解決されます。未設定の場合は、パススタイルアクセスのみが動作します。
RUSTFS_REGIONunsetS3 クライアントへ報告するリージョンです。未設定の場合、サーバーは us-east-1 にフォールバックします。
RUSTFS_LICENSEunsetライセンス文字列です。
RUSTFS_BUFFER_PROFILEGeneralPurpose適応的なバッファサイズ決定に使うワークロードプロファイルです。選択肢は GeneralPurpose、AiTraining、DataAnalytics、WebWorkload、IndustrialIoT、SecureStorage です。
RUSTFS_BUFFER_PROFILE_DISABLEfalse適応的なバッファサイズ決定を無効にし、従来の固定サイズバッファを使います。
RUSTFS_HEALTH_ENDPOINT_ENABLEtrue認証不要のプローブエンドポイント /health と /health/ready を登録します。
RUSTFS_HEALTH_READINESS_CACHE_TTL_MS1000準備完了プローブの結果をキャッシュする TTL です。単位はミリ秒です。
RUSTFS_HEALTH_CLUSTER_TIMEOUT_MS2000クラスターのヘルスチェック（/minio/health/cluster）のタイムアウトです。単位はミリ秒です。
RUSTFS_STARTUP_READINESS_MAX_WAIT_SECS120準備完了プローブが「starting」と報告する最長時間です。この時間を超えると、起動に失敗したとみなします。単位は秒です。
RUSTFS_CHECK_UPDATEtrue起動時に version.rustfs.com へ HTTPS リクエストを 1 回送り、新しい RustFS リリースがあるか確認します。ユーザーエージェントには現在のバージョンが含まれます。結果はログに記録されるだけで、RustFS が自ら更新することはありません。エアギャップ環境などでは false に設定し、外部へのリクエストを省略します。認識できない値は true にフォールバックします。

Console

変数既定値説明
RUSTFS_CONSOLE_ENABLEtrue組み込みの Web Console を有効にします（別のリスナーで提供されます）。
RUSTFS_CONSOLE_ADDRESS:9001Console リスナーのバインドアドレスとポートです。

CORS

変数既定値説明
RUSTFS_CORS_ALLOWED_ORIGINSemptyブラウザから S3 API へアクセスできるオリジンを、カンマ区切りで指定します。認証情報を伴わないワイルドカードオリジンにする場合は * を設定します。
RUSTFS_CONSOLE_CORS_ALLOWED_ORIGINS*ブラウザから Console へアクセスできるオリジンをカンマ区切りで指定します。すべてのオリジンを許可する場合は * です。

設定と確認の手順は CORS の設定 を参照します。

TLS と KMS

変数既定値説明
RUSTFS_TLS_PATHunsetS3 API と Console 用の TLS 証明書と鍵（rustfs_cert.pem / rustfs_key.pem）を置くディレクトリです。設定すると TLS が有効になります。
RUSTFS_TLS_RELOAD_ENABLEfalseTLS ディレクトリを監視し、証明書を再読み込みします。
RUSTFS_TLS_KEYLOGfalseデバッグのため、TLS セッション鍵を keylog ファイルへ書き出します。本番では有効にしないでください。
RUSTFS_TRUST_SYSTEM_CAfalse外向きの TLS 接続で、オペレーティングシステムの CA ストアも信頼します。
RUSTFS_TRUST_LEAF_CERT_AS_CAfalseリーフ証明書を CA であるかのように信頼します（自己署名の構成向けです）。
RUSTFS_SERVER_MTLS_ENABLEfalseサーバーリスナーでクライアント証明書（相互 TLS）を要求します。
RUSTFS_MTLS_CLIENT_CERTunsetノード間の mTLS 接続で提示するクライアント証明書です。
RUSTFS_MTLS_CLIENT_KEYunsetノード間の mTLS 接続に使うクライアント秘密鍵です。
RUSTFS_KMS_ENABLEfalseKMS を使ったサーバー側の暗号化を有効にします。
RUSTFS_KMS_BACKENDlocalKMS バックエンドです。指定できる値は local、vault / vault-kv2（ローカルでデータキーをラップする Vault KV2 ストレージ）、vault-transit です。
RUSTFS_KMS_KEY_DIRunsetlocal バックエンドのキーディレクトリです。
RUSTFS_KMS_LOCAL_MASTER_KEYunsetローカル KMS のキーファイルを保護するマスターキーです。
RUSTFS_KMS_VAULT_ADDRESSunsetVault バックエンドが使う Vault サーバーのアドレスです。
RUSTFS_KMS_VAULT_TOKENunsetVault バックエンドが使う Vault トークンです。
RUSTFS_KMS_VAULT_MOUNT_PATHtransitvault-transit の Transit マウントです。vault / vault-kv2 では非推奨であり、使用されません。
RUSTFS_KMS_VAULT_KV_MOUNTsecretvault / vault-kv2 バックエンドの KV v2 マウントです。
RUSTFS_KMS_VAULT_KEY_PREFIXrustfs/kms/keysvault / vault-kv2 で、KV v2 マウント内のキーレコードに付けるプレフィックスです。
RUSTFS_KMS_DEFAULT_KEY_IDunset暗号化に使う既定の KMS キー ID です。
RUSTFS_KMS_ALLOW_INSECURE_DEV_DEFAULTSfalse開発専用の、安全でない KMS 既定値を許可します。本番では決して有効にしないでください。

オブザーバビリティ

オブザーバビリティのパイプラインは、トレース、メトリクス、ログを OTLP/HTTP でエクスポートします。

変数既定値説明
RUSTFS_OBS_ENDPOINTemptyトレース、メトリクス、ログ共通の OTLP/HTTP ベース URL です。例: http://otel-collector:4318 。空の場合、ログは標準出力またはローカルファイルへ出力されます。
RUSTFS_OBS_TRACE_ENDPOINTunsetトレースエンドポイントに対する、シグナル別の上書きです。
RUSTFS_OBS_METRIC_ENDPOINTunsetメトリクスエンドポイントに対する、シグナル別の上書きです。
RUSTFS_OBS_LOG_ENDPOINTunsetログエンドポイントに対する、シグナル別の上書きです。
RUSTFS_OBS_TRACES_EXPORT_ENABLEDtrueトレースを OTLP エンドポイントへエクスポートします。
RUSTFS_OBS_METRICS_EXPORT_ENABLEDtrueメトリクスを OTLP エンドポイントへエクスポートします。
RUSTFS_OBS_LOGS_EXPORT_ENABLEDtrueログを OTLP エンドポイントへエクスポートします。
RUSTFS_OBS_USE_STDOUTunsetテレメトリ出力を標準出力へ強制します。
RUSTFS_OBS_SAMPLE_RATIOunsetトレースのサンプリング率です（0.0〜1.0）。
RUSTFS_OBS_METER_INTERVALunsetメトリクスのエクスポート間隔です。単位は秒です。
RUSTFS_OBS_SERVICE_NAMEunsetテレメトリのリソース属性として報告するサービス名です。
RUSTFS_OBS_ENVIRONMENTunsetデプロイ環境のラベルです（production、development、test、staging）。
RUSTFS_OBS_LOGGER_LEVELunsetログレベルのフィルタです（例: info、debug）。
RUSTFS_OBS_LOG_STDOUT_ENABLEDunsetファイルまたは OTLP へのログ出力が有効なとき、ログを標準出力へも複製します。
RUSTFS_OBS_LOG_DIRECTORYunsetローカルのログディレクトリです。未設定の場合、ログは標準出力へ出力されます。URL を指定すると、ログはリモートエンドポイントへ送信されます。
RUSTFS_OBS_LOG_FILENAMErustfs.logログディレクトリ内のログファイル名です。
RUSTFS_OBS_LOG_ROTATION_TIMEhourly時間に基づくログローテーションです。指定できる値は daily、hourly、minutely です。
RUSTFS_OBS_LOG_KEEP_FILES30保持するローテーション済みログファイルの数です。
RUSTFS_OBS_LOG_MAX_TOTAL_SIZE_BYTES2147483648クリーンアップ前における、ログディレクトリの合計サイズ上限です（2 GiB）。
RUSTFS_OBS_LOG_COMPRESS_OLD_FILEStrueローテーション済みのログファイルを圧縮します（既定は zstd。RUSTFS_OBS_LOG_COMPRESSION_ALGORITHM で変更できます）。

メトリクスの収集間隔は、RUSTFS_METRICS_<SCOPE>_INTERVAL_SEC というパターンに従います。スコープは DEFAULT、SYSTEM、CLUSTER、BUCKET、NODE、RESOURCE、AUDIT、NOTIFICATION、BUCKET_REPLICATION_BANDWIDTH です。例: RUSTFS_METRICS_CLUSTER_INTERVAL_SEC=60。

スキャナーとデータ修復

変数既定値説明
RUSTFS_SCANNER_SPEEDdefaultスキャナー速度のプリセットです。指定できる値は fastest、fast、default、slow、slowest です。スリープ係数、最大スリープ、サイクル間隔を制御します。
RUSTFS_SCANNER_DELAYpresetスキャナーのスリープ倍率を上書きします（例: 30.0）。
RUSTFS_SCANNER_MAX_WAIT_SECSpresetスキャナーの最大スリープ時間を秒単位で上書きします。
RUSTFS_SCANNER_CYCLEpresetスキャンサイクルの間隔を秒単位で上書きします（例: 3600）。
RUSTFS_SCANNER_START_DELAY_SECSunset最初のスキャンサイクルまでの起動遅延です。単位は秒です。
RUSTFS_SCANNER_CYCLE_MAX_DURATION_SECS18001 サイクルの実行時間の上限です。単位は秒です。0 でこの上限を無効にします。
RUSTFS_SCANNER_CYCLE_MAX_OBJECTS01 サイクルで処理するオブジェクト数の上限です。0 でこの上限を無効にします。
RUSTFS_SCANNER_CYCLE_MAX_DIRECTORIES01 サイクルで進入するディレクトリ数の上限です。0 でこの上限を無効にします。
RUSTFS_SCANNER_BITROT_CYCLE_SECS2592000定期的なディープ（bitrot）スキャンのサイクルです。単位は秒です（30 日）。0 / true / on ですべてのサイクルをディープにし、false / off でディープスキャンを無効にします。
RUSTFS_SCANNER_IDLE_MODEtruetrue のとき、スキャナーは自ら処理を抑制します。false では全速で実行します。
RUSTFS_SCANNER_CACHE_SAVE_TIMEOUT_SECS14スキャナーキャッシュの保存タイムアウトです。単位は秒です（最小値は 1）。
RUSTFS_SCANNER_MAX_CONCURRENT_SET_SCANS4同時に実行するイレイジャーセットのスキャンタスク数の上限です。0 ではトポロジーに基づく同時実行数を維持します。
RUSTFS_SCANNER_MAX_CONCURRENT_DISK_SCANS4セットあたりで同時に行うディスク上のバケット走査数の上限です。0 ではディスク数に基づく同時実行数を維持します。
RUSTFS_SCANNER_YIELD_EVERY_N_OBJECTS128スキャナーのオブジェクトループが、非同期ランタイムへ処理を譲る頻度です。0 で、この追加の譲り渡しを無効にします。
RUSTFS_SCANNER_ALERT_EXCESS_VERSIONS100スキャナーアラートを発生させる、オブジェクトのバージョン数です。
RUSTFS_SCANNER_ALERT_EXCESS_VERSION_SIZE1099511627776スキャナーアラートを発生させる、バージョンの累積バイト数です（1 TiB）。
RUSTFS_SCANNER_ALERT_EXCESS_FOLDERS65538スキャナーアラートを発生させる、直下のサブフォルダー数です。
RUSTFS_HEAL_AUTO_HEAL_ENABLEtrue劣化したオブジェクトの自動バックグラウンドデータ修復を有効にします。
RUSTFS_HEAL_QUEUE_SIZE10000修復候補キューの容量です。
RUSTFS_HEAL_INTERVAL_SECS10修復スケジューラの実行間隔です。単位は秒です。
RUSTFS_HEAL_TASK_TIMEOUT_SECS3001 件の修復タスクのタイムアウトです。単位は秒です。
RUSTFS_HEAL_MAX_CONCURRENT_HEALS4同時に実行する修復タスクの最大数です。
RUSTFS_HEAL_MAX_CONCURRENT_PER_SET1イレイジャーセットあたりの、同時修復タスクの最大数です。

ストレージとイレイジャーコーディング

変数既定値説明
RUSTFS_STORAGE_CLASS_STANDARDautoSTANDARD ストレージクラスのパリティです。形式は EC:n です。例: EC:4。未設定の場合、パリティはイレイジャーセットのサイズから決まります。
RUSTFS_STORAGE_CLASS_RRSEC:1REDUCED_REDUNDANCY ストレージクラスのパリティです。形式は EC:n です。
RUSTFS_STORAGE_CLASS_OPTIMIZEavailabilityパリティ選択における最適化の目標です。
RUSTFS_STORAGE_CLASS_INLINE_BLOCK131072オブジェクトデータをメタデータへインライン化するサイズのしきい値です（128 KiB）。この値未満が対象です。
RUSTFS_ERASURE_SET_DRIVE_COUNT0イレイジャーセットあたりのドライブ数を強制します。0 ではレイアウトを自動選択します。
RUSTFS_DURABILITY_MODEunset書き込みの耐久性モードです。指定できる値は strict、relaxed、none です。有効な値を設定すると、従来のドライブ同期スイッチより優先されます。

認証情報と内部設定

変数既定値説明
RUSTFS_ACCESS_KEYrustfsadminルートアクセスキーです。RUSTFS_ACCESS_KEY_FILE とは同時に指定できません。
RUSTFS_SECRET_KEYrustfsadminルートシークレットキーです。RUSTFS_SECRET_KEY_FILE とは同時に指定できません。
RUSTFS_ACCESS_KEY_FILEunsetアクセスキーを格納したファイルのパスです（例: Docker や Kubernetes の Secret マウント）。
RUSTFS_SECRET_KEY_FILEunsetシークレットキーを格納したファイルのパスです。
RUSTFS_RPC_SECRETderivedノード間 RPC の認証に使うシークレットです。未設定の場合は、有効なアクセスキーとシークレットキーの組から導出されます。認証情報がすべて既定値の組である場合、マルチノードクラスターではこの値を明示的に設定する必要があります。

組み込みの既定認証情報 rustfsadmin/rustfsadmin は、初回起動を簡単にするためのものです。本番デプロイでは、既定以外の認証情報を設定する必要があります。

イベントと監査のターゲット

モジュールのスイッチ:

変数既定値説明
RUSTFS_NOTIFY_ENABLEfalseバケットイベント通知モジュールを有効にします。
RUSTFS_AUDIT_ENABLEfalse監査ログモジュールを有効にします。

ターゲットの設定はパターンに基づきます。イベント通知は RUSTFS_NOTIFY_<TARGET>_<KEY>、監査ログは RUSTFS_AUDIT_<TARGET>_<KEY> です。両系統でサポートされるターゲットは WEBHOOK、KAFKA、MQTT、MYSQL、POSTGRES、NATS、REDIS、AMQP、PULSAR です。

Webhook ターゲットのサブキーです（同じキーが RUSTFS_AUDIT_WEBHOOK_* にもあります）。

変数既定値説明
RUSTFS_NOTIFY_WEBHOOK_ENABLEfalseWebhook ターゲットを有効にします。
RUSTFS_NOTIFY_WEBHOOK_ENDPOINTunsetWebhook の HTTP(S) エンドポイント URL です。
RUSTFS_NOTIFY_WEBHOOK_AUTH_TOKENunset各配信に付与する Bearer トークンです。
RUSTFS_NOTIFY_WEBHOOK_QUEUE_DIRunset永続的な配信キューのディレクトリです。
RUSTFS_NOTIFY_WEBHOOK_QUEUE_LIMITunsetキューに入れられるイベントの最大数です。
RUSTFS_NOTIFY_WEBHOOK_CLIENT_CERTunsetエンドポイントへの mTLS に使うクライアント証明書です。
RUSTFS_NOTIFY_WEBHOOK_CLIENT_KEYunsetエンドポイントへの mTLS に使うクライアント秘密鍵です。
RUSTFS_NOTIFY_WEBHOOK_CLIENT_CAunsetエンドポイントの検証に使う CA 証明書です。
RUSTFS_NOTIFY_WEBHOOK_SKIP_TLS_VERIFYunsetエンドポイントの TLS 検証を省略します（推奨しません）。

ほかのターゲットも同じ形で、ターゲット固有のキーを持ちます。例: RUSTFS_NOTIFY_KAFKA_BROKERS、RUSTFS_NOTIFY_KAFKA_TOPIC、RUSTFS_NOTIFY_MQTT_BROKER、RUSTFS_NOTIFY_MQTT_TOPIC、RUSTFS_NOTIFY_MYSQL_DSN_STRING、RUSTFS_NOTIFY_NATS_ADDRESS、RUSTFS_NOTIFY_REDIS_URL、RUSTFS_NOTIFY_AMQP_URL、RUSTFS_NOTIFY_PULSAR_BROKER。

従来互換

MINIO_* 変数の対応

移行を簡単にするため、RustFS は起動時に、許可リストで固定された MINIO_* 変数を、対応する RUSTFS_* へ割り当てます。

  • MINIO_ 接頭辞の変数だけが設定されている場合は、その値が使われ、非推奨である旨の警告がログに記録されます。
  • MINIO_* と RUSTFS_* が異なる値で両方設定されている場合は、RUSTFS_* の値が優先され、競合が記録されます。

対応する接尾辞には、ACCESS_KEY、SECRET_KEY、ACCESS_KEY_FILE、SECRET_KEY_FILE、ROOT_USER、ROOT_PASSWORD、ADDRESS、CONSOLE_ADDRESS、VOLUMES、REGION、LICENSE、ERASURE_SET_DRIVE_COUNT、STORAGE_CLASS_STANDARD、STORAGE_CLASS_RRS、STORAGE_CLASS_OPTIMIZE、STORAGE_CLASS_INLINE_BLOCK、SCANNER_SPEED、SCANNER_CYCLE、COMPRESS_ENABLE、COMPRESS_EXTENSIONS、COMPRESS_MIME_TYPES、DRIVE_ACTIVE_MONITORING、ILM_EXPIRATION_WORKERS、API_XFF_HEADER、POLICY_PLUGIN_URL、POLICY_PLUGIN_AUTH_TOKEN、IDENTITY_OPENID_* の各キー、および NOTIFY_WEBHOOK_、NOTIFY_MQTT_、AUDIT_WEBHOOK_、AUDIT_MQTT_ で始まるすべての変数が含まれます。たとえば、MINIO_ROOT_USER は RUSTFS_ROOT_USER に、MINIO_NOTIFY_WEBHOOK_ENDPOINT は RUSTFS_NOTIFY_WEBHOOK_ENDPOINT に対応します。

非推奨のエイリアス

非推奨の変数代替
RUSTFS_ROOT_USERRUSTFS_ACCESS_KEY
RUSTFS_ROOT_PASSWORDRUSTFS_SECRET_KEY
RUSTFS_DATA_SCANNER_START_DELAY_SECSRUSTFS_SCANNER_START_DELAY_SECS

非推奨のエイリアスは引き続き動作しますが、警告がログに記録されます。両方を設定した場合、正規の RUSTFS_* 名が常に優先されます。

リファレンス

RustFS の設定変数とコマンドラインオプションを参照します。

CLI リファレンス

rustfs のサブコマンド、サーバーフラグ、対応する環境変数、ボリュームパスの構文をまとめたリファレンスです。

On this page

コアサーバーConsoleCORSTLS と KMSオブザーバビリティスキャナーとデータ修復ストレージとイレイジャーコーディング認証情報と内部設定イベントと監査のターゲット従来互換MINIO_* 変数の対応非推奨のエイリアス