文件

核心設定

此頁面涵蓋控制 MinIO 程序核心行為的設定。

您可以透過定義以下方式建立或修改設定

  • 在啟動或重新啟動 MinIO 伺服器之前,在主機系統上設定環境變數。請參閱您的作業系統文件,了解如何定義環境變數。

  • 使用 mc admin config set 設定設定

  • 使用 MinIO 主控台管理員 > 設定 頁面設定設定

如果您同時定義了環境變數和類似的組態設定,則 MinIO 會使用環境變數值。

某些設定僅具有環境變數或設定,但不能同時具有兩者。

重要

每個組態設定都控制著 MinIO 的基本行為和功能。MinIO 強烈建議在將組態變更應用於生產環境之前,先在較低的環境(例如 DEV 或 QA)中進行測試。

MinIO 伺服器 CLI 選項

MINIO_OPTS

此變數沒有組態設定,因為這些設定是在伺服器啟動時應用。

可選

設定在啟動 MinIO 伺服器時要使用的一串參數

對於使用建議的 MinIO systemd 服務的類 Unix 系統,請使用 /etc/default/minio 檔案,並建立一個環境變數 MINIO_OPTS,以指定要附加到 minio systemd 進程的參數。

# Editing /etc/default/minio

MINIO_OPTS=' --console-address=":9001" --ftp="address=:8021" --ftp="passive-port-range=30000-40000" '

對於在命令列上執行 minio 的系統,MINIO_OPTS 是選用的。若要使用它,請使用標準 shell 語法宣告環境變數,然後在啟動 MinIO 伺服器時參考該環境變數。

export MINIO_OPTS=' --console-address=":9001" --ftp="address=:8021" --ftp="passive-port-range=30000-40000" '

minio server $MINIO_OPTS ...

# The above is equivalent to running the following:
# minio server --console-address=":9001" \
#              --ftp="address=:8021"     \
#              --ftp="passive-port-range=30000-40000"

重要

minio server 命令不會直接讀取 $MINIO_OPTS。只有在按照上述方式使用時,該變數才會起作用。

儲存磁碟區

MINIO_VOLUMES

minio server 進程用作儲存後端的目錄或磁碟機。

功能上等同於設定 minio server DIRECTORIES。在設定 MinIO 使用環境檔案執行時,請使用此值。

此設定沒有組態設定選項。

環境變數檔案路徑

MINIO_CONFIG_ENV_FILE

指定 MinIO 伺服器進程用於載入環境變數的檔案完整路徑。

對於 systemd 管理的檔案,請將此值設定為環境檔案的路徑(/etc/default/minio),以便在使用 mc admin service restart 重新啟動部署時,指示 MinIO 重新載入對該檔案的變更。

此設定沒有組態設定選項。

過期處理的 Worker

MINIO_ILM_EXPIRY_WORKERS

指定可供過期處理的 Worker 數量,這些 Worker 用於處理已設定 ILM 過期規則的物件。如果未設定,MinIO 預設會使用最多一半的可用處理核心。

此設定沒有組態設定選項。

網域

MINIO_DOMAIN

啟用對 MinIO 部署的虛擬主機樣式請求。將此值設定為 MinIO 的完整網域名稱 (FQDN),以接受傳入的虛擬主機請求。

省略此設定會指示 MinIO 僅接受預設的路徑樣式請求。

例如,假設 MinIO 部署的 FQDN 為 minio.example.net

  • 使用路徑樣式查詢,應用程式可以使用完整路徑 minio.example.net/mybucket 存取儲存貯體。

  • 使用虛擬主機查詢,應用程式可以虛擬主機 mybucket.minio.example.net/ 存取儲存貯體。

重要

如果您設定 MINIO_DOMAIN,您**必須**將指定 FQDN 的所有子網域視為專用於儲存貯體名稱。任何與這些網域衝突的 MinIO 服務(例如複寫目標)可能會因為衝突而出現非預期或不希望發生的行為。

例如,如果設定 MINIO_DOMAIN=minio.example.net,您**無法**將 minio.example.net 的任何子網域(形式為 *.minio.example.net)指派給任何 MinIO 服務或目標。這包括用於 儲存貯體批次站點複寫 的主機名稱。

此設定沒有組態設定選項。

掃描器速度

MINIO_SCANNER_SPEED
掃描器 速度

在平衡 MinIO 讀取/寫入效能與掃描器進程時,管理 掃描器 的最長等待時間。

MinIO 會使用 掃描器 進行 儲存貯體複寫站點複寫生命週期管理修復 工作。

有效值包括

fastest

移除掃描器在讀取/寫入延遲上的等待,允許掃描器以全速和 IOPS 消耗運作。此設定可能會導致讀取和寫入效能降低。

fast

設定較短的掃描器在讀取/寫入延遲上的等待時間,允許掃描器以較高的速度和 IOPS 消耗運作。此設定可能會導致讀取和寫入效能降低。

default

設定適中的掃描器在讀取/寫入延遲上的等待時間,允許掃描器以平衡的速度和 IOPS 消耗運作。此設定旨在維持讀取和寫入效能,同時允許進行中的掃描器活動。

slow

設定中等的掃描器在讀取/寫入延遲上的等待時間,掃描器會以較低的速度和 IOPS 消耗運作。此設定可提供更好的讀取和寫入效能,同時降低掃描器效能。

可能會影響掃描器相依的功能,例如生命週期管理和複寫。

slowest

設定較長的掃描器在讀取/寫入延遲上的等待時間,掃描器會以非常低的速度和 IOPS 消耗運作。此設定會優先考慮讀取和寫入作業,但可能會犧牲掃描器作業的效能。

可能會影響掃描器相依的功能,例如生命週期管理和複寫。

批次複寫

MINIO_BATCH_REPLICATION_WORKERS

可選

指定執行批次應用程式工作時要使用的最大並行處理程序數。

此設定沒有組態設定選項。

資料壓縮

以下章節說明啟用物件資料壓縮的設定。請參閱 資料壓縮,以取得使用這些組態設定的教學。

本章節中的所有設定都屬於下列最上層鍵之下

compression

啟用壓縮

MINIO_COMPRESSION_ENABLE
compression enable

可選

設定為 on 可為新物件啟用資料壓縮。預設為 off

啟用或停用資料壓縮不會變更現有物件。

允許加密

MINIO_COMPRESSION_ALLOW_ENCRYPTION
compression allow_encryption

可選

設定為 on 可在壓縮物件後對其進行加密。預設為 off

加密壓縮的物件可能會危及安全性

MinIO 強烈建議不要加密壓縮的物件。如果您需要加密,請仔細評估可能洩漏有關加密物件內容的資訊的風險。

壓縮副檔名

MINIO_COMPRESSION_EXTENSIONS
compression extensions

可選

要壓縮的檔案副檔名清單,以逗號分隔。設定新的檔案副檔名清單會取代先前設定的清單。預設為 ".txt, .log, .csv, .json, .tar, .xml, .bin"

在版本 RELEASE.2024-03-15T01-07-19Z 中變更:指定 "*" 可指示 MinIO 壓縮所有支援的檔案類型。

MinIO 不支援壓縮 排除的檔案類型 清單上的檔案類型,即使在此引數中明確指定也是如此。

壓縮 MIME 類型

MINIO_COMPRESSION_MIME_TYPES
compression mime_types

可選

以逗號分隔的要壓縮的 MIME 類型列表。設定新的類型列表會取代先前設定的列表。預設值為 "text/*, application/json, application/xml, binary/octet-stream"

預設排除檔案

某些類型的檔案無法顯著縮減大小。即使在 mime_types 參數中指定,MinIO 也不會壓縮這些檔案。詳細資訊請參閱排除的類型

註解

此設定沒有環境變數選項。請改用組態設定。

compression comment

可選

指定要與資料壓縮組態關聯的註解。

Erasure Stripe 大小

MINIO_ERASURE_SET_DRIVE_COUNT

此設定沒有組態設定選項。

可選

要套用於給定 伺服器池中所有磁碟機的Erasure Set 大小

如果您設定此值,您必須在初始化叢集之前執行此操作。選定的 stripe 大小在叢集初始化後是不可變的,並且會影響未來新增到叢集的任何伺服器池。

MinIO SUBNET 使用者應登入並提出問題,以便在任何環境中實作 stripe 大小設定之前討論這些設定。

警告

除非 MinIO 工程團隊指示,否則請勿變更 stripe 大小設定。

變更 stripe 大小會對部署功能、可用性、效能和行為產生重大影響。MinIO 的 stripe 選擇演算法為大多數工作負載設定適當的預設值。從此預設值變更 stripe 大小是不尋常的,而且通常不必要或不建議。

物件版本上限

MINIO_API_OBJECT_MAX_VERSIONS
api object_max_versions

可選

定義每個物件允許的預設最大版本數。

預設情況下,MinIO 允許每個物件最多使用 Int64 的最大值版本,或超過 920 萬兆。

注意

MinIO 從 RELEASE.2023-08-04T17-40-21Z``to ``RELEASE.2024-03-26T22-10-45Z 的版本預設限制為 10,000 個物件版本。此設定可用於將該限制覆寫為其他值。

每個物件任意高的版本數可能會導致某些操作的效能下降,例如 LIST。這在執行預算型硬體或旋轉磁碟機 (HDD) 的系統上尤其如此。每個物件產生數千個或更多版本的應用程式或工作負載可能需要設計或架構審查,以減輕潛在的效能下降。

設定不超過 100 的限制應為大多數典型使用案例提供足夠的版本。