Skip to main content

Custom Domain

CloudBase HTTP access service provides automatically generated domains by default. You can also bind custom domains to the CloudBase HTTP access service.

Important Note

Default domain is recommended for testing environments only. For production environments, it's recommended to bind custom domains to ensure business security and stability.

Prerequisites​

Before starting to configure custom domains, please ensure the following preparations are complete:

  1. Domain Filing: Prepare custom domain and complete ICP filing. For details, refer to ICP Filing Page. For cloud resources required for filing, refer to Filing Cloud Resources
  2. SSL Certificate: Prepare SSL certificate, which can be uploaded in SSL Certificate Console

Add Custom Domain​

  1. Go to CloudBase Console/HTTP Access Service
  2. Click "Add Domain"
  3. Fill in custom domain and configure SSL certificate
  4. Select CDN type

Add Custom Domain Entry

CDN Type Selection​

When creating a custom domain, you can choose from the following three CDN types:

  • No CDN: Suitable for cloud run or cloud function services that don't require CDN
  • CloudBase CDN: Suitable for static hosting or custom applications, the system will automatically configure CDN acceleration service for you
  • Custom CDN: When CloudBase CDN cannot meet your needs, you can use Custom CDN to accelerate your services
Note

This CDN is used for HTTP associated resource calls. If you want to add CDN for cloud storage, please refer to Cloud Storage Custom CDN

CloudBase CDN Configuration Process​

Step 1: Add Custom Domain in CloudBase Console​

Add custom domain in CloudBase Console/HTTP Access Service and select CloudBase CDN

Step 2: Wait for Domain Association to Complete​

After adding custom domain in CloudBase console, you need to wait for domain association to complete. It usually takes 3-5 minutes. After successful domain association, copy the CNAME value.

Step 3: Go to DNS Console and Add CNAME Resolution​

Using the CNAME value copied in step 2, go to your domain DNS service provider to add CNAME record. Request will be routed to CDN only after adding CNAME record and the domain will take effect. Go to DNS Console to add domain resolution record.

Step 4: Complete CloudBase CDN Access​

Return to CloudBase console and check custom domain access status

Note

If custom domain access status is not updated, you can refresh the page and check again.

Custom CDN Configuration Process​

Step 1: Add Custom Domain in CloudBase Console​

Add custom domain in CloudBase Console/HTTP Access Service, select Custom CDN, and copy the origin domain

Step 2: Add CDN Domain​

Go to CDN Console and click "Add Domain".

Step 3: CDN Domain Configuration​

1. Configure Origin Domain: Add domain configuration, paste the origin domain copied in step 1 into the origin domain address.

Note

Please independently select acceleration region and acceleration type based on business type.

2. Fill in Recommended Configuration: Improve acceleration performance.

Note

If no additional configuration is needed, this step can be skipped.

3. Add CNAME Resolution: Copy the CNAME value in CDN console, go to DNS console to add CNAME type resolution.

Note

DNS resolution needs to be added in the corresponding domain service provider console as CNAME resolution record.

4. Complete Configuration: Complete custom CDN configuration

Step 4: Verify CDN Domain Access​

After adding CNAME record, it usually takes 5-30 minutes for DNS resolution to take effect. Return to CloudBase console to check custom CDN access status. You can check whether domain resolution has taken effect using the following command:

nslookup Your Custom Domain

If the result shows the CNAME domain provided by CloudBase, then the resolution has taken effect.

Domain Ownership Verification​

To confirm that you actually own the domain, you can choose any of the following methods for domain ownership verification:

Method 1: Configure Domain CNAME Resolution Record​

Set your domain's CNAME to the domain provided in CloudBase console.

For example, if your domain is foo.com, you can set the domain's CNAME record to foo.com.cdn.dnsv1.com.

Method 2: Configure Domain TXT Resolution Record​

Set your domain's TXT resolution record to the CloudBase environment ID it belongs to.

For example, if your domain is foo.com and environment ID is bar-12345, you can set the TXT record of foo.com to bar-12345.

Method 3: Configure Specific Subdomain TXT Resolution Record​

Set the TXT resolution record of your domain's specific subdomain _cloudbase-challenge to the CloudBase environment ID it belongs to.

For example, if your domain is foo.com and environment ID is bar-12345, you can set the TXT record of _cloudbase-challenge.foo.com to bar-12345.

Tencent Cloud DNS Setup Method​

If your DNS service provider is Tencent Cloud, you can add CNAME records following these steps:

1. Enter Domain Resolution

Log in to Domain Service Console, find the target domain in the domain list, and click "Resolution" in the operation column.

2. Add Resolution Record

On the resolution page, click "Add Record".

3. Configure Resolution Record

Configure resolution record parameters:

  • Host Record: Fill in domain prefix (e.g.: @)
  • Record Type: Select CNAME
  • Record Value: Fill in CNAME value
  • Click "Save" to complete configuration
Tip

There are priority differences between different record types for domain resolution. When the host record is the same, different record types on the same line cannot coexist, otherwise conflicts will be prompted. CNAME records conflict with any record type except CNAME records, and other records need to be deleted before configuration. For details, please refer to Why does it prompt "record conflict" when adding resolution records.

Usage Restrictions​

  • Each CloudBase environment can bind up to 5 custom domains
  • Custom domains must have completed ICP filing
  • Domain resolution takes time to take effect, please be patient