DDNS

简体中文

English

简体中文

English

主题

腾讯云 DNS (TencentCloud DNSPod) 配置指南 ​

概述 ​

腾讯云 DNS（TencentCloud DNSPod）是腾讯云提供的专业 DNS 解析服务，具有高可用性和高性能，支持动态 DNS 记录的创建与更新。本 DDNS 项目通过 SecretId 和 SecretKey 进行 API 认证。

官网链接：

认证信息 ​

API 密钥认证 ​

腾讯云DNS使用SecretId和SecretKey进行API认证，这是最安全和推荐的认证方式。

获取API密钥 ​

jsonc
{
    "dns": "tencentcloud",
    "id": "Your_Secret_Id",     // 腾讯云 SecretId
    "token": "Your_Secret_Key" // 腾讯云 SecretKey
}

有以下两种方式获取 API 密钥：

从DNSPod获取 ​

最为简单快捷地获取

  1. 登录 DNSPod控制台
  2. 进入“用户中心” > “API密钥”或访问 https://console.dnspod.cn/account/token
  3. 点击“创建密钥”，填写描述，选择域名管理权限，完成创建
从腾讯云获取 ​
  1. 登录 腾讯云控制台
  2. 访问 API密钥管理
  3. 点击"新建密钥"按钮
  4. 复制生成的 SecretId 和 SecretKey，请妥善保存
  5. 确保账号具有DNSPod相关权限

确保使用的腾讯云账号具有以下权限：

  • QcloudDNSPodFullAccess：DNSPod 完全访问权限（推荐）
  • QcloudDNSPodReadOnlyAccess + 自定义写权限：精细化权限控制

可以在 访问管理控制台 中查看和配置权限。

完整配置示例 ​

jsonc
{
    "$schema": "https://ddns.newfuture.cc/schema/v4.1.json", // 格式验证
    "dns": "tencentcloud",              // 当前服务商
    "id": "Your_Secret_Id",     // 腾讯云 SecretId
    "token": "Your_Secret_Key", // 腾讯云 SecretKey
    "index4": ["url:http://api.ipify.cn", "public"], // IPv4地址来源
    "index6": "public",                     // IPv6地址来源
    "ipv4": ["ddns.newfuture.cc"],           // IPv4 域名
    "ipv6": ["ddns.newfuture.cc", "ipv6.ddns.newfuture.cc"], // IPv6 域名
    "endpoint": "https://dnspod.tencentcloudapi.com", // API端点
    "line": "默认",                          // 解析线路
    "ttl": 600                              // DNS记录TTL（秒）
}

参数说明 ​

参数说明类型取值范围/选项默认值参数类型
dns服务商标识字符串tencentcloud无服务商参数
id认证 ID字符串腾讯云 SecretId无服务商参数
token认证密钥字符串腾讯云 SecretKey无服务商参数
index4IPv4 来源数组参考配置default公用配置
index6IPv6 来源数组参考配置default公用配置
ipv4IPv4 域名数组域名列表无公用配置
ipv6IPv6 域名数组域名列表无公用配置
endpointAPI 端点URL参考下方https://dnspod.tencentcloudapi.com服务商参数
line解析线路字符串参考下方默认服务商参数
ttlTTL 时间整数（秒）参考下方600服务商参数
proxy代理设置数组参考配置无公用网络
sslSSL 验证方式布尔/字符串"auto"、true、falseauto公用网络
cache缓存设置布尔/字符串true、false、filepathtrue公用配置
log日志配置对象参考配置无公用配置

参数类型说明：

  • 公用配置：所有支持的DNS服务商均适用的标准DNS配置参数
  • 公用网络：所有支持的DNS服务商均适用的网络设置参数
  • 服务商参数：当前服务商支持,值与当前服务商相关 注意：ttl 和 line 不同套餐支持的值可能不同。

endpoint ​

腾讯云 DNSPod API 支持多个区域端点，可根据网络环境选择最优节点：

国内节点 ​

  • 默认（推荐）：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

注意：建议使用默认端点 https://dnspod.tencentcloudapi.com，腾讯云会自动路由到最优节点。只有在特殊网络环境下才需要指定特定区域端点。

ttl ​

ttl 参数指定 DNS 记录的生存时间（TTL），单位为秒。腾讯云 DNSPod 支持的 TTL 范围为 1 到 604800 秒（即 7 天）。如果不设置，则使用默认值。

套餐类型支持的 TTL 范围（秒）
免费版600 ~ 604800
专业版60 ~ 604800
企业版1 ~ 604800
尊享版1 ~ 604800

参考：腾讯云 云解析 TTL 说明

line ​

line 参数指定 DNS 解析线路，腾讯云 DNSPod 支持的线路：

线路标识说明
默认默认
电信中国电信
联通中国联通
移动中国移动
教育网中国教育网
境外境外

更多线路参考：腾讯云 云解析 DNS 解析线路说明

故障排除 ​

调试模式 ​

启用调试日志查看详细信息：

sh
ddns -c config.json --debug

常见问题 ​

  • 签名错误：检查 SecretId 和 SecretKey 是否正确，确认密钥没有过期
  • 域名未找到：确保域名已添加到腾讯云 DNSPod，配置拼写无误，域名处于活跃状态
  • 记录创建失败：检查子域名是否有冲突记录，TTL 设置合理，确认有修改权限
  • API 调用超出限制：腾讯云 API 有调用频率限制，降低请求频率

常见错误代码 ​

错误代码说明解决方案
AuthFailure.SignatureExpire签名过期检查系统时间
AuthFailure.SecretIdNotFoundSecretId不存在检查密钥配置
ResourceNotFound.NoDataOfRecord记录不存在检查记录设置
LimitExceeded.RequestLimitExceeded请求频率超限降低请求频率

API 限制 ​

  • 请求频率：默认每秒 20 次
  • 单次查询：最多返回 3000 条记录
  • 域名数量：根据套餐不同而限制

支持与资源 ​

建议：推荐使用子账号 API 密钥并仅授予必要的 DNSPod 权限，以提高安全性。定期轮换 API 密钥确保账号安全。

Released under the MIT License

Copyright © 2016 ~ 2026 NewFuture