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:
TencentCloud DNS uses SecretId
and SecretKey
for API authentication, which is the most secure and recommended authentication method.
{
"dns": "tencentcloud",
"id": "Your_Secret_Id", // TencentCloud SecretId
"token": "Your_Secret_Key" // TencentCloud SecretKey
}
There are two ways to obtain API keys:
The simplest and quickest way to obtain keys
{
"$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 | 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:
https://dnspod.tencentcloudapi.com
https://dnspod.ap-guangzhou.tencentcloudapi.com
https://dnspod.ap-shanghai.tencentcloudapi.com
https://dnspod.ap-beijing.tencentcloudapi.com
https://dnspod.ap-chengdu.tencentcloudapi.com
https://dnspod.ap-hongkong.tencentcloudapi.com
https://dnspod.ap-singapore.tencentcloudapi.com
https://dnspod.ap-bangkok.tencentcloudapi.com
https://dnspod.ap-mumbai.tencentcloudapi.com
https://dnspod.ap-seoul.tencentcloudapi.com
https://dnspod.ap-tokyo.tencentcloudapi.com
https://dnspod.na-ashburn.tencentcloudapi.com
https://dnspod.na-siliconvalley.tencentcloudapi.com
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.
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
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
Enable debug logging to view detailed information:
ddns -c config.json --debug
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 |
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.