部署 MinIO：單節點單硬碟

此頁面上的程序涵蓋在單節點單硬碟 (SNSD) 設定中部署 MinIO，以用於早期開發和評估。SNSD 部署使用零同位刪除碼後端，除了底層儲存磁碟區實作的功能之外，不提供額外的可靠性或可用性。這些部署最適合用於本機測試和評估，或用於沒有可用性或效能要求的小型資料工作負載。

重要

RELEASE.2022-10-29T06-21-33Z 完全移除已淘汰的閘道/檔案系統後端。如果 MinIO 啟動並偵測到現有的檔案系統後端檔案，則會傳回錯誤。

若要從 FS 後端部署遷移，請使用 mc mirror 或 mc cp 將您的資料複製到新的 MinIO SNSD 部署。您也應該在 SNSD 部署上重新建立任何必要的使用者、群組、原則和儲存貯體設定。

既有資料

MinIO 啟動行為取決於指定儲存磁碟區或路徑的內容。伺服器會檢查 MinIO 內部後端資料以及現有資料夾和檔案的結構。下表列出可能的儲存磁碟區狀態和 MinIO 行為

儲存磁碟區狀態	行為
空的，沒有檔案、資料夾或 MinIO 後端資料	MinIO 在 SNSD 模式下啟動，並建立零同位後端
現有的 SNSD 零同位物件和 MinIO 後端資料	MinIO 在 SNSD 模式下繼續執行
現有的檔案系統資料夾、檔案，但沒有 MinIO 後端資料	MinIO 會傳回錯誤，且不會啟動
現有的檔案系統資料夾、檔案和舊版「FS 模式」後端資料	MinIO 會傳回錯誤，且不會啟動在版本 RELEASE.2022-10-29T06-21-33Z 中變更。

先決條件

儲存需求

以下需求總結了 MinIO 硬體建議的儲存章節

使用本機儲存

直接連接儲存 (DAS) 比網路儲存 (網路附加儲存NAS、儲存區域網路SAN、網路檔案儲存NFS) 具有顯著的效能和一致性優勢。MinIO 強烈建議主要或「熱」資料使用快閃儲存 (NVMe、SSD)。

使用 XFS 格式化磁碟

MinIO 強烈建議為儲存佈建 XFS 格式化的磁碟。MinIO 使用 XFS 作為內部測試和驗證套件的一部分，在所有規模下都能提供對效能和行為的額外信心。

在重新開機時保持磁碟掛載和映射

使用 /etc/fstab 以確保在節點重新開機時，磁碟到掛載點的映射保持一致。

非 Linux 作業系統應使用等效的磁碟掛載管理工具。

對磁碟的獨佔存取權

MinIO **需要**對用於物件儲存的磁碟或磁碟區具有*獨佔*存取權。沒有其他程序、軟體、腳本或人員應該直接對提供給 MinIO 的磁碟或磁碟區，或 MinIO 放置在其上的物件或檔案執行*任何*動作。

除非 MinIO 工程部門指示，否則不要使用腳本或工具直接修改、刪除或移動所提供磁碟上的任何資料分片、同位分片或元數據檔案，包括從一個磁碟或節點到另一個磁碟或節點。此類操作很可能導致廣泛的損壞和資料遺失，超出 MinIO 的修復能力。

記憶體需求

在版本 RELEASE.2024-01-28T22-35-53Z 中變更： MinIO 在啟動時會預先分配 2GiB 的系統記憶體。

MinIO 建議每個主機*至少* 32GiB 的記憶體。有關 MinIO 中記憶體分配的更多指南，請參閱記憶體。

部署單節點單磁碟 MinIO

以下程序部署由單一 MinIO 伺服器和單一磁碟或儲存磁碟區組成的 MinIO。

網路檔案系統磁碟區會破壞一致性保證

MinIO 嚴格的**寫後讀取**和**寫後列出**一致性模型需要本機磁碟檔案系統。

如果底層儲存磁碟區是 NFS 或類似的網路附加儲存磁碟區，MinIO 無法提供一致性保證。

1) 下載 MinIO 伺服器

從以下 URL 下載 MinIO 可執行檔
https://dl.min.io/server/minio/release/windows-amd64/minio.exe
下一步包括執行可執行檔的說明。您無法從檔案總管執行可執行檔，或透過按兩下檔案來執行。相反地，您需要呼叫可執行檔以啟動伺服器。

2) 準備 MinIO 的資料路徑

請確保資料路徑是空的，並且不包含任何現有檔案，包括任何隱藏或 Windows 系統檔案。

如果指定非 MinIO 專用的磁碟，請考慮建立一個專用的資料夾來儲存 MinIO 資料，例如 D:/Minio。

3) 啟動 MinIO 伺服器

開啟命令提示字元或 PowerShell，並輸入以下命令以啟動該工作階段中的 MinIO SNSD 部署

minio.exe server D:/minio --console-address ":9001"

輸出應如下所示

Status:         1 Online, 0 Offline.
API: http://192.168.2.100:9000  http://127.0.0.1:9000
Console: http://192.168.2.100:9001 http://127.0.0.1:9001

Command-line: https://minio.dev.org.tw/docs/minio/linux/reference/minio-mc.html
   $ mc alias set myminio http://10.0.2.100:9000 minioadmin minioadmin

Documentation: https://minio.dev.org.tw/docs/minio/linux/index.html

API 區塊會列出客戶端可以存取 MinIO S3 API 的網路介面和連接埠。Console 區塊會列出客戶端可以存取 MinIO Web Console 的網路介面和連接埠。

4) 連線至 MinIO 伺服器

MinIO 主控台

您可以透過在您慣用的瀏覽器中輸入 MinIO 伺服器 Console 區塊中的任何主機名稱或 IP 位址來存取 MinIO Console，例如 https://127.0.0.1:9001。

使用在指定給容器的環境檔案中設定的 MINIO_ROOT_USER 和 MINIO_ROOT_PASSWORD 登入。

MinIO Console displaying Buckets view in a fresh installation

您可以使用 MinIO Console 來執行一般管理工作，例如身分和存取管理、指標和日誌監控或伺服器設定。每個 MinIO 伺服器都包含其自己的嵌入式 MinIO Console。

如果您的本機主機防火牆允許外部存取 Console 連接埠，則同一網路上的其他主機可以使用您本機主機的 IP 或主機名稱來存取 Console。

MinIO CLI (mc)

您可以使用 MinIO Client (mc) 透過終端機或 Shell 存取 MinIO 部署。請參閱MinIO Client 安裝快速入門，以取得有關安裝 mc 的說明。

建立對應於 MinIO 部署的新 別名。指定 MinIO 伺服器 API 區塊中的任何主機名稱或 IP 位址，例如 https://127.0.0.1:9000。

mc alias set myminio https://127.0.0.1:9000 myminioadmin minio-secret-key-change-me

將 myminio 替換為要用於別名的所需名稱。
將 myminioadmin 替換為指定給容器的環境檔案中的 MINIO_ROOT_USER 值。
將 minio-secret-key-change-me 替換為指定給容器的環境檔案中的 MINIO_ROOT_PASSWORD 值。

然後，您可以使用任何 mc 命令與容器互動。如果您的本機主機防火牆允許外部存取 MinIO S3 API 連接埠，則同一網路上的其他主機可以使用您本機主機的 IP 或主機名稱來存取 MinIO 部署。