有奖捉虫:办公协同&微信生态&物联网文档专题 HOT

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 400 Bad Request

<?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日后创建的存储桶,用户需要为存储桶配置自定义域名,才能正常预览文件。自定义域名配置请参考 开启自定义源站域名