在 macOS 上挂载腾讯云 COS — NetDrive
使用 NetDrive 3.18+ 将腾讯云对象存储挂载为原生 macOS 驱动器的分步指南。直接在 Finder 中浏览和编辑 COS 存储桶。
你在腾讯云对象存储中存放了数以 GB 计的资源,需要在 Finder 中直接访问它们——不是通过网页控制台,也不是通过 CLI 工具,而是作为一个真正的驱动器,可以随意拖入拖出文件。NetDrive 从 3.17.799 版本开始原生支持腾讯云,配合 macOS 14 Sonoma 及以上版本,你就能获得一个像本机其他卷一样运作的 COS 存储桶。
直接在 Finder 中挂载腾讯云 COS
NetDrive 让 Google Drive、OneDrive、S3、SFTP、WebDAV 等在 Windows 和 macOS 上显示为本地驱动器 — 无需同步，无需完整下载。
- 将 COS 存储桶作为本地驱动器浏览和编辑 — 无需同步
- 可与 Google Drive、S3、Dropbox 等同时使用
- 原生支持 Apple Silicon,macOS 14 Sonoma 及以上版本
免费试用。提供终身与订阅方案。
开始前需要准备什么
在打开 NetDrive 之前,先从腾讯云控制台收集以下三项信息:
- SecretId — 你的 API 访问密钥标识(相当于访问密钥 ID)
- SecretKey — 对应的密钥凭证
- 存储桶名称和地域 — 例如地域
ap-guangzhou下的project-assets-1234567890
登录腾讯云 CAM 控制台,在 Access Management → API Keys 下查找或创建一对 API 密钥。不要使用根账号凭证,建议创建一个仅具备 COS 权限的子账号——只读访问用 QcloudCOSReadOnlyAccess,如需对特定存储桶进行写入访问则使用自定义策略。NetDrive 会将凭证存储在 macOS 钥匙串中,但限制 API 密钥的权限范围仍然是值得的,以防将来需要轮换密钥。
macOS 版本说明: 腾讯云支持从 NetDrive 3.17.799 版本引入。如果你使用的是 macOS 14 Sonoma 或更高版本,需要 NetDrive 3.18 或更高版本(Sonoma 仅从 3.18 起获得支持)。使用 macOS 13 Ventura 的用户可以使用 NetDrive 3.17 及以下版本。
添加腾讯云为驱动器
- 打开 NetDrive,在驱动器管理器中点击 +(添加驱动器)按钮。
- 在提供商列表中选择 Tencent Cloud。
- 在凭证字段中输入你的 SecretId 和 SecretKey。
- 将 Region 设置为与存储桶所在地域一致——例如华南地区用
ap-guangzhou,新加坡用ap-singapore,北美地区用na-ashburn。设置错误会导致连接错误,而不是静默挂载一个空驱动器,所以请在腾讯云 COS 控制台中仔细核对地域。 - 可选择输入具体的 Bucket name,将单个存储桶挂载为驱动器根目录。留空则浏览该账号下的所有存储桶。
- 指定一个驱动器名称(这将成为 Finder 中
/Volumes/下显示的卷名)。 - 点击 Connect。
连接成功后,该存储桶会作为已挂载的卷出现在 Finder 和侧边栏中。你可以直接打开文件——用预览应用打开图片、用 Numbers 打开电子表格、用任意编辑器打开文本文件——并将更改直接保存回 COS,无需显式的上传步骤。文件按需获取;NetDrive 不会把整个存储桶下载到你的 Mac 上。
性能与大文件
NetDrive 不会将整个存储桶下载到你的 Mac——你以已挂载卷的形式浏览内容,只有你明确打开或下载的文件才会被传输。上传会在后台自动进行;你无需手动管理上传参数或拆分大文件。
大型存储桶的目录列表在首次打开时可能需要几秒钟。如果你的存储桶根目录以扁平结构存放了数万个对象,将它们按前缀(伪文件夹)组织到 COS 端会显著提升浏览速度——NetDrive 会将前缀渲染为文件夹,其列出速度远快于包含 5 万个文件的扁平目录。
如果连接后立即看到 403 Access Denied,很可能是该 API 密钥缺少所需的 COS 读取或写入权限。如果驱动器已挂载但尽管存储桶中有内容却显示为空,地域设置是最常见的原因——请核实它与 COS 控制台中该存储桶显示的地域完全一致。
设置登录时自动挂载
在 NetDrive 中打开该驱动器的设置,将 Mount Timing 设为 On Login。此后,每次登录 macOS 时,COS 驱动器都会自动出现在 Finder 中。如果你需要驱动器在任何用户登录之前就可用——例如共享 Mac 或作为文件中继的无头 Mac mini——则改为设置成 On Boot。
当驱动器已挂载且可访问时,驱动器管理器会显示绿色指示灯。如果显示为已断开,点击挂载图标手动重新连接,或检查你到 COS 端点的网络访问。
总结
只要手头有 API 密钥对,用 NetDrive 在 macOS 上挂载腾讯云 COS 大约只需两分钟。最终得到的是一个由 COS 存储桶支撑的 Finder 卷——无需单独的同步客户端,无需手动上传队列,也无需切换到网页控制台。
关于 Windows 上的等效设置,其步骤与在 Windows 上挂载阿里云几乎相同,该功能是在同一个 NetDrive 版本中加入的。如果你在使用腾讯 COS 的同时还需要处理 S3 兼容存储,在 macOS 上挂载 Wasabi使用了类似的流程,只是端点设置不同。对于在 CI 流水线中从对象存储读取测试夹具的 DevOps 团队,S3 测试夹具用例所涵盖的模式可以直接套用到腾讯 COS。
— Morgan, NetDrive