解决 Tencent Cloud COS 认证错误 — NetDrive

阅读时间 6 分钟 troubleshooting tencent-cloud
Steve
SteveSenior Engineer
NetDrive 无法连接到 Tencent Cloud COS 存储桶?检查 SecretId/SecretKey 密钥对、CAM 权限、地域端点、存储桶名称和系统时钟,然后重新连接。

一家游戏工作室把夜间构建产物保存在 Tencent Cloud Object Storage(COS)存储桶中,QA 负责人的 Windows 工作站通过 NetDrive 挂载该存储桶,测试人员可以直接从盘符获取最新构建。随后一次安全审查轮换了账号下的所有 API 密钥,第二天早上驱动器拒绝连接。Tencent Cloud 认证失败大多归结为五个因素:密钥对、其背后的 CAM 权限、地域端点、存储桶名称,以及电脑的时钟。本指南按这个顺序逐一检查。

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

找回你的 Tencent Cloud 驱动器

NetDrive 让 Google Drive、OneDrive、S3、SFTP、WebDAV 等在 Windows 和 macOS 上显示为本地驱动器 — 无需同步,无需完整下载。

  • 在 Windows 或 macOS 上将 COS 存储桶挂载为驱动器
  • Drive Manager 显示每个驱动器的状态
  • 无需从头配置,编辑凭据后即可重新连接
WindowsmacOS
下载 NetDrive →

免费试用。提供终身与订阅方案。

根据错误判断可能原因

NetDrive 从 3.17.799 版本开始支持 Tencent Cloud,并在你保存 Tencent Cloud 驱动器时检查连接。出现问题时,你会看到错误消息,且不会生成可用的驱动器卡片。在修改任何字段之前先阅读消息,因为不同的 COS 错误代码指向不同的问题:

  • SignatureDoesNotMatch — SecretKey 与 SecretId 不匹配,或者其中一个值粘贴时带了多余字符。
  • InvalidAccessKeyId — Tencent Cloud 无法识别该 SecretId。它已被删除、禁用或输入有误。
  • AccessDenied — 密钥有效,但拥有该密钥的用户无权访问此存储桶。
  • NoSuchBucket — 存储桶名称或地域与实际存在的存储桶不一致。
  • RequestTimeTooSkewed — 电脑时钟与 Tencent Cloud 时间相差过大,签名请求无法被接受。

把错误代码记下来。每次只改一个字段并在改完后测试,你就能知道是哪一项导致了问题。

NetDrive Drive Manager 列出云驱动器及其连接状态

检查 1:SecretId 与 SecretKey 密钥对

Tencent Cloud API 密钥在 Tencent Cloud 控制台的 CAM → API Keys 中管理。密钥轮换之后,NetDrive 中保存的密钥对是最可能的原因。

  1. 打开 NetDrive 所用密钥对应用户的 API 密钥列表。
  2. 确认 NetDrive 中保存的 SecretId 仍在列表中且处于启用状态。
  3. 如果已被删除或禁用,创建新密钥并立即复制 SecretId 和 SecretKey。
  4. 将两个值粘贴到 NetDrive 中 Tencent Cloud 驱动器的设置里。注意开头或结尾的空格。它在字段中不可见,却会破坏签名。

如果轮换过程中 CAM 子用户也被删除,密钥会随之消失。创建新密钥之前,先确认该用户仍然存在。

检查 2:存储桶的 CAM 权限

密钥有效却返回 AccessDenied,说明问题出在策略而非密钥。挂载时请使用 CAM 子用户而不是主账号的密钥,并授予其对所挂载存储桶的访问权限。Tencent Cloud 提供 QcloudCOSReadOnlyAccess、QcloudCOSFullAccess 等预设策略,你也可以编写仅限单个存储桶的自定义策略。

策略要与驱动器的用途相匹配。只读策略允许测试人员浏览和复制构建,但向驱动器保存的每次操作都会失败。如果这正是你想要的行为,请同时使用 NetDrive 的只读驱动器类型进行挂载。这样限制会在 Explorer 或 Finder 中清楚呈现,而不只是表现为写入失败。参见 NetDrive 中的只读驱动器。

检查 3:地域端点与存储桶名称

COS 端点按地域划分,格式为 cos.<region>.myqcloud.com,例如 cos.ap-guangzhou.myqcloud.com 或 cos.ap-singapore.myqcloud.com。在广州创建的存储桶不会响应新加坡端点的请求,由此产生的错误可能看起来像凭据失败。请在控制台打开存储桶的概览页面并从那里复制地域,不要凭记忆填写。

COS 中的存储桶名称总是带有账号的 APPID 后缀:是 build-artifacts-1250000001,而不是 build-artifacts。漏掉后缀是 NoSuchBucket 的常见原因。请逐字符比较 NetDrive 中的名称与控制台中的名称。

在 NetDrive 中修正设置后检查驱动器的挂载状态

检查 4:系统时钟

每个 COS 请求都带有时间戳签名。如果电脑时钟偏差达到几分钟,即使密钥完全正确,Tencent Cloud 也会拒绝请求。这种情况多见于长时间离线的机器,或从旧快照恢复的虚拟机。在 Windows 上,打开 Settings → Time & language → Date & time 并立即同步。在 macOS 上,在 System Settings → General → Date & Time 中打开 Set time and date automatically。

重新连接驱动器

修正错误的值之后:

  1. Open NetDrive,在 Drive Manager 中找到 Tencent Cloud 驱动器。
  2. 打开驱动器设置,更新密钥对、端点或存储桶。
  3. 保存,让 NetDrive 重新检查连接。
  4. 从驱动器卡片连接,打开一个文件确认读取正常。然后保存一个小的测试文件确认写入正常。

如果编辑现有条目后仍然失败,请删除该驱动器,并用刚在控制台核对过的值重新添加。新条目可以排除任何陈旧的已保存设置。

认证通过但驱动器仍然异常

如果连接成功但驱动器在 Windows 上仍未出现,可能是其他设备已经占用了该盘符。参见解决盘符已被占用的问题。如果重新连接后文件夹里仍显示昨天的构建,说明列表已过期。强制刷新文件夹介绍了如何获取最新列表。

总结

把 Tencent Cloud COS 认证错误当作一份检查清单来处理:密钥对、CAM 策略、地域端点、带 APPID 的存储桶名称,最后是时钟。每次只改一项,并在 Drive Manager 中重新连接。完整的首次设置请参见使用 NetDrive 在 Windows 上挂载 Tencent Cloud 或 macOS 版本。如果你也在使用 Alibaba Cloud,解决 Alibaba Cloud 认证错误遵循相同的思路。

— Steve, NetDrive