本文介绍如何使用自定义域名绑定。

OSS支持用户将自定义的域名绑定到OSS服务上,这样能够支持用户无缝地将存储迁移到OSS上。例如用户的域名是example.com,之前用户的所有图片资源都是形如http://img.example.com/x.jpg的格式,用户将图片存储迁移到OSS之后,通过绑定自定义域名,仍可以使用原来的地址访问到图片:

  • 开通OSS服务并创建Bucket。
  • 修改域名的DNS配置,增加一个CNAME记录,将img.example.com指向OSS服务的endpoint(如my-bucket.oss-cn-hangzhou.aliyuncs.com)。
  • 官网控制台将img.example.com与创建的Bucket绑定。
  • 将图片上传到OSS的这个Bucket中。

这样就可以通过原地址http://img.example.com/x.jpg访问到存储在OSS上的图片。 绑定自定义域名请参见自定义域名绑定

在使用SDK时,也可以使用自定义域名作为endpoint,这时需要将cname参数设置为true,如下面的例子:

let OSS = require('ali-oss')

let client = new OSS({
  endpoint: '<Your endpoint>'
  accessKeyId: '<Your AccessKeyId>',
  accessKeySecret: '<Your AccessKeySecret>',
  cname: true
});
注意 自定义域名已经绑定到某个特定的Bucket,因此使用CNAME时无法使用list_buckets接口。