在 Windows 上掛載 MinIO — NetDrive S3 相容儲存設定指南

閱讀時間 6 分鐘 provider-guide minio windows
Steve
SteveSenior Engineer
逐步教學:使用 NetDrive 將 MinIO儲存桶掛載為 Windows 磁碟機。直接從 Windows 檔案總管瀏覽你的私有 S3 相容物件儲存。

你為團隊的建置產物架設了 MinIO 叢集——兩太位元組的測試素材、Docker 層快取和每夜匯出,全都放在你自己掌控的硬體上。現在你希望每位 Windows 開發者都能開啟一個熟悉的磁碟機代號,直接在檔案總管中拖放檔案,而不必安裝 MinIO 自己的用戶端或把一切包進腳本裡。NetDrive 能俐落地做到這件事:它連接到 MinIO 的 S3 相容 API,並在幾秒內把儲存桶呈現為原生磁碟機。

NetDrive drive manager showing Google Drive, S3 and pCloud mounted as drive lettersMounted clouds appearing as native drives in Windows File Explorer

將 MinIO 掛載為 Windows 磁碟機

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

  • S3 相容連線——適用於任何 MinIO 端點
  • 直接在 Windows 檔案總管瀏覽儲存桶與物件
  • 背景上傳並即時追蹤進度
WindowsmacOS
下載 NetDrive →

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

開始前你需要準備的東西

在開啟 NetDrive 之前先備妥以下項目:

  • MinIO 端點網址——本機或區域網路執行個體通常是 http://your-server:9000,若在反向代理後方則是 https://minio.yourdomain.com。MinIO 預設的 API 連接埠是 9000;管理主控台跑在 9001,NetDrive 連接的不是這個。
  • Access Key 與 Secret Key——在 MinIO Console 的 Identity → Service Accounts 底下建立服務帳戶,或用 mc admin user svcacct add 產生一組。請使用服務帳戶而非根憑證,並將其範圍限縮到特定儲存桶以符合最小權限原則。
  • 儲存桶名稱——NetDrive 是以儲存桶層級進行連線。若要公開多個儲存桶,需在 NetDrive 中為每一個各自新增一個磁碟機。
  • 已在 Windows 8、8.1、10 或 11 上安裝 NetDrive在此下載安裝程式

MinIO 的新版本預設使用路徑樣式定址,這也正是 NetDrive 用於 S3 相容供應商的模式。若你的 MinIO 版本早於 RELEASE.2022-10-08,請確認路徑樣式存取未在 MinIO 設定中被明確停用(MINIO_API_REQUESTS_MAX 與虛擬主機樣式設定)。

在 Windows 上將 NetDrive 連接到 MinIO

開啟 NetDrive,在磁碟機管理員中按一下 + 按鈕以新增磁碟機。從供應商清單中選擇 Amazon S3——MinIO 說的是 S3 API,因此對於所有 S3 相容儲存(包括 MinIO、Wasabi 及其他自架方案)來說,這都是正確的選項。

填入連線欄位:

  • Access Key ID:你的 MinIO access key
  • Secret Access Key:你的 MinIO secret key
  • Region:輸入 us-east-1——MinIO 會忽略這個值,但欄位不能留空
  • Endpoint:你的 MinIO API 網址,例如 http://192.168.1.50:9000https://minio.example.com
  • Bucket:要掛載的特定儲存桶,例如 build-artifacts

啟用 Path style(依你的 NetDrive 版本,有時標示為 Force path style)。像 bucket.minio.example.com 這樣的虛擬主機樣式網址需要 DNS 項目,而自架 MinIO 通常不會有這些設定。路徑樣式——即儲存桶以路徑元件形式出現,例如 minio.example.com/bucket——才是你這裡要用的方式。

按一下 Test 以驗證連線。綠色勾號代表 NetDrive 能連接到 MinIO 並成功驗證身分。若測試失敗,最常見的原因是防火牆封鎖了 9000 連接埠、HTTPS 端點使用自簽憑證,或是該 access key 在目標儲存桶上缺少 s3:ListBucket 權限。

NetDrive 磁碟機管理員顯示多個雲端磁碟機,包含掛載在 Windows 上的 S3 相容儲存

指派磁碟機代號與自動掛載

連線測試通過後,捲動到 Mount 區塊:

  1. Drive letter——選一個尚未使用的代號。對於共用工作站,像 M:(代表 MinIO)這樣的團隊慣例能讓各機器保持一致。
  2. Mount type——若需完整讀寫存取請選 Network drive,若這個儲存桶存放的是不該從工作站修改的參考資料集,請選 Read-only drive
  3. Auto-mount 選項:
    • On login——磁碟機會在使用者登入 Windows 後出現。適合開發人員的工作站。
    • On boot——磁碟機會在登入前掛載,適用於以系統帳戶執行、需要在啟動時從 MinIO 讀取資料的排程工作或服務。
    • Disabled——需從磁碟機管理員手動掛載。適合不常存取的儲存桶。

按一下 Mount(播放)按鈕。幾秒之內,Windows 檔案總管就會顯示新的磁碟機代號。瀏覽進去,你會看到 MinIO 儲存桶的頂層資料夾與物件,就像它們是本機檔案一樣。

MinIO 儲存桶內容以已掛載的磁碟機代號顯示在 Windows 檔案總管中

在 Windows 檔案總管中操作檔案

拖放上傳的運作完全如預期。NetDrive 會在背景排入傳輸佇列,並透過系統匣圖示回報進度。對於超過 5 GB 的物件,NetDrive 會自動切換為 S3 分段上傳——大型產物包或資料集檔案不需要額外設定。

如果有其他程序在你瀏覽時寫入該儲存桶——例如 CI 流水線推送新的測試素材——磁碟機列表可能不會立即更新。在檔案總管中對已掛載的磁碟機按右鍵,從 NetDrive 的右鍵選單選擇 Force folder refresh,即可取得最新的目錄列表。

若要用於腳本或 CI 執行器存取,nd3cmd CLI 工具(自 NetDrive 3.8.921 起提供)讓你能從命令列掛載與卸載磁碟機,在需要以建置腳本而非圖形介面自動化連線時相當實用。

背景上傳進度顯示多個檔案正傳輸到 MinIO 儲存

總結

在備妥憑證的情況下,把 MinIO 連接到 Windows 上的 NetDrive 只需三到五分鐘。同樣的 S3 相容連線方式也適用於其他自架或代管的 S3 相容儲存——Wasabi、Backblaze B2 及其他服務——因此這套設定模式可隨你的儲存陣容擴展。若要在 macOS 上進行對應操作,請參閱在 macOS 上以 NetDrive 掛載 MinIO。若是要用正牌 AWS S3,在 Windows 上以 NetDrive 掛載 Amazon S3 涵蓋了區域選擇與 IAM 憑證設定。

— Steve, NetDrive