DDNS

阿里云 DNS (AliDNS) 配置指南

概述

阿里云 DNS(AliDNS)是阿里云提供的权威 DNS 解析服务,支持动态 DNS 记录的创建与更新。本 DDNS 项目通过 AccessKey ID 和 AccessKey Secret 进行 API 认证。

官网链接:

认证信息

AccessKey 认证

使用阿里云 AccessKey ID 和 AccessKey Secret 进行认证。

获取认证信息

  1. 登录 阿里云控制台
  2. 访问 AccessKey管理
  3. 点击”创建AccessKey”按钮
  4. 复制生成的 AccessKey IDAccessKey Secret,请妥善保存
  5. 确保账号具有云解析(AliyunDNSFullAccess)的操作权限
{
    "dns": "alidns",
    "id": "AccessKey_ID",     // 阿里云 AccessKey ID
    "token": "AccessKey_Secret" // 阿里云 AccessKey Secret
}

权限要求

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

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

完整配置示例

{
    "$schema": "https://ddns.newfuture.cc/schema/v4.0.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(秒)
}

参数说明

参数 说明 类型 取值范围/选项 默认值 参数类型
dns 服务商标识 字符串 alidns 服务商参数
id 认证 ID 字符串 阿里云 AccessKey ID 服务商参数
token 认证密钥 字符串 阿里云 AccessKey Secret 服务商参数
index4 IPv4 来源 数组 参考配置 default 公用配置
index6 IPv6 来源 数组 参考配置 default 公用配置
ipv4 IPv4 域名 数组 域名列表 公用配置
ipv6 IPv6 域名 数组 域名列表 公用配置
endpoint API 端点 URL 参考下方 https://alidns.aliyuncs.com 服务商参数
line 解析线路 字符串 参考下方 default 服务商参数
ttl TTL 时间 整数(秒) 参考下方 服务商参数
proxy 代理设置 数组 参考配置 公用网络
ssl SSL 验证方式 布尔/字符串 "auto"truefalse auto 公用网络
cache 缓存设置 布尔/字符串 truefalsefilepath true 公用配置
log 日志配置 对象 参考配置 公用配置

参数类型说明

endpoint

阿里云 DNS 支持多个区域端点,可根据区域和网络环境选择最优节点:

国内节点

海外节点

注意:建议使用默认端点 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 解析线路枚举

故障排除

调试模式

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

ddns -c config.json --debug

常见问题

支持与资源

建议:使用 RAM 子账号并定期轮换 AccessKey,提升账号安全性。