DDNS

腾讯云DNS 配置指南 中文文档

概述

腾讯云DNS(TencentCloud DNSPod)是腾讯云提供的专业DNS解析服务,适用于需要高可用性和高性能DNS解析的用户。本 DDNS 项目支持通过腾讯云API密钥进行认证。

认证方式

API 密钥认证

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

获取API密钥

从DNSPod获取
  1. 登录 DNSPod控制台
  2. 进入“用户中心” > “API密钥”或访问 https://console.dnspod.cn/account/token
从腾讯云获取
  1. 登录 腾讯云控制台
  2. 访问 API密钥管理
  3. 点击”新建密钥”按钮
  4. 复制生成的 SecretIdSecretKey,请妥善保存
  5. 确保账号具有DNSPod相关权限

配置示例

{
    "dns": "tencentcloud",
    "id": "AKIDxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "token": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}

完整配置示例

基本配置

{
    "id": "AKIDxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "token": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "dns": "tencentcloud",
    "ipv6": ["home.example.com", "server.example.com"]
}

带可选参数的配置

{
    "id": "AKIDxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "token": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "dns": "tencentcloud",
    "ipv6": ["dynamic.mydomain.com"],
    "ttl": 300,
    "record_type": "A"
}

可选参数

TTL(生存时间)

{
    "ttl": 300
}

记录类型

{
    "record_type": "A"
}

线路类型

{
    "line": "默认"
}

权限要求

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

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

故障排除

常见问题

“签名错误”或”认证失败”

“域名未找到”

“记录操作失败”

“API调用超出限制”

调试模式

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

ddns --debug

常见错误代码

API限制

支持与资源

建议使用子账号API密钥并仅授予必要的DNSPod权限,以提高安全性。