在 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 端点 URL ——本地或局域网实例通常是 http://your-server:9000,若在反向代理后面则是 https://minio.yourdomain.com。MinIO 的默认 API 端口是 9000;控制台运行在 9001 上,NetDrive 不连接这个端口。
  • Access Key 和 Secret Key ——在 MinIO 控制台的 Identity → Service Accounts 下创建一个服务账户,或用 mc admin user svcacct add 生成一个。请使用服务账户而非根凭证,并将其权限限定到特定存储桶以实现最小权限访问。
  • 存储桶名称 ——NetDrive 在存储桶级别进行连接。如果你想暴露多个存储桶,需要在 NetDrive 中为每一个添加单独的驱动器。
  • 已安装 NetDrive,支持 Windows 8、8.1、10 或 11。点此下载安装程序。

MinIO 的现代版本默认使用路径风格寻址,这也是 NetDrive 用于 S3 兼容服务商的模式。如果你的 MinIO 版本早于 RELEASE.2022-10-08,请确认路径风格访问没有在你的 MinIO 配置中被显式禁用(MINIO_API_REQUESTS_MAX 及虚拟托管相关设置)。

在 Windows 上将 NetDrive 连接到 MinIO

打开 NetDrive,在驱动器管理器中点击 + 按钮添加新驱动器。从服务商列表中选择 Amazon S3 ——MinIO 使用的是 S3 API,因此对于包括 MinIO、Wasabi 及其他自托管方案在内的所有 S3 兼容存储,这都是正确的选项。

填写连接字段:

  • Access Key ID:你的 MinIO 访问密钥
  • Secret Access Key:你的 MinIO 私密密钥
  • Region:填写 us-east-1 ——MinIO 会忽略此值,但该字段不能为空
  • Endpoint:你的 MinIO API URL,例如 http://192.168.1.50:9000 或 https://minio.example.com
  • Bucket:要挂载的具体存储桶,例如 build-artifacts

启用 Path style(在某些 NetDrive 版本中标注为 Force path style)。像 bucket.minio.example.com 这样的虚拟托管风格 URL 需要 DNS 记录支持,而自托管的 MinIO 通常没有配置这类记录。路径风格——即存储桶以路径组成部分的形式出现,如 minio.example.com/bucket——才是这里需要的方式。

点击 Test 验证连通性。出现绿色对勾即表示 NetDrive 能够连接到 MinIO 并完成身份验证。如果测试失败,最常见的原因是防火墙屏蔽了 9000 端口、HTTPS 端点使用了自签名证书,或访问密钥缺少对目标存储桶的 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 命令行工具(自 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

← 全部文章 在论坛讨论 →