对象存储在兼容 S3 的第三方应用中使用 COS 的通用配置

Amazon Simple Storage Service（Amazon S3，下文简称 S3）是 AWS 最早推出的云服务之一，经过多年的发展，S3 协议在对象存储行业事实上已经成为标准。腾讯云对象存储（Cloud Object Storage，COS）提供了兼容 S3 的实现方案，因此您可以在大部分兼容 S3 应用中直接使用 COS 服务。本文将重点介绍如何将此类应用配置为使用 COS 服务。
准备工作
确认应用是否可以使用 COS 服务
如果您在应用的说明中看到类似S3 Compatible字样，那么大多数情况可以使用 COS 服务。如果您在实际使用过程中发现应用的某些功能无法正常使用，您可以 联系我们。联系时，请说明您是从该文档中看到的指引，并提供相关应用的名称和截图等信息，以便我们可以更快地帮您解决问题。
如果您的应用只说明支持Amazon S3，这表明该应用可以使用 S3 服务，但能否使用 COS 服务，还需要在相关的配置中进一步尝试，本文也会在后续的配置说明中做进一步的说明。
准备 COS 服务
步骤1：注册腾讯云账号
（如果已在腾讯云注册，可忽略此步骤。）
﻿
步骤2：完成实名认证
（如果已完成，可忽略此步骤。）
﻿
详细认证流程，请参见实名认证介绍。
步骤3：开通 COS 服务
﻿
步骤4：准备 APPID 和访问密钥
在访问管理控制台的 API 密钥管理 页面中获取并记录 APPID、SecretId 和 SecretKey。详情请参见 主账号访问密钥管理。
步骤5：创建存储桶
参见 创建存储桶 创建一个存储桶。
部分应用内置创建存储桶的过程，如果您希望由应用去创建存储桶，您可以忽略此步骤。
在应用中配置 COS 服务
基本配置
大部分应用在配置使用的存储服务时，都有类似的配置项，下面列举这些配置项的常见名称及相关说明：
说明：
如果您在配置过程中有任何疑问，也可以 联系我们。联系时，请说明您是从该文档中看到的指引，并提供相关应用的名称和截图等信息，以便我们可以更快地帮您解决问题。
配置项的常见名称
相关说明
提供商/服务提供商/存储服务提供商/Service Provider/Storage Provider/Provider 等
这里主要是选择应用应使用哪种存储，可能存在以下几种情况：
如果该选项中有类似 S3 兼容存储/S3 Compatible 等字样的选项，那么优先使用这个选项。
如果只有 amazon web services/AWS/Amazon S3 等字样，那么先使用这个选项，在后面的服务端点/服务地址/服务 URL/Endpoint/Custom Endpoint/Server URL 等配置中，需留意这些配置项的相关说明。
如果没有类似选项，但是在应用的说明中有提到支持 S3 服务或 S3 兼容服务，那么您可以继续后面的服务端点/服务地址/服务 URL/Endpoint/Custom Endpoint/Server URL 等配置，且需留意这些配置项的相关说明。
如果是其他情况，很抱歉，该应用可能不能使用 COS 服务。
服务端点/服务地址/服务 URL/Endpoint/Custom Endpoint/Server URL 等
这里用于填写 S3 兼容服务的服务地址，在使用 COS 服务时，这里填写 COS 的服务地址，形式为：
cos.<Region>.myqcloud.com或https://cos.<Region>.myqcloud.com。
是否需要填写https://，根据具体的应用有所不同，您可以自行尝试。其中<Region>代表 COS 的 可用地域。
在应用中，您只能在服务地址中指定的地域创建或选择存储桶。
例如您的存储桶在广州地域，那么服务地址应当配置为cos.ap-guangzhou.myqcloud.com，如果您配置成其他地域，那么在应用中您无法找到广州地域下的存储桶。
如果应用的服务提供商中只能选择Amazon S3，并且服务端点是可以配置的，那么您可以将服务端点修改为前述的cos.<Region>.myqcloud.com或https://cos.<Region>.myqcloud.com。
如果服务端点是不可配置的或没有服务端点配置项，那么您的应用不能使用 COS 服务。
Access Key/Access Key ID 等
这里填写 步骤4 中记录的 SecretId。
Secret Key/Secret/Secret Access Key 等
这里填写 步骤4 中记录的 SecretKey。
地域/Region 等
选择默认、自动、Auto 或 Automatic。
存储桶/Bucket 等
选择或输入现有的存储桶名称，格式为<BucketName-APPID>，例如examplebucket-1250000000，其中 BucketName 为 步骤5 中创建存储桶时填写的存储桶名称，APPID 为 步骤4 中记录的APPID。如上文所描述，这里的存储桶将限定在服务地址所指定的地域中，其他地域的存储桶将不会被列出或无法正常使用。如果您需要创建新的存储桶，那么新创建的存储桶名字也需要符合前面所讲的<BucketName-APPID> 格式，否则就无法正常创建存储桶。
其他项与高级配置说明
部分应用除了上述基本配置外，还有一些其他项与高级配置，下面将提供部分 COS 的功能说明，以便您更好地在应用中使用 COS 服务。
服务端口与协议
COS 服务支持 HTTP 协议和 HTTPS 协议，均使用协议默认的80和443端口，基于安全考虑，我们建议您优先通过 HTTPS 协议使用 COS 服务。
COS 支持 Virtual Hosted Style 风格。
注意：
2024年1月1日后创建的存储桶，不支持使用 path-style 域名，仅支持使用 virtual-hosted-style 域名。此前已创建的存储桶不受影响，但建议您优先使用 virtual hosted style 域名。
AWS V2 签名与 AWS V4 签名
COS 同时支持两种签名格式。
结语
COS 不保证与 S3 的完全兼容，如果您在应用中使用 COS 服务时遇到任何问题，您可以 联系我们。联系时，请说明您是从该文档中看到的指引，并提供相关应用的名称和截图等信息，以便我们可以更快地帮您解决问题。
当然，COS 不仅提供以上应用和服务，还提供多款热门开源应用，并集成腾讯云 COS 插件，欢迎点击 “此处” 一键启动，立即使用！

配置项的常见名称	相关说明
提供商/服务提供商/存储服务提供商/Service Provider/Storage Provider/Provider 等	这里主要是选择应用应使用哪种存储，可能存在以下几种情况：如果该选项中有类似 S3 兼容存储/S3 Compatible 等字样的选项，那么优先使用这个选项。如果只有 amazon web services/AWS/Amazon S3 等字样，那么先使用这个选项，在后面的服务端点/服务地址/服务 URL/Endpoint/Custom Endpoint/Server URL 等配置中，需留意这些配置项的相关说明。如果没有类似选项，但是在应用的说明中有提到支持 S3 服务或 S3 兼容服务，那么您可以继续后面的服务端点/服务地址/服务 URL/Endpoint/Custom Endpoint/Server URL 等配置，且需留意这些配置项的相关说明。如果是其他情况，很抱歉，该应用可能不能使用 COS 服务。
服务端点/服务地址/服务 URL/Endpoint/Custom Endpoint/Server URL 等	这里用于填写 S3 兼容服务的服务地址，在使用 COS 服务时，这里填写 COS 的服务地址，形式为： `cos.<Region>.myqcloud.com`或`https://cos.<Region>.myqcloud.com`。是否需要填写`https://`，根据具体的应用有所不同，您可以自行尝试。其中`<Region>`代表 COS 的可用地域。在应用中，您只能在服务地址中指定的地域创建或选择存储桶。例如您的存储桶在广州地域，那么服务地址应当配置为`cos.ap-guangzhou.myqcloud.com`，如果您配置成其他地域，那么在应用中您无法找到广州地域下的存储桶。如果应用的服务提供商中只能选择`Amazon S3`，并且服务端点是可以配置的，那么您可以将服务端点修改为前述的`cos.<Region>.myqcloud.com`或`https://cos.<Region>.myqcloud.com`。如果服务端点是不可配置的或没有服务端点配置项，那么您的应用不能使用 COS 服务。
Access Key/Access Key ID 等	这里填写步骤4 中记录的 SecretId。
Secret Key/Secret/Secret Access Key 等	这里填写步骤4 中记录的 SecretKey。
地域/Region 等	选择默认、自动、Auto 或 Automatic。
存储桶/Bucket 等	选择或输入现有的存储桶名称，格式为`<BucketName-APPID>`，例如`examplebucket-1250000000`，其中 `BucketName` 为步骤5 中创建存储桶时填写的存储桶名称，`APPID` 为步骤4 中记录的`APPID`。如上文所描述，这里的存储桶将限定在服务地址所指定的地域中，其他地域的存储桶将不会被列出或无法正常使用。如果您需要创建新的存储桶，那么新创建的存储桶名字也需要符合前面所讲的`<BucketName-APPID>` 格式，否则就无法正常创建存储桶。

在兼容 S3 的第三方应用中使用 COS 的通用配置

本页目录：

准备工作

确认应用是否可以使用 COS 服务

准备 COS 服务

步骤1：注册腾讯云账号

步骤2：完成实名认证

步骤3：开通 COS 服务

步骤4：准备 APPID 和访问密钥

步骤5：创建存储桶

在应用中配置 COS 服务

基本配置

其他项与高级配置说明

结语