tencent cloud

文档反馈

存储桶切换自定义域名

最后更新时间:2024-07-05 18:37:28

    背景

    为保证整体服务的安全性和稳定性,2024年1月1日后创建的存储桶,若使用 COS 默认域名访问对象,任意类型文件不支持预览,apk/ipa 类型文件不支持下载。详情可参考 COS 存储桶域名使用安全管理通知
    
    2024年1月1日后创建的存储桶,若您希望通过浏览器直接预览文件或下载存储桶内的 apk/ipa 类型对象,建议用户使用自定义域名访问对象。2024年1月1日前创建的存储桶,存储桶默认域名的预览、下载行为不受影响,但为了获得更好的服务稳定性,建议用户优先使用自定义域名。
    
    本文介绍如何为存储桶配置自定义域名,从访问存储桶默认域名切换为访问自定义域名。
    

    第一步:域名注册与备案

    首先,用户需要准备一个已备案的自定义域名。
    域名注册:您如果没有自定义域名,可前往 域名注册 购买域名。
    域名备案:如果您的自定义域名用于配置到中国大陆地域的存储桶,则必须经过备案。

    第二步:为存储桶配置自定义域名

    1. 准备好自定义域名后, 登录 对象存储控制台,进入存储桶列表,选择您需要配置的存储桶。
    2. 进入存储桶详情页面,选择域名与传输管理 > 自定义源站域名
    3. 单击添加域名,配置域名信息:
    域名:输入准备好的自定义域名。
    源站类型:分为以下几种。
    默认源站:如果您希望将自定义域名用作默认源站,请选择默认源站。
    静态网站源站:如果您希望将自定义域名用作静态网站,请先为存储桶开启静态网站功能,然后选择静态网站源站。
    全球加速源站:如果您希望将自定义域名用作全球加速,请先为存储桶开启全球加速功能,然后选择全球加速源站。
    4. 配置 HTTPS 证书。如果需要使用 HTTPS 协议访问,需要为自定义域名配置证书。
    如果您需要使用自有证书,需要将证书内容和私钥内容粘贴到指定输入框。
    如果您使用的是腾讯云申请的证书,可直接在弹窗中选择当前账号下已有的腾讯云证书。
    5. 自定义域名配置完成后,记录 CNAME 一栏的信息(例如 bucket-1250000000.cos.ap-beijing.myqcloud.com),用于后续配置域名解析。

    第三步:配置域名解析

    腾讯云域名

    如果域名 DNS 厂商是腾讯云,可以前往 云解析 DNS 控制台,配置 CNAME 解析记录。
    
    1. 前往 云解析 DNS 控制台,找到对应的域名,单击解析按钮。
    2. 单击快速添加解析,为该域名添加一条解析记录。
    3. 在弹窗中,选择网站解析,网站地址选择域名映射(CNAME)。输入第二步记录的 CNAME 信息输入,例如 bucket-1250000000.cos.ap-beijing.myqcloud.com。
    4. 解析记录需要一定时间生效,可以通过 dig 命令或 对象存储控制台 查看解析是否成功更生效。验证方法如下:
    在命令行窗口输入命令:dig mydomain.com,查看 CNAME 记录是否正确生效。(使用时请将mydomain.com替换为自定义域名)
    
    
    
    登录 对象存储控制台,查看存储桶自定义域名,如果域名的 CNAME 没有成功生效,会出现相应提示。
    
    
    

    其他厂商域名

    如果域名 DNS 厂商不是腾讯云,需要前往相应的 DNS 服务配置 CNAME 解析记录。

    第四步:访问自定义域名

    经过上述步骤,完成了自定义域名的配置。下面说明如何使用自定义域名访问 COS。

    查看对象访问链接

    1. 登录 对象存储控制台 ,找到已配置自定义域名的存储桶,并单击进入文件列表。选择一个对象,进入对象详情。操作指引请参见 查看对象信息
    2. 切换指定域名为自定义源站域名,下方的对象地址、临时链接会相应切换为自定义域名的链接,访问公有读对象可以使用对象地址(无签名),访问私有读对象可以使用临时链接(有签名)。

    API 访问切换自定义域名

    对于直接使用 API 访问 COS 的用户,只需要在访问时将请求 Host 修改为自定义域名即可。
    GET /<0bjectKey> HTTP/1.1
    Host: <BucketName-APPID>.cos.<Region>.myqcloud.com # 替换为用户的自定义域名
    Date: GMT Date
    Authorization: Auth String

    SDK 访问切换为自定义域名

    对于使用 SDK 的用户,只需要在初始化 Client 时将 domain 参数设置为自定义域名即可。以 Python SDK 为例,代码示例如下。
    domain = 'user-define.example.com' # 用户自定义域名
    config = CosConfig(Region=region, SecretId=secret_id, SecretKey=secret_key, Token=token, Domain=domain, Scheme=scheme)
    client = CosS3Client(config)
    各语言 COS SDK 切换自定义域名的代码示例可参考以下文档:
    Go SDK
    JAVA SDK
    PHP SDK
    iOS SDK
    JS SDK
    .NET SDK
    C++ SDK
    
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持