TencentCloud DNS (TencentCloud DNSPod) Configuration Guide

Overview

TencentCloud DNS (TencentCloud DNSPod) is a professional DNS resolution service provided by Tencent Cloud, featuring high availability and high performance, supporting dynamic DNS record creation and updates. This DDNS project uses SecretId and SecretKey for API authentication.

Official links:

Official website: https://cloud.tencent.com/product/dns
Service console: https://console.cloud.tencent.com/dnspod

Authentication

API Key Authentication

TencentCloud DNS uses SecretId and SecretKey for API authentication, which is the most secure and recommended authentication method.

Obtaining API Keys

{
    "dns": "tencentcloud",
    "id": "Your_Secret_Id",     // TencentCloud SecretId
    "token": "Your_Secret_Key"  // TencentCloud SecretKey
}

There are two ways to obtain API keys:

From DNSPod

The simplest and quickest way to obtain keys

Log in to DNSPod Console
Navigate to "User Center" > "API Keys" or visit https://console.dnspod.cn/account/token
Click "Create Key", fill in the description, select domain management permissions, and complete creation

From TencentCloud

Log in to TencentCloud Console
Visit API Key Management
Click "Create Key" button
Copy the generated SecretId and SecretKey, please keep them safe
Ensure the account has DNSPod-related permissions

Complete Configuration Example

{
    "$schema": "https://ddns.newfuture.cc/schema/v4.0.json", // Format validation
    "dns": "tencentcloud",              // Current provider
    "id": "Your_Secret_Id",     // TencentCloud SecretId
    "token": "Your_Secret_Key", // TencentCloud SecretKey
    "index4": ["url:http://api.ipify.cn", "public"], // IPv4 address source
    "index6": "public",                     // IPv6 address source
    "ipv4": ["ddns.newfuture.cc"],           // IPv4 domains
    "ipv6": ["ddns.newfuture.cc", "ipv6.ddns.newfuture.cc"], // IPv6 domains
    "endpoint": "https://dnspod.tencentcloudapi.com", // API endpoint
    "line": "默认",                          // Resolution line
    "ttl": 600                              // DNS record TTL (seconds)
}

Parameter Description

Parameter	Description	Type	Value Range/Options	Default	Parameter Type
dns	Provider identifier	String	`tencentcloud`	None	Provider Parameter
id	Authentication ID	String	TencentCloud SecretId	None	Provider Parameter
token	Authentication key	String	TencentCloud SecretKey	None	Provider Parameter
index4	IPv4 source	Array	Reference	`default`	Common Configuration
index6	IPv6 source	Array	Reference	`default`	Common Configuration
ipv4	IPv4 domains	Array	Domain list	None	Common Configuration
ipv6	IPv6 domains	Array	Domain list	None	Common Configuration
endpoint	API endpoint	URL	See below	`https://dnspod.tencentcloudapi.com`	Provider Parameter
line	Resolution line	String	See below	`默认`	Provider Parameter
ttl	TTL time	Integer (seconds)	See below	`600`	Provider Parameter
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 Configuration
log	Log configuration	Object	Reference	None	Common Configuration

Parameter Type Description:

Common Configuration: Standard DNS configuration parameters applicable to all supported DNS providers

Common Network: Network setting parameters applicable to all supported DNS providers

Provider Parameter: Supported by current provider, values related to current provider

endpoint

TencentCloud DNSPod API supports multiple regional endpoints, allowing you to choose the optimal node based on your network environment:

Domestic Nodes

Default (Recommended): https://dnspod.tencentcloudapi.com
South China (Guangzhou): https://dnspod.ap-guangzhou.tencentcloudapi.com
East China (Shanghai): https://dnspod.ap-shanghai.tencentcloudapi.com
North China (Beijing): https://dnspod.ap-beijing.tencentcloudapi.com
Southwest (Chengdu): https://dnspod.ap-chengdu.tencentcloudapi.com
Hong Kong, Macao and Taiwan (Hong Kong): https://dnspod.ap-hongkong.tencentcloudapi.com

Overseas Nodes

Asia Pacific Southeast (Singapore): https://dnspod.ap-singapore.tencentcloudapi.com
Asia Pacific Southeast (Bangkok): https://dnspod.ap-bangkok.tencentcloudapi.com
Asia Pacific South (Mumbai): https://dnspod.ap-mumbai.tencentcloudapi.com
Asia Pacific Northeast (Seoul): https://dnspod.ap-seoul.tencentcloudapi.com
Asia Pacific Northeast (Tokyo): https://dnspod.ap-tokyo.tencentcloudapi.com
US East (Virginia): https://dnspod.na-ashburn.tencentcloudapi.com
US West (Silicon Valley): https://dnspod.na-siliconvalley.tencentcloudapi.com
Europe (Frankfurt): https://dnspod.eu-frankfurt.tencentcloudapi.com

Note: It is recommended to use the default endpoint https://dnspod.tencentcloudapi.com, as TencentCloud will automatically route to the optimal node. Only specify specific regional endpoints under special network conditions.

ttl

The ttl parameter specifies the Time To Live (TTL) of DNS records in seconds. TencentCloud DNSPod supports a TTL range from 1 to 604800 seconds (7 days). If not set, the default value is used.

Plan Type	Supported TTL Range (seconds)
Free	600 ~ 604800
Professional	60 ~ 604800
Enterprise	1 ~ 604800
Premium	1 ~ 604800

Reference: TencentCloud DNS TTL Documentation

line

The line parameter specifies DNS resolution lines. TencentCloud DNSPod supported lines:

Line Identifier	Description
默认	Default
电信	China Telecom
联通	China Unicom
移动	China Mobile
教育网	China Education Network
境外	Overseas

More lines reference: TencentCloud DNS Resolution Lines Documentation

Troubleshooting

Debug Mode

Enable debug logging to view detailed information:

ddns -c config.json --debug

Common Issues

Signature Error: Check if SecretId and SecretKey are correct, confirm the keys haven't expired
Domain Not Found: Ensure the domain has been added to TencentCloud DNSPod, configuration spelling is correct, domain is active
Record Creation Failed: Check if subdomain has conflicting records, TTL settings are reasonable, confirm modification permissions
API Call Limit Exceeded: TencentCloud API has call frequency limits, reduce request frequency

Common Error Codes

Error Code	Description	Solution
AuthFailure.SignatureExpire	Signature expired	Check system time
AuthFailure.SecretIdNotFound	SecretId not found	Check key configuration
ResourceNotFound.NoDataOfRecord	Record does not exist	Check record settings
LimitExceeded.RequestLimitExceeded	Request frequency exceeded	Reduce request frequency

API Limitations

Request Frequency: Default 20 requests per second
Single Query: Maximum 3000 records returned
Domain Count: Limited by plan type

Support and Resources

Recommendation: It is recommended to use sub-account API keys and grant only necessary DNSPod permissions to improve security. Regularly rotate API keys to ensure account security.

tencentcloud.en.md 8.4 KB 永久連結 文件歷史 原始文件