sanjusss/aliyun-ddns

阿里云DDNS镜像

镜像概述

阿里云DDNS镜像是一款用于自动更新阿里云域名解析记录的工具。它能够通过在线API或本地网卡获取公网/内网IPv4/v6地址，并自动更新到指定域名的A/AAAA记录，适用于动态IP环境下需要固定域名访问的场景。

核心功能和特性

• 通过在线API获取公网IPv4/v6地址，更新域名A/AAAA记录
• 通过本地网卡获取公网或内网IPv4/v6地址，更新域名A/AAAA记录
• 支持同时更新多个域名的解析记录
• 支持为不同域名指定解析线路
• 兼容Docker容器，支持x64、ARMv7和ARMv8架构
• IP地址发生变化时，支持通过WebHook发送通知

使用场景和适用范围

• 家庭网络环境中需要通过固定域名访问本地服务器（如NAS、家庭影院服务器）
• 动态IP环境下的远程设备管理
• 需要同时管理多个域名解析记录的场景
• 对IPv6支持有需求的网络环境

使用方法

Docker部署

基本运行命令

bash
docker run -d --restart=always --net=host \
    -e "AKID=[阿里云AccessKey-ID]" \
    -e "AKSCT=[阿里云AccessKey-Secret]" \
    -e "DOMAIN=ddns.aliyun.win" \
    -e "REDO=30" \
    -e "TTL=60" \
    -e "TIMEZONE=8.0" \
    -e "TYPE=A,AAAA" \
    sanjusss/aliyun-ddns

环境变量说明

注：所有环境变量均有默认值，只需添加需要修改的环境变量即可。

命令行使用

查看帮助信息

bash
dotnet aliyun-ddns.dll --help

查看版本信息

bash
dotnet aliyun-ddns.dll --version

运行命令示例

bash
dotnet aliyun-ddns.dll \
    -u "ALIYUN's AccessKey-ID" \
    -p "ALIYUN's AccessKey-Secret" \
    -d "ddns.aliyun.win,ddns2.aliyun2.win" \
    -i 300 \
    -t 600 \
    --timezone 8.0 \
    --type A \
    --cnipv4

命令行参数说明

注：所有参数均有默认值，只需添加需要修改的参数即可。

常见问题

无法获取DNS记录

日志提示

获取xxx.yyy.zzz的所有记录时出现异常：Aliyun.Acs.Core.Exceptions.ClientException: SDK.WebException : HttpWebRequest WebException occured, the request url is alidns.aliyuncs.com System.Net.WebException: Resource temporarily unavailable Resource temporarily unavailable

可能的原因

• alidns.aliyuncs.com服务器宕机
• 当地电信运营商网络故障
• docker容器无法访问网络

可能的解决方法

可自行解决的是“docker容器无法访问网络”问题：
执行curl https://alidns.aliyuncs.com有返回内容（如403等），说明docker容器无法访问网络。
若之前手动修改过防火墙设置和docker网桥，请先恢复默认设置。
可尝试通过重启网络解决：
以CentOS7为例：

shell
systemctl restart network
systemctl restart docker