Tencent Cloud EdgeOne DNS Configuration Guide

Overview

The Tencent Cloud EdgeOne DNS provider is used to manage DNS records for non-accelerated domains. After fully hosting your domain with EdgeOne, you can use this provider to manage regular DNS records in addition to acceleration domains.

Difference from EdgeOne Acceleration Domains:

• EdgeOne (Acceleration Domains): Manages origin server IP addresses for edge acceleration domains, primarily used in CDN acceleration scenarios. Use edgeone, edgeone_acc, teo, or teo_acc as the dns parameter value.
• EdgeOne DNS (Non-Acceleration Domains): Manages regular DNS records, similar to traditional DNS resolution services. Use edgeone_dns or edgeone_noacc as the dns parameter value.

Official Links:

• EdgeOne International: https://edgeone.ai
• Official Website: https://cloud.tencent.com/product/teo
• Service Console: https://console.cloud.tencent.com/edgeone

Authentication

SecretId/SecretKey Authentication

Uses Tencent Cloud SecretId and SecretKey for authentication, same as Tencent Cloud DNS.

Same as Tencent Cloud DNS, EdgeOne uses SecretId and SecretKey for authentication. However, the permission requirements are different, and you need to ensure that the account has EdgeOne operation permissions.

Getting Authentication Information

1. Log in to Tencent Cloud Console
2. Visit API Key Management
3. Click "Create Key" button
4. Copy the generated SecretId and SecretKey, keep them secure
5. Ensure the account has EdgeOne operation permissions

{
    "dns": "edgeone_dns",      // Use EdgeOne DNS provider
    "id": "SecretId",          // Tencent Cloud SecretId
    "token": "SecretKey"       // Tencent Cloud SecretKey
}

Permission Requirements

Ensure the Tencent Cloud account has the following permissions:

• QcloudTEOFullAccess: EdgeOne full access permission (recommended)
• QcloudTEOReadOnlyAccess + Custom write permissions: Fine-grained permission control

Permissions can be viewed and configured in Access Management.

Complete Configuration Example

{
    "$schema": "https://ddns.newfuture.cc/schema/v4.1.json", // Format validation
    "dns": "edgeone_dns",                   // EdgeOne DNS provider (non-accelerated domains)
    "id": "your_secret_id",                 // Tencent Cloud SecretId
    "token": "your_secret_key",             // Tencent Cloud SecretKey
    "index4": ["url:http://api.ipify.cn", "public"], // IPv4 address source
    "index6": "public",                     // IPv6 address source
    "ipv4": ["ddns.newfuture.cc"],          // IPv4 domains
    "ipv6": ["ipv6.ddns.newfuture.cc"],     // IPv6 domains
    "endpoint": "https://teo.tencentcloudapi.com" // API endpoint
}

Parameter Description

Parameter	Description	Type	Value Range/Options	Default	Parameter Type
dns	Provider ID	String	edgeone_dns, teo_dns, edgeone_noacc	None	Provider
id	Authentication ID	String	Tencent Cloud SecretId	None	Provider
token	Authentication Key	String	Tencent Cloud SecretKey	None	Provider
index4	IPv4 Source	Array	Reference	default	Common Config
index6	IPv6 Source	Array	Reference	default	Common Config
ipv4	IPv4 Domains	Array	Domain list	None	Common Config
ipv6	IPv6 Domains	Array	Domain list	None	Common Config
endpoint	API Endpoint	URL	Reference below	https://teo.tencentcloudapi.com	Provider
proxy	Proxy Settings	Array	Reference	None	Common Network
ssl	SSL Verification	Boolean/String	"auto", true, false	auto	Common Network
cache	Cache Settings	Boolean/String	true, false, filepath	true	Common Config
log	Log Configuration	Object	Reference	None	Common Config

Parameter Type Description:

• Common Config: Standard DNS configuration parameters applicable to all supported DNS providers
• Common Network: Network setting parameters applicable to all supported DNS providers
• Provider: Parameters specific to the current provider

endpoint

Tencent Cloud EdgeOne supports domestic and international API endpoints, which can be selected based on region and account type:

Domestic Version

• Default (Recommended): https://teo.tencentcloudapi.com

International Version

• International: https://teo.intl.tencentcloudapi.com

Note: Please choose the corresponding endpoint according to your Tencent Cloud account type. Domestic accounts use the domestic endpoint, and international accounts use the international endpoint. If you are unsure, it is recommended to use the default domestic endpoint.

DNS Provider Comparison

Provider ID	Purpose	API Operations	Use Cases
edgeone, edgeone_acc, teo_acc	Acceleration Domains	CreateAccelerationDomain, ModifyAccelerationDomain, DescribeAccelerationDomains	CDN edge acceleration, update origin IP
edgeone_dns, teo_dns, edgeone_noacc	DNS Records	CreateDnsRecord, ModifyDnsRecords, DescribeDnsRecords	Regular DNS resolution service

Troubleshooting

Debug Mode

Enable debug logging for detailed information:

ddns -c config.json --debug

Common Issues

• Authentication failure: Check if SecretId and SecretKey are correct, confirm account permissions
• Site not found: Ensure domain has been added to EdgeOne site with normal status
• DNS record does not exist: Confirm domain is properly hosted in EdgeOne
• Insufficient permissions: Ensure account has EdgeOne management permissions

Support and Resources

• Tencent Cloud EdgeOne Product Documentation
• EdgeOne API Documentation
• EdgeOne DNS Records API
• EdgeOne Console
• Tencent Cloud Technical Support

Tip: To use EdgeOne's edge acceleration features, use the EdgeOne Acceleration Domain Provider. For traditional DNS resolution services without EdgeOne, consider using Tencent Cloud DNS.