核心設定
此頁面涵蓋控制 MinIO 程序核心行為的設定。
您可以透過定義以下方式建立或修改設定
在啟動或重新啟動 MinIO 伺服器之前,在主機系統上設定環境變數。請參閱您的作業系統文件,了解如何定義環境變數。
使用
mc admin config set
設定設定。使用 MinIO 主控台 的 管理員 > 設定 頁面設定設定。
如果您同時定義了環境變數和類似的組態設定,則 MinIO 會使用環境變數值。
某些設定僅具有環境變數或設定,但不能同時具有兩者。
重要
每個組態設定都控制著 MinIO 的基本行為和功能。MinIO 強烈建議在將組態變更應用於生產環境之前,先在較低的環境(例如 DEV 或 QA)中進行測試。
MinIO 伺服器 CLI 選項
可選
設定在啟動 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 讀取/寫入效能與掃描器進程時,管理 掃描器 的最長等待時間。
MinIO 會使用 掃描器 進行 儲存貯體複寫、站點複寫、生命週期管理 和 修復 工作。
有效值包括
|
移除掃描器在讀取/寫入延遲上的等待,允許掃描器以全速和 IOPS 消耗運作。此設定可能會導致讀取和寫入效能降低。 |
---|---|
|
設定較短的掃描器在讀取/寫入延遲上的等待時間,允許掃描器以較高的速度和 IOPS 消耗運作。此設定可能會導致讀取和寫入效能降低。 |
|
設定適中的掃描器在讀取/寫入延遲上的等待時間,允許掃描器以平衡的速度和 IOPS 消耗運作。此設定旨在維持讀取和寫入效能,同時允許進行中的掃描器活動。 |
|
設定中等的掃描器在讀取/寫入延遲上的等待時間,掃描器會以較低的速度和 IOPS 消耗運作。此設定可提供更好的讀取和寫入效能,同時降低掃描器效能。 可能會影響掃描器相依的功能,例如生命週期管理和複寫。 |
|
設定較長的掃描器在讀取/寫入延遲上的等待時間,掃描器會以非常低的速度和 IOPS 消耗運作。此設定會優先考慮讀取和寫入作業,但可能會犧牲掃描器作業的效能。 可能會影響掃描器相依的功能,例如生命週期管理和複寫。 |
批次複寫
資料壓縮
以下章節說明啟用物件資料壓縮的設定。請參閱 資料壓縮,以取得使用這些組態設定的教學。
本章節中的所有設定都屬於下列最上層鍵之下
啟用壓縮
可選
設定為 on
可為新物件啟用資料壓縮。預設為 off
。
啟用或停用資料壓縮不會變更現有物件。
允許加密
可選
設定為 on
可在壓縮物件後對其進行加密。預設為 off
。
加密壓縮的物件可能會危及安全性
MinIO 強烈建議不要加密壓縮的物件。如果您需要加密,請仔細評估可能洩漏有關加密物件內容的資訊的風險。
壓縮副檔名
可選
要壓縮的檔案副檔名清單,以逗號分隔。設定新的檔案副檔名清單會取代先前設定的清單。預設為 ".txt, .log, .csv, .json, .tar, .xml, .bin"
。
在版本 RELEASE.2024-03-15T01-07-19Z 中變更:指定 "*"
可指示 MinIO 壓縮所有支援的檔案類型。
MinIO 不支援壓縮 排除的檔案類型 清單上的檔案類型,即使在此引數中明確指定也是如此。
壓縮 MIME 類型
可選
以逗號分隔的要壓縮的 MIME 類型列表。設定新的類型列表會取代先前設定的列表。預設值為 "text/*, application/json, application/xml, binary/octet-stream"
。
預設排除檔案
某些類型的檔案無法顯著縮減大小。即使在 mime_types
參數中指定,MinIO 也不會壓縮這些檔案。詳細資訊請參閱排除的類型。
Erasure Stripe 大小
可選
要套用於給定 伺服器池中所有磁碟機的Erasure Set 大小。
如果您設定此值,您必須在初始化叢集之前執行此操作。選定的 stripe 大小在叢集初始化後是不可變的,並且會影響未來新增到叢集的任何伺服器池。
MinIO SUBNET 使用者應登入並提出問題,以便在任何環境中實作 stripe 大小設定之前討論這些設定。
警告
除非 MinIO 工程團隊指示,否則請勿變更 stripe 大小設定。
變更 stripe 大小會對部署功能、可用性、效能和行為產生重大影響。MinIO 的 stripe 選擇演算法為大多數工作負載設定適當的預設值。從此預設值變更 stripe 大小是不尋常的,而且通常不必要或不建議。
物件版本上限
可選
定義每個物件允許的預設最大版本數。
預設情況下,MinIO 允許每個物件最多使用 Int64 的最大值版本,或超過 920 萬兆。
注意
MinIO 從 RELEASE.2023-08-04T17-40-21Z``to ``RELEASE.2024-03-26T22-10-45Z
的版本預設限制為 10,000 個物件版本。此設定可用於將該限制覆寫為其他值。
每個物件任意高的版本數可能會導致某些操作的效能下降,例如 LIST
。這在執行預算型硬體或旋轉磁碟機 (HDD) 的系統上尤其如此。每個物件產生數千個或更多版本的應用程式或工作負載可能需要設計或架構審查,以減輕潛在的效能下降。
設定不超過 100
的限制應為大多數典型使用案例提供足夠的版本。
註解
此設定沒有環境變數選項。請改用組態設定。
可選
指定要與資料壓縮組態關聯的註解。