Skip to content

基于阿里云的域名动态解析(DDNS),支持IPv6、多域名、多公网IP(如:宽带多拨)、docker等,支持通过缓存减少网络请求。

License

Notifications You must be signed in to change notification settings

qingchuwudi/aliyun-dns

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

aliyun-dns

借助阿里云DNS的API,通过定时检测IP变动,自动更新DNS域名解析数据来实现动态域名解析(DDNS)功能。

功能:

  • 支持指定配置文件
  • 支持IPv4和IPv6同时更新
  • 支持多域名
  • 支持宽带有多个公网IP,或者有多个宽带的情景(比如宽带多拨)
  • 支持缓存
  • 支持自定义TTL
  • 支持自定义IP检测周期
  • 支持Docker

简介

最近发现宽带运营商分配了IPv6地址,此前自己用Erlang写的DDNS程序并没有支持这种情况,遂计划用Go重新写一份。

本项目SDK的调用借鉴了 airring/aliyun-dns,特此感谢 @airring 。

一、配置

参考 config.yaml:

1.1、配置参数说明

  • accessKeyId: 阿里云的授权ID

  • accessKeySecret: 与 accessKeyId 对应的授权密钥

  • log:日志相关配置

    • path:日志文件保存的路径,例如:/var/log/
    • level:日志记录的最低级别,有 debug,info,warn,error 这四种。例如配置为 info 时就不会记录debug日志。
    • develop:开发者模式,开启后会输出代码文件和堆栈信息。
  • ipv4_check_url: 通过该URL获取网络的IPv4地址, 当前仅支持返回IP的URL,返回json或其它复杂数据结构无法处理

  • ipv6_check_url: 通过该URL获取网络的IPv6地址, 当前仅支持返回IP的URL,返回json或其它复杂数据结构无法处理

  • ttl: 域名的TTL,从阿里云后台查询,普通域名是 600

  • interval: 公网IP检测周期,单位秒(s)

  • broadband_retry: 重复次数

    不能小于宽带多拨情景下的宽带数量(可能会出现的公网IP数量),如果配置了负载均衡,还要保证数量能覆盖到所有宽带(负载均衡的最小公倍数)。

  • customer:

    • domain: 主域名(如果要更新的域名是 dns.aliyuncs.com,那么aliyuncs.com 是主域名,dns 是子域名前缀)
    • ipv4_rr: IPv4地址对应的 子域名前缀
    • ipv6_rr: IPv6地址对应的 子域名前缀

1.2、配置注意事项

  • 1、 ipv4_check_urlipv6_check_url 用来获取本机的公网IP,不写则不使用对应项,至少配置一个
  • 2、 ipv4_rripv6_rr 不写则不使用对应项,至少配置一个
  • 3、 允许配置多个域名,在 customer 下配置多个域名时,会自动更新这些域名的解析记录。

1.3、阿里云授权

accessKeyIdaccessKeySecret 需要从阿里云 用户AccessKey下拉菜单中申请。

详细可以进入: 如何申请AccessKey

二、运行

2.1、编译运行

git clone https://github.com/qingchuwudi/aliyun-dns
cd aliyun-dns
go build .
./aliyun-dns -c config.yaml

2.2、Docker运行

docker run --name=aliyun-dns --restart=unless-stopped --net=host -v /etc/alidns-config.yaml:/etc/config.yaml -d qingchuwudi/aliyun-dns:v2.1.2

注意:

  • 1、要使用 --net=host 网络模式启动,和宿主机使用同一个网络,这样可以保证获取的IP与宿主机一致。

    参考资料 Docker 网络:host模式

  • 2、修改配置文件以后,重启docker生效:docker restart aliyun-dns

  • 3、支持多种不同架构环境下运行:amd64(即x86_64)386(即x86)arm64arm/v7

Docker使用桥接或者其它网络模式运行时,Docker内的IPv6和主机真实的IPv6不一定相同。

因为国内IPv4是路由下面的DHCP,但是观察发现IPv6是为局域网环境中每个主机分配一个公网IPv6地址,并不是一个宽带使用一个IPv6地址。


About

基于阿里云的域名动态解析(DDNS),支持IPv6、多域名、多公网IP(如:宽带多拨)、docker等,支持通过缓存减少网络请求。

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published