在 macOS 掛載 MinIO — 用 NetDrive 存取自架 S3 儲存空間

你的團隊上季在裸機上架設了一套 MinIO 叢集。DevOps 工程師對 mc CLI 和 S3 SDK 十分熟悉，但設計師和專案經理不是——他們只想從 assets 儲存桶開啟 PSD 檔案，而不必開工單找 IT。NetDrive 會將 MinIO 儲存桶直接對應到 macOS Finder，讓儲存桶看起來就像一顆 USB 隨身碟，不會妨礙任何人。

在 Finder 中瀏覽 MinIO 儲存桶——無需 CLI

NetDrive 讓 Google Drive、OneDrive、S3、SFTP、WebDAV 等在 Windows 與 macOS 上顯示為原生磁碟機 — 不需同步，也不需完整下載。

• 適用於任何 MinIO 執行個體：本機虛擬機、裸機或雲端託管
• 自 NetDrive 3.14 起原生支援 Apple Silicon——無 Rosetta 額外開銷
• 非同步上傳讓應用程式保持流暢，傳輸在背景執行

WindowsmacOS

下載 macOS 版 NetDrive →

免費試用。提供終身與訂閱方案。

連線前的準備事項

MinIO 提供相容於 S3 的 API，因此 NetDrive 會透過 Amazon S3 提供者搭配自訂端點來存取它。在開啟 NetDrive 之前，請先準備好以下資訊：

• 存取金鑰與秘密金鑰——從 MinIO 主控台的 Identity → Service Accounts 取得，或由你的 MinIO 管理員提供。
• 端點網址——你的 MinIO API 連接埠的基礎網址。若為本機伺服器：http://192.168.1.50:9000。若為終止 TLS 的部署：https://minio.example.com。
• 儲存桶名稱——可在 MinIO 主控台的 Buckets 分頁看到。
• 地區——除非你的 MinIO 執行個體設定了自訂地區，否則請使用 us-east-1。MinIO 會忽略此值，但 S3 用戶端必須傳送它。

NetDrive 3.18 及後續版本要求 macOS 14（Sonoma）或更高版本。自 3.14.309 版起，Apple Silicon 版 Mac 可原生執行 NetDrive，不需要相容層。

將 NetDrive 連線至 MinIO

點選選單列上的 NetDrive 圖示（畫面頂端的雲朵圖示），選擇 Open Drive Manager：

1. 點選 + 新增磁碟機。
2. 從提供者清單中選擇 Amazon S3——MinIO 使用相同的 API。
3. 在 Endpoint 欄位輸入你的 MinIO 伺服器基礎網址：http://192.168.1.50:9000 或 https://minio.example.com。此處不需輸入儲存桶名稱。
4. 將你的 MinIO Access Key 與 Secret Key 貼入對應欄位。
5. 將 Region 設為 us-east-1（若你在 MinIO 中明確設定了其他地區，則改用該地區）。
6. 點選 Connect。NetDrive 會連上你的 MinIO 伺服器並取得儲存桶清單。
7. 選擇要掛載的儲存桶，並點選 OK。
8. 為磁碟機命名——例如 MinIO Assets——並將 Auto Mount 設為 At Login，以取得持續可用的存取。
9. 點選 Mount。

該儲存桶會出現在 Finder 側邊欄的 Locations 底下，與 AirDrop 或網路共用項目並列。將檔案拖進去、雙擊開啟，其餘的都交給 Finder 處理。

TLS 與路徑樣式定址

有兩項設定細節最常讓 MinIO 部署卡關：

自簽憑證。 如果你的 MinIO 伺服器使用 macOS 不認可的憑證（在家用實驗室與內部部署中很常見），連線就會出現 TLS 交握錯誤。最乾淨的解法是將你的內部 CA 加入 macOS 鑰匙圈：開啟 Keychain Access，選擇 File → Import Items，匯入該 CA 憑證，並將其標記為 Always Trust。或者，若僅為純本機流量，也可以在端點欄位輸入 http:// 改用 HTTP。

路徑樣式儲存桶定址。 MinIO 預設採用路徑樣式定址（http://server:9000/bucket-name），而非虛擬主機樣式（http://bucket-name.server:9000）。NetDrive 的 S3 相容提供者預設同樣採用路徑樣式，因此兩者無需額外設定即可對齊。如果你的 MinIO 部署改用虛擬主機樣式，請確認你已有一個符合 *.minio.example.com 的萬用字元 DNS，並相應更新端點設定。

大型檔案與分段上傳

對於存放大型物件的儲存桶——虛擬機快照、資料庫轉存檔、未壓縮影片——以下兩項設定能提升可靠性：

非同步上傳模式。 在磁碟機管理員中右鍵點選 MinIO 磁碟機，選擇 Properties → Upload Mode → Async。你的應用程式會立即收到寫入成功的回應，而 NetDrive 會將實際上傳作業排入背景佇列，逐一送往 MinIO。選單列圖示會顯示即時進度，你也可以取消個別傳輸而不影響其他仍在進行的上傳。

分段上傳閾值。 對於超過 5 GB 的物件，NetDrive 會使用 S3 分段上傳，此功能於 3.5.434 版引入。一份 20 GB 的資料庫快照會以平行區塊方式上傳，而非單一序列串流，這在連接遠端 MinIO 伺服器時常見的 VPN 或 WAN 連線上更具韌性。

結語

MinIO 相容於 S3 的 API 讓它能無縫接軌任何支援 S3 的工具——包括 NetDrive。一旦掛載完成，該儲存桶的行為就如同一般資料夾：Finder 預覽功能正常運作，Spotlight 可以為檔名建立索引，任何應用程式都不需要知道這些儲存空間其實位於另一台伺服器上。

同一套 S3 提供者路徑也適用於其他相容 S3 的服務。端點差異請參閱在 macOS 掛載 Wasabi；若你的團隊同時使用 MinIO 與官方託管的 AWS 服務，也可參閱在 macOS 掛載 Amazon S3。

— Steve, NetDrive