阿里云 DNS (AliDNS) 配置指南 概述 阿里云 DNS(AliDNS)是阿里云提供的权威 DNS 解析服务,支持动态 DNS 记录的创建与更新。本 DDNS 项目通过 AccessKey ID 和 AccessKey Secret 进行 API 认证。
官网链接:
官方网站:https://www.aliyun.com/product/dns服务商控制台:https://dns.console.aliyun.com/认证信息 AccessKey 认证 使用阿里云 AccessKey ID 和 AccessKey Secret 进行认证。
获取认证信息 登录 阿里云控制台访问 AccessKey管理点击"创建AccessKey"按钮复制生成的 AccessKey ID 和 AccessKey Secret,请妥善保存确保账号具有云解析(AliyunDNSFullAccess)的操作权限jsonc{
"dns": "alidns",
"id": "AccessKey_ID", // 阿里云 AccessKey ID
"token": "AccessKey_Secret" // 阿里云 AccessKey Secret
}12345权限要求 确保使用的阿里云账号具有以下权限:
AliyunDNSFullAccess:云解析 DNS 完全访问权限(推荐)AliyunDNSReadOnlyAccess + 自定义写权限:精细化权限控制可以在 RAM访问控制 中查看和配置权限。
完整配置示例 jsonc{
"$schema": "https://ddns.newfuture.cc/schema/v4.1.json", // 格式验证
"dns": "alidns", // 当前服务商
"id": "your_access_key_id", // AccessKey ID
"token": "your_access_key_secret", // AccessKey Secret
"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://alidns.aliyuncs.com", // API端点
"line": "default", // 解析线路
"ttl": 600 // DNS记录TTL(秒)
}12345678910111213参数说明 参数说明类型取值范围/选项默认值参数类型dns服务商标识字符串alidns无服务商参数id认证 ID字符串阿里云 AccessKey ID无服务商参数token认证密钥字符串阿里云 AccessKey Secret无服务商参数index4IPv4 来源数组参考配置default公用配置index6IPv6 来源数组参考配置default公用配置ipv4IPv4 域名数组域名列表无公用配置ipv6IPv6 域名数组域名列表无公用配置endpointAPI 端点URL参考下方https://alidns.aliyuncs.com服务商参数line解析线路字符串参考下方default服务商参数ttlTTL 时间整数(秒)参考下方无服务商参数proxy代理设置数组参考配置无公用网络sslSSL 验证方式布尔/字符串"auto"、true、falseauto公用网络cache缓存设置布尔/字符串true、false、filepathtrue公用配置log日志配置对象参考配置无公用配置参数类型说明:
公用配置:所有支持的DNS服务商均适用的标准DNS配置参数公用网络:所有支持的DNS服务商均适用的网络设置参数参数服务商参数:前服务商支持,值与当前服务商相关 注意:ttl 和 line 不同套餐支持的值可能不同。endpoint 阿里云 DNS 支持多个区域端点,可根据区域和网络环境选择最优节点:
国内节点 默认(推荐):https://alidns.aliyuncs.com华东1(杭州):https://alidns.cn-hangzhou.aliyuncs.com华东2(上海):https://alidns.cn-shanghai.aliyuncs.com华北1(青岛):https://alidns.cn-qingdao.aliyuncs.com华北2(北京):https://alidns.cn-beijing.aliyuncs.com华北3(张家口):https://alidns.cn-zhangjiakou.aliyuncs.com华南1(深圳):https://alidns.cn-shenzhen.aliyuncs.com西南1(成都):https://alidns.cn-chengdu.aliyuncs.com海外节点 亚太东南1(新加坡):https://alidns.ap-southeast-1.aliyuncs.com亚太东南2(悉尼):https://alidns.ap-southeast-2.aliyuncs.com亚太东南3(吉隆坡):https://alidns.ap-southeast-3.aliyuncs.com亚太南部1(孟买):https://alidns.ap-south-1.aliyuncs.com亚太东北1(东京):https://alidns.ap-northeast-1.aliyuncs.com美国东部1(弗吉尼亚):https://alidns.us-east-1.aliyuncs.com美国西部1(硅谷):https://alidns.us-west-1.aliyuncs.com欧洲中部1(法兰克福):https://alidns.eu-central-1.aliyuncs.com欧洲西部1(伦敦):https://alidns.eu-west-1.aliyuncs.com注意:建议使用默认端点 https://alidns.aliyuncs.com,阿里云会自动路由到最优节点。只有在特殊网络环境下才需要指定特定区域端点。
ttl ttl 参数指定 DNS 记录的生存时间(TTL),单位为秒。阿里云支持的 TTL 范围为 1 到 86400 秒(即 1 天)。如果不设置,则使用默认值。
套餐类型支持的 TTL 范围(秒)免费版600 - 86400个人版600 - 86400企业标准版60 - 86400企业旗舰版1 - 86400参考:阿里云 DNS TTL 说明
line line 参数指定 DNS 解析线路,阿里云支持的线路:
线路标识说明default默认telecom中国电信unicom中国联通mobile中国移动edu中国教育网aliyun阿里云oversea境外internal中国地区更多线路参考:阿里云 DNS 解析线路枚举
故障排除 调试模式 启用调试日志查看详细信息:
shddns -c config.json --debug1常见问题 InvalidAccessKeyId.NotFound:AccessKey 不存在SignatureDoesNotMatch:签名错误,检查 AccessKey SecretDomainNotExists:域名未添加到阿里云 DNSThrottling.User:请求过于频繁,降低 QPS,(个人版:20 QPS,企业版:50 QPS)支持与资源 阿里云DNS产品文档阿里云DNS API文档阿里云DNS控制台阿里云技术支持建议:使用 RAM 子账号并定期轮换 AccessKey,提升账号安全性。