Manage a domain name

Last Updated: Dec 26, 2017

After uploading an object to a bucket, you can obtain an object address including two parts: an OSS domain name address (<BucketName>.<Endpoint>) and an object file name. To avoid possible cross-origin or security problems in your business, we recommend that you access OSS using a user-defined domain name. After the domain name is successfully bound, you also need to add a CNAME record pointing to the Internet domain name of the bucket to guarantee proper domain name-based access to the OSS.


  • You must apply for an ICP license for your bound domain name. Otherwise, the domain name is not accessible.
  • Each bucket can be bound with a maximum of 20 domain names.

After a user-defined domain name is successfully bound, access addresses of the files stored in your OSS uses the user-defined domain name. For example, if your bucket test-1-001 is located at the Hangzhou node, the object file name is test001.jpg, and the bound user-defined domain name is, then the access address of this object is as follows:

  • Before binding:
  • After successful binding:

Bind a domain name

  1. Go to the OSS console.

  2. On the left-side navigation pane, select a bucket from the bucket list to open the bucket overview page.

  3. Click the Domain Names tab.

  4. Click Bind User Domain to open the Bind User Domain dialog box.

  5. Bind your domain.

    1. In the User Domain textbox, enter your domain name.
    2. If you need CDN acceleration, open the Alibaba Cloud CDN switch. For more information, see CDN-based OSS acceleration.
    3. If you want to add a CNAME record automatically, open the Add CNAME Record Automatically switch.

      Note: If the domain name has completed cloud resolution under another Alibaba Cloud account, then a CNAME record cannot be automatically added for this domain name under your account. In this case, you must add a CNAME record manually. For more information, see the Procedure for domain name resolution section.

  6. Click Submit.

    Note: If the domain name you want to bind has been maliciously bound by another user, the system message Domain name conflict is displayed. You can verify the ownership of the domain name by adding a TXT record. In this way, the domain name can be forcibly bound to the correct bucket and its binding to the previous bucket is released. For detailed procedure, see the Procedure for verifying domain name ownership section.

Procedure for verifying domain name ownership

  1. Click Obtain TXT. The system generates a TXT record based on your information.

  2. Log on to your DNS provider and add the corresponding TXT record.

  3. In the OSS console, click I have added the TXT verification file. Continue submission. If the system detects that the TXT record value for this domain name is as expected, the domain name ownership passes verification.

Procedure for domain name resolution

  1. Go to the Alibaba Cloud console.
  2. From the left-side navigation pane, click Alibaba Cloud DNS to enter the domain name resolution list page.
  3. Click the Configure link corresponding to the target domain name.
  4. Click Add Record.
  5. In the Add Record dialog box, select CNAME from the Type drop-down box, , and enter the Internet domain name of the bucket in the Value text box.
  6. Click Confirm.
Thank you! We've received your feedback.