轻量级通用DDNS更新程序

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

!DDNS Updater logo

![构建状态]([***]

![dockeri.co]([***]

!最新版本 !最新Docker标签 ![最新版本镜像大小]([***] !GitHub最新发布日期 !发布后提交数

![最新镜像大小]([***]

![GitHub最后提交]([] ![GitHub提交活跃度]([] ![GitHub已关闭PR]([] ![GitHub issues]([] ![GitHub已关闭issues]([***]

![代码行数]([***] !代码大小 !GitHub仓库大小 !Go版本

![MIT许可证]([***] !访问量统计

版本化文档

本README和docs/目录与程序版本保持一致：

特性

• 提供Docker镜像 qmcgaw/ddns-updater 和 ghcr.io/qdm12/ddns-updater

• 提供适用于Linux、Windows和MacOS的零依赖二进制文件

• 🆕 在AUR中可用，包名为 ddns-updater - 详见 #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
  • 需要更多提供商？ 创建相关issue!

• Web用户界面（桌面端）

  !Web UI

• Web用户界面（移动端）

  !移动端Web UI

• 通过 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. 从发布页面下载适用于您平台的预构建程序。或者，您可以安装Go，然后运行 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配置，例如：

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

   您可以在配置部分找到更多自定义信息。

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

6. 以下为可选步骤。

   • 您可以使用环境变量或标志来自定义程序行为。对于标志，每个环境变量都有对应的标志，标志为全小写且下划线替换为连字符。例如，环境变量 LOG_LEVEL 对应标志 --log-level。

容器

➡️ @Araminta编写的Qnap指南

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

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

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

   如果您想使用其他用户ID，可以自行构建镜像，并指定 --build-arg UID=<您的用户ID>。您也可以使用 --user="0" 以root用户运行容器，但从安全角度不建议这样做。

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

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

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

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

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

   您可以在配置部分找到更多自定义信息。

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

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

5. 以下为可选步骤。

   • 您可以使用环境变量自定义程序行为。
   • 您可以使用 docker-compose.yml 并运行 docker-compose up -d。
   • Kubernetes：查看k8s目录获取安装指南和示例。
   • 其他Docker镜像标签可用。
   • 您可以使用 docker pull qmcgaw/ddns-updater 更新镜像。
   • 您可以将JSON配置设置为单行的 CONFIG 环境变量（即 {"settings": [{"provider": "namecheap", ...}]}），其优先级高于 config.json。但请注意，如果不挂载 /updater/data 目录，将不会有持久化数据库文件 /updater/updates.json，但程序仍可运行。

配置

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

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

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

• 阿里云
• Allinkl
• ChangeIP
• Cloudflare
• 自定义
• DDNSS.de
• deSEC
• DigitalOcean
• DD24
• Domeneshop
• DonDominio
• DNSOMatic
• DNSPod
• Dreamhost
• DuckDNS
• DynDNS
• Dynu
• DynV6
• EasyDNS
• FreeDNS
• Gandi
• GCP
• GoDaddy
• GoIP.de
• He.net
• Infomaniak
• INWX
• Ionos
• Linode
• Loopia
• LuaDNS
• Myaddr
• Name.com
• Namecheap
• [NameSilo]([***]