qmcgaw/ddns-updater

轻量级通用DDNS更新程序

用于为多个DNS提供商保持DNS A和/或AAAA记录更新的程序

!https://raw.githubusercontent.com/qdm12/ddns-updater/master/readme/ddnsgopher.svg

https://github.com/qdm12/ddns-updater/actions/workflows/build.yml/badge.svg](https://github.com/qdm12/ddns-updater/actions/workflows/build.yml)

!最新版本 !最新Docker标签 !GitHub最新发布日期 !发布后提交数

!代码大小 !GitHub仓库大小 !Go版本

!访问量统计

版本化文档

本README和https://github.com/qdm12/ddns-updater/blob/master/docs/%E7%9B%AE%E5%BD%95%E4%B8%8E%E7%A8%8B%E5%BA%8F%E7%89%88%E6%9C%AC**%E4%BF%9D%E6%8C%81%E4%B8%80%E8%87%B4**%EF%BC%9A

特性

• 提供Docker镜像 https://hub.docker.com/r/qmcgaw/ddns-updater 和 https://github.com/qdm12/ddns-updater/pkgs/container/ddns-updater

• 提供https://github.com/qdm12/ddns-updater/releases

• 🆕 在AUR中可用，包名为 ddns-updater - 详见 https://github.com/qdm12/ddns-updater/discussions/808

• 定期为不同DNS提供商更新A记录：

  • 阿里云（Aliyun）
  • AllInkl
  • Changeip
  • Cloudflare
  • DD24
  • DDNSS.de
  • deSEC
  • DigitalOcean
  • Domeneshop
  • DonDominio
  • DNSOMatic
  • DNSPod
  • Dreamhost
  • DuckDNS
  • DynDNS
  • Dynu
  • EasyDNS
  • FreeDNS
  • Gandi
  • GCP
  • GoDaddy
  • GoIP.de
  • He.net
  • Hetzner
  • Infomaniak
  • INWX
  • Ionos
  • Linode
  • Loopia
  • LuaDNS
  • Myaddr
  • Name.com
  • Namecheap
  • NameSilo
  • Netcup
  • NoIP
  • Now-DNS
  • Njalla
  • OpenDNS
  • OVH
  • Porkbun
  • Route53
  • Selfhost.de
  • Servercow.de
  • Spdyn
  • Strato.de
  • Variomedia.de
  • Vultr
  • Zoneedit
  • 需要更多提供商？ https://github.com/qdm12/ddns-updater/issues/new/choose!

• Web用户界面（桌面端）

  !https://github.com/qdm12/ddns-updater/raw/master/readme/webui-desktop.gif

• Web用户界面（移动端）

  !https://github.com/qdm12/ddns-updater/raw/master/readme/webui-mobile.png

• 通过 SHOUTRRR_ADDRESSES 使用Shoutrrr发送通知

• 容器（Docker/K8s）特定特性：

  • 基于Scratch Docker镜像的轻量级12MB Docker镜像
  • 验证域名DNS解析的Docker健康检查
  • 支持 amd64、386、arm64、armv7、armv6、s390x、ppc64le、riscv64 CPU架构的镜像

• 使用JSON文件 updates.json 持久化存储每条记录的旧IP地址和更改时间

安装设置

二进制程序

1. 从https://github.com/qdm12/ddns-updater/releases%E4%B8%8B%E8%BD%BD%E9%80%82%E7%94%A8%E4%BA%8E%E6%82%A8%E5%B9%B3%E5%8F%B0%E7%9A%84%E9%A2%84%E6%9E%84%E5%BB%BA%E7%A8%8B%E5%BA%8F%E3%80%82%E6%88%96%E8%80%85%EF%BC%8C%E6%82%A8%E5%8F%AF%E4%BB%A5%E5%AE%89%E8%A3%85Go%EF%BC%8C%E7%84%B6%E5%90%8E%E8%BF%90%E8%A1%8C go install github.com/qdm12/ddns-updater/cmd/ddns-updater@latest 下载、构建并安装最新版本的程序。

2. 对于Linux和MacOS，使用 chmod +x ddns-updater 使程序可执行。

3. 在程序保存目录中，创建 data 目录。

4. 在 data/config.json 中编写JSON配置，例如：

   json
   {
       "settings": [
           {
               "provider": "namecheap",
               "domain": "sub.example.com",
               "password": "e5322165c1d74692bfa6d807100c0310"
           }
       ]
   }
   

   您可以在https://github.com/qdm12/ddns-updater/blob/master/README.md#configuration%E6%89%BE%E5%88%B0%E6%9B%B4%E5%A4%9A%E8%87%AA%E5%AE%9A%E4%B9%89%E4%BF%A1%E6%81%AF%E3%80%82

5. 使用 ./ddns-updater（Windows上为 ./ddns-updater.exe）运行程序，或双击程序图标。

6. 以下为可选步骤。

   • 您可以使用https://github.com/qdm12/ddns-updater/blob/master/README.md#environment-variables%E6%88%96%E6%A0%87%E5%BF%97%E6%9D%A5%E8%87%AA%E5%AE%9A%E4%B9%89%E7%A8%8B%E5%BA%8F%E8%A1%8C%E4%B8%BA%E3%80%82%E5%AF%B9%E4%BA%8E%E6%A0%87%E5%BF%97%EF%BC%8C%E6%AF%8F%E4%B8%AA%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F%E9%83%BD%E6%9C%89%E5%AF%B9%E5%BA%94%E7%9A%84%E6%A0%87%E5%BF%97%EF%BC%8C%E6%A0%87%E5%BF%97%E4%B8%BA%E5%85%A8%E5%B0%8F%E5%86%99%E4%B8%94%E4%B8%8B%E5%88%92%E7%BA%BF%E6%9B%BF%E6%8D%A2%E4%B8%BA%E8%BF%9E%E5%AD%97%E7%AC%A6%E3%80%82%E4%BE%8B%E5%A6%82%EF%BC%8C%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F LOG_LEVEL 对应标志 --log-level。

容器

https://github.com/qdm12/ddns-updater/issues/708

1. 创建一个目录，例如 data，要求：

   • 所有者用户ID为 1000（ddns-updater容器的内置用户ID）
   • 具有用户读+写+执行权限

   sh
   mkdir data
   chown 1000 data
   chmod u+r+w+x data
   

   如果您想使用其他用户ID，可以https://github.com/qdm12/ddns-updater/blob/master/README.md#build-the-image%EF%BC%8C%E5%B9%B6%E6%8C%87%E5%AE%9A --build-arg UID=<您的用户ID>。您也可以使用 --user="0" 以root用户运行容器，但从安全角度不建议这样做。

2. 类似地，创建 data/config.json 文件，要求：

   • 所有者用户ID为 1000
   • 具有用户读权限

   sh
   touch data/config.json
   chmod u+r data/config.json
   

3. 编辑 data/config.json，例如：

   json
   {
       "settings": [
           {
               "provider": "namecheap",
               "domain": "sub.example.com",
               "password": "e5322165c1d74692bfa6d807100c0310"
           }
       ]
   }
   

   您可以在https://github.com/qdm12/ddns-updater/blob/master/README.md#configuration%E6%89%BE%E5%88%B0%E6%9B%B4%E5%A4%9A%E8%87%AA%E5%AE%9A%E4%B9%89%E4%BF%A1%E6%81%AF%E3%80%82

4. 使用以下命令运行容器：

   sh
   docker run -d -p 8000:8000/tcp -v "$(pwd)"/data:/updater/data qmcgaw/ddns-updater
   

5. 以下为可选步骤。

   • 您可以使用https://github.com/qdm12/ddns-updater/blob/master/README.md#environment-variables%E8%87%AA%E5%AE%9A%E4%B9%89%E7%A8%8B%E5%BA%8F%E8%A1%8C%E4%B8%BA%E3%80%82
   • 您可以使用 https://github.com/qdm12/ddns-updater/blob/master/docker-compose.yml 并运行 docker-compose up -d。
   • Kubernetes：查看https://github.com/qdm12/ddns-updater/blob/master/k8s%E8%8E%B7%E5%8F%96%E5%AE%89%E8%A3%85%E6%8C%87%E5%8D%97%E5%92%8C%E7%A4%BA%E4%BE%8B%E3%80%82
   • https://hub.docker.com/repository/docker/qmcgaw/ddns-updater/tags%E3%80%82
   • 您可以使用 docker pull qmcgaw/ddns-updater 更新镜像。
   • 您可以将JSON配置设置为单行的 CONFIG 环境变量（即 {"settings": [{"provider": "namecheap", ...}]}），其优先级高于 config.json。但请注意，如果不挂载 /updater/data 目录，将不会有持久化数据库文件 /updater/updates.json，但程序仍可运行。

配置

首先，在 config.json 或 CONFIG 环境变量中包含以下内容：

json
{
    "settings": [
        {
            "provider": "",
        },
        {
            "provider": "",
        }
    ]
}

对于每个设置，您需要填写参数。请查看您的DNS提供商文档：

• https://github.com/qdm12/ddns-updater/blob/master/docs/aliyun.md
• https://github.com/qdm12/ddns-updater/blob/master/docs/allinkl.md
• https://github.com/qdm12/ddns-updater/blob/master/docs/changeip.md
• https://github.com/qdm12/ddns-updater/blob/master/docs/cloudflare.md
• https://github.com/qdm12/ddns-updater/blob/master/docs/custom.md
• https://github.com/qdm12/ddns-updater/blob/master/docs/ddnss.de.md
• https://github.com/qdm12/ddns-updater/blob/master/docs/desec.md
• https://github.com/qdm12/ddns-updater/blob/master/docs/digitalocean.md
• https://github.com/qdm12/ddns-updater/blob/master/docs/dd24.md
• https://github.com/qdm12/ddns-updater/blob/master/docs/domeneshop.md
• https://github.com/qdm12/ddns-updater/blob/master/docs/dondominio.md
• https://github.com/qdm12/ddns-updater/blob/master/docs/dnsomatic.md
• https://github.com/qdm12/ddns-updater/blob/master/docs/dnspod.md
• https://github.com/qdm12/ddns-updater/blob/master/docs/dreamhost.md
• https://github.com/qdm12/ddns-updater/blob/master/docs/duckdns.md
• https://github.com/qdm12/ddns-updater/blob/master/docs/dyndns.md
• https://github.com/qdm12/ddns-updater/blob/master/docs/dynu.md
• https://github.com/qdm12/ddns-updater/blob/master/docs/dynv6.md
• https://github.com/qdm12/ddns-updater/blob/master/docs/easydns.md
• https://github.com/qdm12/ddns-updater/blob/master/docs/freedns.md
• https://github.com/qdm12/ddns-updater/blob/master/docs/gandi.md
• https://github.com/qdm12/ddns-updater/blob/master/docs/gcp.md
• https://github.com/qdm12/ddns-updater/blob/master/docs/godaddy.md
• https://github.com/qdm12/ddns-updater/blob/master/docs/goip.md
• https://github.com/qdm12/ddns-updater/blob/master/docs/he.net.md
• https://github.com/qdm12/ddns-updater/blob/master/docs/infomaniak.md
• https://github.com/qdm12/ddns-updater/blob/master/docs/inwx.md
• https://github.com/qdm12/ddns-updater/blob/master/docs/ionos.md
• https://github.com/qdm12/ddns-updater/blob/master/docs/linode.md
• https://github.com/qdm12/ddns-updater/blob/master/docs/loopia.md
• https://github.com/qdm12/ddns-updater/blob/master/docs/luadns.md
• https://github.com/qdm12/ddns-updater/blob/master/docs/myaddr.md
• https://github.com/qdm12/ddns-updater/blob/master/docs/name.com.md
• https://github.com/qdm12/ddns-updater/blob/master/docs/namecheap.md
• [NameSilo](https://github.com/qdm1