DDNS

阿里云DNS 配置指南 中文文档

概述

阿里云DNS(AliDNS)是阿里云提供的权威DNS解析服务,支持高并发、高可用性的域名解析。本 DDNS 项目支持通过阿里云AccessKey进行认证。

认证方式

AccessKey 认证

阿里云DNS使用AccessKey ID和AccessKey Secret进行API认证,这是阿里云标准的认证方式。

获取AccessKey

  1. 登录 阿里云控制台
  2. 访问 AccessKey管理
  3. 点击”创建AccessKey”按钮
  4. 复制生成的 AccessKey IDAccessKey Secret,请妥善保存
  5. 确保账号具有云解析DNS的操作权限

配置示例

{
    "dns": "alidns",
    "id": "LTAI4xxxxxxxxxxxxxxx",
    "token": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}

完整配置示例

基本配置

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

带可选参数的配置

{
    "id": "LTAI4xxxxxxxxxxxxxxx",
    "token": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "dns": "alidns",
    "ipv6": ["dynamic.mydomain.com"],
    "ttl": 600,
    "record_type": "A",
    "line": "telecom"
}
}

可选参数

TTL(生存时间)

{
    "ttl": 600
}

记录类型

{
    "record_type": "A"
}

解析线路

{
    "line": "default"
}

权限要求

确保使用的阿里云账号具有以下权限:

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

故障排除

常见问题

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

“域名不存在”

“记录操作失败”

“API调用超出限制”

调试模式

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

ddns --debug

常见错误代码

API限制

支持与资源

建议使用RAM子账号并仅授予必要的DNS权限,以提高安全性。定期轮换AccessKey以确保账号安全。