path-style 域名相关问题
1. COS 存储桶是否支持使用 path-style 域名？
为保证整体服务的安全性和稳定性，2024年1月1日后创建的存储桶不支持使用 path-style 域名，2024年1月1日前创建的存储桶不受影响，支持继续使用 path-style 域名，但建议您优先使用 virtual-hosted-style 域名。详情请参见 COS 存储桶域名使用安全管理通知。 2. 如何判断我是否在使用 path-style 域名？
方法一：通过对象 URL 或者访问域名判断。
path-style 域名形如：cos.<Region>.myqcloud.com/<BucketName-APPID>。
virtual-hosted-style 域名形如：<BucketName-APPID>.cos.<Region>.myqcloud.com。
方法二：通过日志判断，path-style 请求的日志记录符合以下条件。
eventSource 字段：访问域名格式形如 cos.<Region>.myqcloud.com，例如 cos.ap-guangzhou.myqcloud.com。
eventName 字段：事件名称不是 GetService。
3. 使用 SDK 如何从 path-style 域名切换为 virtual-hosted-style 域名？
COS 小程序、JavaScript、Node.js 、Android、iOS SDK 支持使用 path-style 域名。以小程序 SDK 为例，切换的操作步骤如下：
第一步，SDK 实例化时，将 ForcePathStyle:true 修改为 ForcePathStyle:false，或去掉该参数。例如：
new COS({ ForcePathStyle: false })
new COS({})
第二步，针对小程序 SDK，还需要在微信开放平台配置存储桶域名 <BucketName-Appid>.cos.<Region>.myqcloud.com 为白名单域名。
4. 2024年1月1日后新增存储桶使用 path-style 域名访问将如何报错？
报错请求示例如下。
GET /bucket-125000000/test.txt HTTP/1.1
Host: cos.ap-guangzhou.myqcloud.com
HTTP/1.1 403 Forbidden
<?xml version="1.0" encoding="UTF-8"?>
<Error>
<Code>PathStyleDomainForbidden</Code>
<Message>The bucket you are attempting to access must be addressed using COS virtual-styled domain.</Message>
</Error>
默认域名预览、下载能力相关问题
1. COS 存储桶默认域名支持在浏览器预览对象、下载 apk/ipa 类型的文件吗？
为保证整体服务的安全性和稳定性，2024年1月1日后创建的存储桶，若使用 COS 默认域名（包括存储桶默认域名、静态网站域名、全球加速域名）访问对象，任意类型文件不支持预览，apk/ipa 类型文件不支持下载。详情请参见 COS 存储桶域名使用安全管理通知。 2024年1月1日后创建的存储桶，若用户使用默认域名访问对象，COS 会在返回头部中增加以下两个 Header，因此使用默认域名无法在浏览器直接预览文件。
x-cos-force-download：true
Content-Disposition: attachment
2024年1月1日后创建的存储桶，若用户使用默认域名访问 apk/ipa 类型文件（文件后缀为 .apk 或 .ipa），下载请求将返回报错。错误信息示例如下：
HTTP/1.1 403 Forbidden
<?xml version="1.0" encoding="UTF-8"?>
<Error>
<Code>DownloadForbidden</Code>
<Message>The APK/IPA file is not allowed to be distributed in a public network using COS default domain, please use custom domain instead.</Message>
</Error>
2. 2024年1月1日前创建的存储桶，使用默认域名是否支持浏览器预览和 apk/ipa 下载？
2024年1月1日前创建的存储桶默认域名不受影响，但建议您优先使用自定义域名。
3. 受影响的默认域名包括哪些？
COS 服务直接提供的存储桶域名、静态网站域名、全球加速域名均受到影响。
|
存储桶域名 | <Bucket-Appid>.cos.<Region>.myqcloud.com |
静态网站域名 | <Bucket-Appid>.cos-website.<Region>.myqcloud.com |
全球加速域名 | <Bucket-Appid>.cos.accelerate.myqcloud.com |
4. CDN 域名是否支持浏览器预览，apk/ipa 类型文件是否支持下载？
腾讯云 CDN
如果使用腾讯云 CDN 且源站配置为 COS 存储桶， CDN 域名的预览、下载行为不会受到影响，CDN 域名能够正常下载 apk/ipa 类型的文件。
第三方 CDN
第三方 CDN 服务回源 COS 存储桶，如果源站配置的是 COS 默认域名，会受到影响。
5. 内网访问默认域名是否支持浏览器预览，apk/ipa 类型文件是否支持下载？
内网访问不受影响。
6. 自定义域名是否支持在浏览器预览，apk/ipa 类型文件是否支持下载？
支持。
7. 2024年1月1日后创建的存储桶，如何在浏览器正常预览文件？
2024年1月1日后创建的存储桶，用户需要为存储桶配置自定义域名，才能正常预览文件。自定义域名配置请参见 开启自定义源站域名。 此外，用户还需要为该文件指定正确的 Content-Type 头部，同时 Content-Disposition 的参数值不能为 attachment，当浏览器支持当前文件的格式时，浏览器会直接打开该文件，而不是直接下载。
8. 静态网站的使用是否会受到影响？
由于2024年1月1日后创建的存储桶，使用默认域名（包括静态网站域名）访问预览行为会受到限制。因此，静态网站的索引文档、错误文档等功能均会受到较大影响。
为正常使用静态网站功能，您需要为存储桶配置自定义域名，并设置源站为静态网站。详情请参见 开启自定义源站域名。 9. 2024年1月1日后创建的存储桶，如何正常下载 apk/ipa 文件？
2024年1月1日后创建的存储桶，用户需要为存储桶配置自定义域名，才能正常下载文件。自定义域名配置请参见 开启自定义源站域名。