DDNS

Tencent Cloud EdgeOne Configuration Guide

Overview

Tencent Cloud EdgeOne is an edge computing and acceleration service provided by Tencent Cloud, supporting dynamic management of acceleration domain origin server IP addresses. This DDNS project dynamically updates origin server IP addresses of acceleration domains through the EdgeOne API.

Official Links:

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",
    "id": "SecretId",          // Tencent Cloud SecretId
    "token": "SecretKey"       // Tencent Cloud SecretKey
}

Permission Requirements

Ensure the Tencent Cloud account has the following permissions:

Permissions can be viewed and configured in Access Management.

Complete Configuration Example

{
    "$schema": "https://ddns.newfuture.cc/schema/v4.0.json", // Format validation
    "dns": "edgeone",                       // Current provider
    "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.intl.tencentcloudapi.com" // API endpoint
}

Parameter Description

Parameter Description Type Value Range/Options Default Parameter Type
dns Provider ID String edgeone 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:

EdgeOne TTL actual caching strategy is managed by the EdgeOne platform.

endpoint

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

Domestic Version

International Version

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.

Troubleshooting

Debug Mode

Enable debug logging for detailed information:

ddns -c config.json --debug

Common Issues

Support and Resources

Note: EdgeOne is primarily designed for edge acceleration scenarios. For traditional DNS resolution services, consider using Tencent Cloud DNS.