Ошибки аутентификации Tencent Cloud COS: решение — NetDrive
NetDrive не подключается к бакету Tencent Cloud COS? Проверьте пару SecretId/SecretKey, права CAM, эндпоинт региона, имя бакета и системные часы, затем переподключитесь.
Игровая студия хранит ночные сборки в бакете Tencent Cloud Object Storage (COS), а рабочая станция Windows руководителя QA монтирует этот бакет через NetDrive, чтобы тестировщики забирали свежую сборку прямо с буквы диска. Затем проверка безопасности ротирует все API-ключи в аккаунте, и на следующее утро диск отказывается подключаться. Большинство сбоев аутентификации Tencent Cloud сводится к пяти причинам: пара ключей, права CAM за ней, эндпоинт региона, имя бакета или часы компьютера. Это руководство проверяет их именно в таком порядке.

Верните свой диск Tencent Cloud
NetDrive показывает Google Drive, OneDrive, S3, SFTP, WebDAV и другие хранилища как обычные диски в Windows и macOS — без синхронизации и полной загрузки файлов.
- Монтируйте бакеты COS как диск в Windows или macOS
- Drive Manager показывает состояние каждого диска
- Измените учётные данные и переподключитесь без настройки с нуля
Бесплатный пробный период. Доступны бессрочная лицензия и подписка.
Сопоставьте ошибку с вероятной причиной
NetDrive поддерживает Tencent Cloud с версии 3.17.799 и проверяет подключение при сохранении диска Tencent Cloud. Если что-то не так, вы видите сообщение об ошибке, а рабочая карточка диска не появляется. Прочитайте сообщение, прежде чем менять какие-либо поля: коды ошибок COS указывают на разные проблемы.
- SignatureDoesNotMatch — SecretKey не соответствует SecretId, или одно из значений вставлено с лишними символами.
- InvalidAccessKeyId — Tencent Cloud не знает такой SecretId. Он удалён, отключён или введён с опечаткой.
- AccessDenied — ключ действителен, но у пользователя, которому он принадлежит, нет доступа к этому бакету.
- NoSuchBucket — имя бакета или регион не соответствуют существующему бакету.
- RequestTimeTooSkewed — часы компьютера слишком расходятся со временем Tencent Cloud, и подписанный запрос не принимается.
Запишите код. Если исправлять по одному полю и проверять после каждого изменения, вы поймёте, какое из них было причиной.

Проверка 1: пара SecretId и SecretKey
API-ключи Tencent Cloud управляются в консоли Tencent Cloud в разделе CAM → API Keys. После ротации ключей наиболее вероятная причина — пара, сохранённая в NetDrive.
- Откройте список API-ключей пользователя, ключ которого использует NetDrive.
- Убедитесь, что SecretId, сохранённый в NetDrive, всё ещё есть в списке и включён.
- Если он удалён или отключён, создайте новый ключ и сразу скопируйте SecretId и SecretKey.
- Вставьте оба значения в настройки диска Tencent Cloud в NetDrive. Следите за пробелом в начале или в конце: в поле он не виден, но ломает подпись.
Если при ротации был удалён и субпользователь CAM, ключ исчез вместе с ним. Перед созданием нового ключа проверьте, что пользователь ещё существует.
Проверка 2: права CAM на бакет
Ответ AccessDenied при действительном ключе означает, что проблема в политике, а не в ключе. Для монтирования используйте субпользователя CAM, а не ключ корневой учётной записи, и выдайте ему доступ к монтируемому бакету. В Tencent Cloud есть готовые политики, например QcloudCOSReadOnlyAccess и QcloudCOSFullAccess, или можно написать собственную политику, ограниченную одним бакетом.
Подберите политику под то, как используется диск. Политика только для чтения позволяет тестировщикам просматривать и копировать сборки, но любое сохранение на диск завершится ошибкой. Если такое поведение нужно намеренно, смонтируйте диск ещё и с типом «только для чтения» в NetDrive. Тогда ограничение будет явно видно в Проводнике или 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 с консолью посимвольно.

Проверка 4: системные часы
Каждый запрос к COS подписывается с отметкой времени. Если часы компьютера ушли на несколько минут, Tencent Cloud отклонит запрос, даже если ключ идеален. Чаще всего это случается на машинах, которые долго были офлайн, или на ВМ, восстановленных из старого снимка. В Windows откройте Settings → Time & language → Date & time и синхронизируйте сейчас. В macOS включите Set time and date automatically в System Settings → General → Date & Time.
Переподключите диск
После исправления неверного значения:
- Open NetDrive и найдите диск Tencent Cloud в Drive Manager.
- Откройте настройки диска и обновите пару ключей, эндпоинт или бакет.
- Сохраните и дайте NetDrive снова проверить подключение.
- Подключите диск из его карточки и откройте файл, чтобы убедиться, что чтение работает. Затем сохраните небольшой тестовый файл, чтобы убедиться, что работает запись.
Если правка существующей записи по-прежнему не помогает, удалите диск и добавьте его заново со значениями, которые вы только что проверили в консоли. Новая запись исключает устаревшие сохранённые настройки.
Аутентификация проходит, но диск всё ещё ведёт себя странно
Если подключение успешно, а диск в Windows так и не появляется, возможно, эту букву диска уже занимает другое устройство. См. Ошибка «буква диска уже используется»: решение. Если после переподключения в папках видны вчерашние сборки, список устарел. Принудительное обновление папок объясняет, как получить свежий.
Итоги
Разбирайте ошибку аутентификации Tencent Cloud COS по чек-листу: пара ключей, политика CAM, эндпоинт региона, имя бакета с APPID и, наконец, часы. Меняйте по одному параметру и переподключайтесь из Drive Manager. Полную первоначальную настройку см. в статье Монтирование Tencent Cloud в Windows с NetDrive или в версии для macOS. Если вы также используете Alibaba Cloud, Ошибки аутентификации Alibaba Cloud: решение следует той же схеме.
— Steve, NetDrive