使用ddns-go实现本地IP或公网IP动态域名解析

使用ddns-go,自动获得公网或局域网 IPv4 或 IPv6 地址,并解析到对应的域名服务。

作用

自动获得你的公网或局域网 IPv4 或 IPv6 地址,并解析到对应的域名服务。

项目地址

同类产品

获取阿里云 AccessKey ID 和 AccessKey Secret

AccessKey ID 和 AccessKey Secret 推荐使用 子用户AccessKey(访问控制台RAM) 分配的权限!这样最安全!

使用子用户AccessKey,请分配 AliyunDNSReadOnlyAccess(只读访问云解析(DNS)的权限) 和 AliyunDNSFullAccess(管理云解析(DNS)的权限) 这两个权限!

系统中使用

  • 下载并解压https://github.com/jeessy2/ddns-go/releases
  • 双击运行, 如没有找到配置, 程序自动打开http://127.0.0.1:9876
  • [可选] 安装服务
    • Mac/Linux: sudo ./ddns-go -s install
    • Win(以管理员打开cmd): .\ddns-go.exe -s install
    • 安装服务也支持 -l监听地址 -f同步间隔时间(秒)
  • [可选] 服务卸载
    • Mac/Linux: sudo ./ddns-go -s uninstall
    • Win(以管理员打开cmd): .\ddns-go.exe -s uninstall
  • [可选] 支持启动带参数 -l监听地址 -f同步间隔时间(秒)。如:sudo ./ddns-go -l 127.0.0.1:9876 -f 600

Docker中使用

  • 不挂载主机目录, 删除容器同时会删除配置

    # host模式, 同时支持IPv4/IPv6
    docker run -d --name ddns-go --restart=always --net=host jeessy/ddns-go
    
  • 在浏览器中打开http://主机IP:9876,修改你的配置,成功

  • [可选] 挂载主机目录, 删除容器后配置不会丢失。可替换 /opt/ddns-go 为有权限访问的目录, 配置文件为隐藏文件

    docker run -d --name ddns-go --restart=always --net=host -v /opt/ddns-go:/root jeessy/ddns-go
    
  • [可选] 支持启动带参数 -l监听地址 -f间隔时间(秒)

    docker run -d --name ddns-go --restart=always --net=host jeessy/ddns-go -l :9877 -f 600
    

使用IPv6

  • 前提:你的电脑或终端能正常获取IPv6,并能正常访问IPv6
  • Windows/Mac:推荐 系统中使用,Windows/Mac桌面版的docker不支持--net=host
  • 群晖:
    • 套件中心下载docker并打开
    • 注册表中搜索ddns-go并下载
    • 映像 -> 选择jeessy/ddns-go -> 启动 -> 高级设置 -> 网络中勾选使用与 Docker Host 相同的网络,高级设置中勾选启动自动重新启动
    • 在浏览器中打开http://群晖IP:9876,修改你的配置,成功
  • Linux的x86或arm架构,推荐使用Docker的--net=host模式。参考 Docker中使用
  • 虚拟机中使用有可能正常获取IPv6,但不能正常访问IPv6
  • [可选] 使用IPv6后,建议勾选禁止从公网访问

Webhook

  • 支持webhook, 域名更新成功或不成功时, 会回调填写的URL

  • 支持的变量

    变量名说明
    #{ipv4Addr}新的IPv4地址
    #{ipv4Result}IPv4地址更新结果: 未改变失败成功
    #{ipv4Domains}IPv4的域名,多个以,分割
    #{ipv6Addr}新的IPv6地址
    #{ipv6Result}IPv6地址更新结果: 未改变失败成功
    #{ipv6Domains}IPv6的域名,多个以,分割
  • RequestBody为空GET请求,不为空POST请求

  • Server酱: https://sc.ftqq.com/[SCKEY].send?text=主人IPv4变了#{ipv4Addr},域名更新结果:#{ipv4Result}

  • Bark: https://api.day.app/[YOUR_KEY]/主人IPv4变了#{ipv4Addr},域名更新结果:#{ipv4Result}

  • 钉钉:

    • 钉钉电脑端 -> 群设置 -> 智能群助手 -> 添加机器人 -> 自定义
    • 只勾选 自定义关键词, 输入的关键字必须包含在RequestBody的content中, 如:你的公网IP变了
    • URL中输入钉钉给你的 Webhook地址
    • RequestBody中输入 {"msgtype": "text","text": {"content": "你的公网IP变了:#{ipv4Addr},域名更新结果:#{ipv4Result}"}}