文件(Object)上传至存储空间(Bucket)后,OSS会自动生成文件URL,您可以直接通过文件URL访问该文件。如果您希望通过自定义域名访问这些文件,需要将自定义域名绑定至文件所在的Bucket,并添加CNAME记录。
前提条件
使用限制
- 每个存储空间最多可以绑定100个域名。一个域名只能绑定在一个存储空间上,每个账号可绑定的域名个数无限制。
- 通过OSS管理控制台绑定自定义域名时,不允许绑定泛域名。通过CDN服务加速OSS时,允许绑定泛域名,但该域名不会在OSS管理控制台显示。
注意事项
您可以通过绑定自定义域名满足以下使用场景。
- 对于2019年09月23日以后在中国内地创建的Bucket,需确保通过浏览器访问Bucket内的图片文件时是预览而非下载行为。
- 将Bucket配置成静态网站时,需确保正确访问静态网站页面,而非下载静态网页。
自定义域名使用规则
例如华东1(杭州)有名为examplebucket的Bucket,其根目录下有名为exampleobject.jpg的公共读Object,绑定的自定义域名为
www.example.com
。则绑定自定义域名前后的访问方式如下:
- 绑定前
使用Bucket默认域名访问exampleobject.jpg,访问地址为
https://examplebucket.oss-cn-hangzhou.aliyuncs.com/exampleobject.jpg
。 - 绑定后
使用自定义域名访问exampleobject.jpg,访问地址为
https://www.example.com/exampleobject.jpg
。说明 绑定自定义域名后,通过文件URL访问图片时,如果图片仍然无法预览而是以附件的形式下载,则原因可能是浏览器对于部分图片格式不支持预览。您只需要在浏览器上安装支持预览对应格式文件的插件即可。
使用OSS控制台
观看以下视频可快速了解如何绑定自定义域名:
验证CNAME配置是否生效
您可以通过ping或lookup命令测试您添加的域名,如果被转向*.oss-cn-*.aliyuncs.com
,即表示CNAME配置已经生效。

验证域名所有权
如果待绑定的自定义域名不是当前阿里云账号下的域名或者是通过其他厂商注册的域名,您需要通过验证域名所有权来绑定该域名。
解除域名绑定
当您的自定义域名不再使用时,可以手动解除域名绑定。
- 在目标Bucket管理页面,单击 。
- 在域名列表中,单击目标域名右侧的域名绑定配置。
- 在域名绑定配置面板,单击解除绑定,然后单击确定。
更多参考
- 如果您希望获得更好的上传、下载体验,需绑定传输加速域名。具体步骤,请参见绑定传输加速域名。
- 如果您希望通过静态网页访问OSS资源,需设置静态网站托管。具体步骤,请参见设置静态网站托管和使用自定义域名设置静态网站托管。
- 如果您希望使用HTTPS协议访问自定义域名,需在OSS控制台上传您的HTTPS证书。具体步骤,请参见证书托管。