After you upload objects to a bucket, OSS automatically generates URLs that include
the public endpoint of the bucket for the uploaded objects. You can use these URLs
to access the objects. If you want to access the objects by using custom domain names
(CNAMEs), you must bind the custom domain names to the bucket in which the objects
are stored.
Procedure
- Bind a custom domain name to a bucket.
- Log on to the OSS console.
- In the left-side navigation pane, click Buckets. On the Buckets page, click the name of the bucket to which you want bind the custom
domain name.
- In the left-side navigation pane, choose .
- Click Bind Custom Domain Name.
- In the Bind Custom Domain Name panel, enter the domain name that you want to bind in the Custom Domain Name field.
Domain names that contain wildcards are not supported. Example:
*.example.com
.
If a domain name conflict message appears, the domain name is already bound to another
bucket. To resolve this issue, you can use another domain name or verify the ownership
of the domain name and forcibly bind the domain name to the bucket. This operation
unbinds the domain name from the previous bucket. For more information, see Verify the ownership of a domain name.
- Add a CNAME record.
- If the domain name is managed by your Alibaba Cloud account, perform the following
steps to automatically add a CNAME record.
- In the Bind Custom Domain Name panel, turn on Add CNAME Record Automatically.
Notice If a CNAME record has already been added for the domain name that you bind to the
bucket, the original CNAME record is overwritten.
- Click Submit.
- If the domain name is not managed by your Alibaba Cloud account, manually add a CNAME
record.
If your domain name is not managed by Alibaba Cloud DNS, you must configure the DNS
of your DNS provider.
Alibaba Cloud DNS is used in this example to describe how to manually add a CNAME
record for a domain name that is not owned by the current Alibaba Cloud account.
- Log on to the Alibaba Cloud DNS console.
- On the Manage DNS page, click Configure in the Actions column corresponding to the domain name to which you want to add a
CNAME record.
- On the DNS Settings page, click Add Record. In the Add Record dialog box, configure parameters listed in the following table.
Parameter |
Description |
Type |
Select the type of the record. In this example, select CNAME.
|
Host |
Enter the host record based on the prefix of the domain name.
- To add a top-level domain such as
aliyun.com , enter @.
- To add a second-level domain, enter the prefix of the second-level domain name. Example:
If the domain is
abc.aliyun.com , enter abc.
- To map all second-level domains to the public endpoint of the bucket, enter *.
|
ISP Line |
Select the ISP line used to resolve the domain name. We recommend that you select
Default to allow the system to select the optimal line.
|
Value |
Enter the public endpoint of the bucket. |
TTL |
Select the update interval of the record. In this example, keep the default value. |
- Click OK.
A new CNAME record takes effect immediately. A modified CNAME record requires up to
72 hours to take effect.
Verify CNAME status
You can run the ping or lookup command to check the status of an added CNAME. If the request is redirected to *.oss-cn-*.aliyuncs.com
, the CNAME is in effect.
Verify the ownership of a domain name
If a domain name conflict message appears, you can verify the ownership of the domain
name and forcibly bind the domain name to the bucket.
- Click Obtain TXT.
OSS randomly generates a token for the domain name, which includes the following fields:
Domain,
Host, and
Value. You must record the values of the fields.

- Add a CNAME record to the DNS of your DNS provider. Enter the recorded values of the
Host and Value fields and keep the default settings of other parameters.
- In the Bind Custom Domain Name panel, read and select I have added the TXT record. Continue submission.
If your configuration is correct, OSS binds the custom domain name to the bucket.
Unbind a domain name
You can unbind a custom domain name from a bucket when you no longer use it.
- On the Overview page of the bucket from which you want to unbind the custom domain
name, choose .
- On the Domain Names tab, click Manage Binding Configurations in the Actions column corresponding to the domain name that you want to unbind.
- In the Manage Binding Configurations panel, click Unbind. Click OK.
References
- To improve the experience in uploads and downloads, you can bind an accelerate endpoint
to the bucket. For more information, see Bind accelerate endpoints.
- To use HTTPS to access a custom domain name, you must upload your HTTPS certificate
in the OSS console. For more information, see Host SSL certificates.