What's Changed

• Configure Dependabot for GitHub Actions and npm by @NewFuture in #652
• Potential fix for code scanning alert no. 2: Workflow does not contain permissions by @NewFuture in #653
• Bump actions/setup-python from 5 to 6 by @dependabot[bot] in #658
• Bump Nuitka/Nuitka-Action from 1.3 to 1.4 by @dependabot[bot] in #655
• Bump actions/checkout from 4 to 6 by @dependabot[bot] in #654
• Bump actions/download-artifact from 4 to 7 by @dependabot[bot] in #657
• Bump actions/upload-artifact from 4 to 6 by @dependabot[bot] in #656
• docs: add ESA Pages and Edge Function deployment guide by @Copilot in #659
• ci: skip test-install.yml on release tags by @Copilot in #660
• fix: dynamically generate test matrix based on file changes by @Copilot in #661
• docs: Condense edge-ddns-proxy references to single-line mentions by @Copilot in #662
• feat(provider.cloudns): add ClouDNS.net DNS provider support by @iclart in #663
• refactor(provider): optimize cloudns implementation and add documentation by @Copilot in #664
• docs: sync llms.txt with CloudNS and automate doc changes detection by @Copilot in #666

New Contributors

• @iclart made their first contribution in #663

Full Changelog: v4.1.4-beta1...v4.1.4-beta2

DDNS Release Information

各版本一览表 | Download Methods Overview

Docker (推荐 Recommended)

# 当前版本 (Current version)
docker run --name ddns -v $(pwd)/:/ddns/ newfuture/ddns:latest -h

# 最新版本 (Latest version, may use cache)
docker run --name ddns -v $(pwd)/:/ddns/ newfuture/ddns -h

# 后台运行 (Run in background)
docker run -d --name ddns -v $(pwd)/:/ddns/ newfuture/ddns:latest

📁 请将 $(pwd) 替换为你的配置文件夹
📖 Replace $(pwd) with your config folder

• 使用 -h 查看帮助信息 (Use -h for help)
• config.json 支持编辑器自动补全 (config.json supports autocompletion)
• 支持 DDNS_XXX 环境变量 (Supports DDNS_XXX environment variables)

支持源 (Supported registries):

• Docker官方源 (Docker Hub): docker.io/newfuture/ddns
• Github官方源 (Github Registry): ghcr.io/newfuture/ddns

一键安装 | One-click Install

Linux/MacOS 使用安装脚本获取并安装最新版本(Use the installer to fetch and install the latest release):

• curl 安装

  curl -#fSL https://ddns.newfuture.cc/install.sh | sh -s -- latest

• wget 安装

  wget -O- https://ddns.newfuture.cc/install.sh | sh -s -- latest

需要 root 或 sudo 权限 (Requires curl and sudo).
更多说明与源码 More details and source: https://ddns.newfuture.cc

二进制文件 | Executable Binary

手动下载各平台文件和使用方式 (Download and Usage per platform):

• Windows

1. (推荐) 下载 ZIP: x64.zip · x86.zip · arm64.zip 解压并运行 ddns.exe。
   (Recommended) Download the ZIP for your arch, extract, then run ddns.exe.

2. 直接下载 EXE: x64.exe · x86.exe · arm64.exe
   (Alternatively) Download the EXE and run in cmd or PowerShell.

   ⚠️ 注意: 单文件版exe可能会被杀毒软件误报，建议使用ZIP版本或添加信任例外。
   ⚠️ Note: Single-file EXE may be flagged by antivirus software as false positive. Consider using ZIP version or adding trust exception.

3. [可选] 定时任务: 使用内置命令 ddns task --install 创建定时任务。
   (Optionally) Use the built-in command ddns task --install to create a scheduled task.

• Linux

# 常规Linux (glibc x64)
curl https://github.com/NewFuture/DDNS/releases/latest/download/ddns-glibc-linux_amd64 -#SLo ddns && chmod +x ddns

# OpenWRT/嵌入式 (musl arm64)
curl https://github.com/NewFuture/DDNS/releases/latest/download/ddns-musl-linux_arm64 -#SLo ddns && chmod +x ddns

# 其他架构请替换下载地址 Replace URL for other architectures

# 安装到PATH目录 (Install to PATH directory)
sudo mv ddns /usr/local/bin/

# 可选定时任务 Optional scheduled task
ddns task --install

• MacOS

# ARM 芯片 Apple Silicon (M-chip)
curl https://github.com/NewFuture/DDNS/releases/latest/download/ddns-mac-arm64 -#SLo ddns && chmod +x ddns

# Intel x86_64
curl https://github.com/NewFuture/DDNS/releases/latest/download/ddns-mac-x64 -#SLo ddns && chmod +x ddns

# 安装到PATH目录 (Install to PATH directory)
sudo mv ddns /usr/local/bin/

# 可选定时任务 Optional scheduled task
ddns task --install

使用pip安装 | Install via PIP

Pypi 安装当前版本或者更新最新版本

# 安装最新版本 (Install latest version)
pip install ddns

# 或更新为最新版本 (Or upgrade to latest)
pip install -U ddns

# 或使用pipx直接运行（无需安装）Run directly with pipx (no insta...

What's Changed

• update docs
• update workflow and infra
• update build tool to latest

New Contributors

• @github-actions[bot] made their first contribution in #608

Full Changelog: v4.1.3...v4.1.4-beta1

DDNS Release Information

各版本一览表 | Download Methods Overview

Docker (推荐 Recommended)

# 当前版本 (Current version)
docker run --name ddns -v $(pwd)/:/ddns/ newfuture/ddns:latest -h

# 最新版本 (Latest version, may use cache)
docker run --name ddns -v $(pwd)/:/ddns/ newfuture/ddns -h

# 后台运行 (Run in background)
docker run -d --name ddns -v $(pwd)/:/ddns/ newfuture/ddns:latest

📁 请将 $(pwd) 替换为你的配置文件夹
📖 Replace $(pwd) with your config folder

• 使用 -h 查看帮助信息 (Use -h for help)
• config.json 支持编辑器自动补全 (config.json supports autocompletion)
• 支持 DDNS_XXX 环境变量 (Supports DDNS_XXX environment variables)

支持源 (Supported registries):

• Docker官方源 (Docker Hub): docker.io/newfuture/ddns
• Github官方源 (Github Registry): ghcr.io/newfuture/ddns

一键安装 | One-click Install

Linux/MacOS 使用安装脚本获取并安装最新版本(Use the installer to fetch and install the latest release):

• curl 安装

  curl -#fSL https://ddns.newfuture.cc/install.sh | sh -s -- latest

• wget 安装

  wget -O- https://ddns.newfuture.cc/install.sh | sh -s -- latest

需要 root 或 sudo 权限 (Requires curl and sudo).
更多说明与源码 More details and source: https://ddns.newfuture.cc

二进制文件 | Executable Binary

手动下载各平台文件和使用方式 (Download and Usage per platform):

• Windows

1. (推荐) 下载 ZIP: x64.zip · x86.zip · arm64.zip 解压并运行 ddns.exe。
   (Recommended) Download the ZIP for your arch, extract, then run ddns.exe.

2. 直接下载 EXE: x64.exe · x86.exe · arm64.exe
   (Alternatively) Download the EXE and run in cmd or PowerShell.

   ⚠️ 注意: 单文件版exe可能会被杀毒软件误报，建议使用ZIP版本或添加信任例外。
   ⚠️ Note: Single-file EXE may be flagged by antivirus software as false positive. Consider using ZIP version or adding trust exception.

3. [可选] 定时任务: 使用内置命令 ddns task --install 创建定时任务。
   (Optionally) Use the built-in command ddns task --install to create a scheduled task.

• Linux

# 常规Linux (glibc x64)
curl https://github.com/NewFuture/DDNS/releases/latest/download/ddns-glibc-linux_amd64 -#SLo ddns && chmod +x ddns

# OpenWRT/嵌入式 (musl arm64)
curl https://github.com/NewFuture/DDNS/releases/latest/download/ddns-musl-linux_arm64 -#SLo ddns && chmod +x ddns

# 其他架构请替换下载地址 Replace URL for other architectures

# 安装到PATH目录 (Install to PATH directory)
sudo mv ddns /usr/local/bin/

# 可选定时任务 Optional scheduled task
ddns task --install

• MacOS

# ARM 芯片 Apple Silicon (M-chip)
curl https://github.com/NewFuture/DDNS/releases/latest/download/ddns-mac-arm64 -#SLo ddns && chmod +x ddns

# Intel x86_64
curl https://github.com/NewFuture/DDNS/releases/latest/download/ddns-mac-x64 -#SLo ddns && chmod +x ddns

# 安装到PATH目录 (Install to PATH directory)
sudo mv ddns /usr/local/bin/

# 可选定时任务 Optional scheduled task
ddns task --install

使用pip安装 | Install via PIP

Pypi 安装当前版本或者更新最新版本

# 安装最新版本 (Install latest version)
pip install ddns

# 或更新为最新版本 (Or upgrade to latest)
pip install -U ddns

# 或使用pipx直接运行（无需安装）Run directly with pipx (no installation needed)
pipx run ddns -h

What's Changed

• docs: add streamlined AGENTS.md guide for AI contributors by @Copilot in #583
• refactor(tests): replace authid with id in all tests for consistency by @Copilot in #584
• feat(workflow): add Azure OpenAI auto-reply with classification and labeling for new issues by @Copilot in #585
• fix(workflow): use max_completion_tokens for Azure OpenAI API by @Copilot in #589
• feat(workflow): integrate github/ai-assessment-comment-labeler for automated issue triage by @Copilot in #593
• feat(workflow): include issue title in AI assessment and use JSON response format by @Copilot in #595
• Remove obsolete redirect docs from /doc/{env,json,cli}.md by @Copilot in #596
• feat(provider): add EdgeOne DNS provider for non-accelerated domain records by @Copilot in #588
• feat(ci): use JSON format and auto-convert file references to URLs in issue replies by @Copilot in #597

Full Changelog: v4.1.2...v4.1.3

DDNS Release Information

各版本一览表 | Download Methods Overview

Docker (推荐 Recommended)

# 当前版本 (Current version)
docker run --name ddns -v $(pwd)/:/ddns/ newfuture/ddns:v4.1.3 -h

# 最新版本 (Latest version, may use cache)
docker run --name ddns -v $(pwd)/:/ddns/ newfuture/ddns -h

# 后台运行 (Run in background)
docker run -d --name ddns -v $(pwd)/:/ddns/ newfuture/ddns:v4.1.3

📁 请将 $(pwd) 替换为你的配置文件夹
📖 Replace $(pwd) with your config folder

• 使用 -h 查看帮助信息 (Use -h for help)
• config.json 支持编辑器自动补全 (config.json supports autocompletion)
• 支持 DDNS_XXX 环境变量 (Supports DDNS_XXX environment variables)

支持源 (Supported registries):

• Docker官方源 (Docker Hub): docker.io/newfuture/ddns
• Github官方源 (Github Registry): ghcr.io/newfuture/ddns

一键安装 | One-click Install

Linux/MacOS 使用安装脚本获取并安装最新版本(Use the installer to fetch and install the latest release):

• curl 安装

  curl -#fSL https://ddns.newfuture.cc/install.sh | sh -s -- v4.1.3

• wget 安装

  wget -O- https://ddns.newfuture.cc/install.sh | sh -s -- v4.1.3

需要 root 或 sudo 权限 (Requires curl and sudo).
更多说明与源码 More details and source: https://ddns.newfuture.cc

二进制文件 | Executable Binary

手动下载各平台文件和使用方式 (Download and Usage per platform):

• Windows

1. (推荐) 下载 ZIP: x64.zip · x86.zip · arm64.zip 解压并运行 ddns.exe。
   (Recommended) Download the ZIP for your arch, extract, then run ddns.exe.

2. 直接下载 EXE: x64.exe · x86.exe · arm64.exe
   (Alternatively) Download the EXE and run in cmd or PowerShell.

   ⚠️ 注意: 单文件版exe可能会被杀毒软件误报，建议使用ZIP版本或添加信任例外。
   ⚠️ Note: Single-file EXE may be flagged by antivirus software as false positive. Consider using ZIP version or adding trust exception.

3. [可选] 定时任务: 使用内置命令 ddns task --install 创建定时任务。
   (Optionally) Use the built-in command ddns task --install to create a scheduled task.

• Linux

# 常规Linux (glibc x64)
curl https://github.com/NewFuture/DDNS/releases/download/v4.1.3/ddns-glibc-linux_amd64 -#SLo ddns && chmod +x ddns

# OpenWRT/嵌入式 (musl arm64)
curl https://github.com/NewFuture/DDNS/releases/download/v4.1.3/ddns-musl-linux_arm64 -#SLo ddns && chmod +x ddns

# 其他架构请替换下载地址 Replace URL for other architectures

# 安装到PATH目录 (Install to PATH directory)
sudo mv ddns /usr/local/bin/

# 可选定时任务 Optional scheduled task
ddns task --install

• MacOS

# ARM 芯片 Apple Silicon (M-chip)
curl https://github.com/NewFuture/DDNS/releases/download/v4.1.3/ddns-mac-arm64 -#SLo ddns && chmod +x ddns

# Intel x86_64
curl https://github.com/NewFuture/DDNS/releases/download/v4.1.3/ddns-mac-x64 -#SLo ddns && chmod +x ddns

# 安装到PATH目录 (Install to PATH directory)
sudo mv ddns /usr/local/bin/

# 可选定时任务 Optional scheduled task
ddns task --install

使用pip安装 | Install via PIP

Pypi 安装当前版本或者更新最新版本

# 安装最新版本 (Install latest version)
pip install ddns==4.1.3

# 或更新为最新版本 (Or upgrade to latest)
pip install -U ddns==4.1.3

# 或使用pipx直接运行（无需安装）Run directly with pipx (no installation needed)
pipx run ddns -h

What's Changed

• docs: add streamlined AGENTS.md guide for AI contributors by @Copilot in #583
• refactor(tests): replace authid with id in all tests for consistency by @Copilot in #584
• feat(workflow): add Azure OpenAI auto-reply with classification and labeling for new issues by @Copilot in #585
• fix(workflow): use max_completion_tokens for Azure OpenAI API by @Copilot in #589
• feat(workflow): integrate github/ai-assessment-comment-labeler for automated issue triage by @Copilot in #593
• feat(workflow): include issue title in AI assessment and use JSON response format by @Copilot in #595
• Remove obsolete redirect docs from /doc/{env,json,cli}.md by @Copilot in #596
• feat(provider): add EdgeOne DNS provider for non-accelerated domain records by @Copilot in #588

Full Changelog: v4.1.2...v4.1.3-beta1

DDNS Release Information

各版本一览表 | Download Methods Overview

Docker (推荐 Recommended)

# 当前版本 (Current version)
docker run --name ddns -v $(pwd)/:/ddns/ newfuture/ddns:v4.1.3-beta1 -h

# 最新版本 (Latest version, may use cache)
docker run --name ddns -v $(pwd)/:/ddns/ newfuture/ddns -h

# 后台运行 (Run in background)
docker run -d --name ddns -v $(pwd)/:/ddns/ newfuture/ddns:v4.1.3-beta1

📁 请将 $(pwd) 替换为你的配置文件夹
📖 Replace $(pwd) with your config folder

• 使用 -h 查看帮助信息 (Use -h for help)
• config.json 支持编辑器自动补全 (config.json supports autocompletion)
• 支持 DDNS_XXX 环境变量 (Supports DDNS_XXX environment variables)

支持源 (Supported registries):

• Docker官方源 (Docker Hub): docker.io/newfuture/ddns
• Github官方源 (Github Registry): ghcr.io/newfuture/ddns

一键安装 | One-click Install

Linux/MacOS 使用安装脚本获取并安装最新版本(Use the installer to fetch and install the latest release):

• curl 安装

  curl -#fSL https://ddns.newfuture.cc/install.sh | sh -s -- v4.1.3-beta1

• wget 安装

  wget -O- https://ddns.newfuture.cc/install.sh | sh -s -- v4.1.3-beta1

需要 root 或 sudo 权限 (Requires curl and sudo).
更多说明与源码 More details and source: https://ddns.newfuture.cc

二进制文件 | Executable Binary

手动下载各平台文件和使用方式 (Download and Usage per platform):

• Windows

1. (推荐) 下载 ZIP: x64.zip · x86.zip · arm64.zip 解压并运行 ddns.exe。
   (Recommended) Download the ZIP for your arch, extract, then run ddns.exe.

2. 直接下载 EXE: x64.exe · x86.exe · arm64.exe
   (Alternatively) Download the EXE and run in cmd or PowerShell.

   ⚠️ 注意: 单文件版exe可能会被杀毒软件误报，建议使用ZIP版本或添加信任例外。
   ⚠️ Note: Single-file EXE may be flagged by antivirus software as false positive. Consider using ZIP version or adding trust exception.

3. [可选] 定时任务: 使用内置命令 ddns task --install 创建定时任务。
   (Optionally) Use the built-in command ddns task --install to create a scheduled task.

• Linux

# 常规Linux (glibc x64)
curl https://github.com/NewFuture/DDNS/releases/download/v4.1.3-beta1/ddns-glibc-linux_amd64 -#SLo ddns && chmod +x ddns

# OpenWRT/嵌入式 (musl arm64)
curl https://github.com/NewFuture/DDNS/releases/download/v4.1.3-beta1/ddns-musl-linux_arm64 -#SLo ddns && chmod +x ddns

# 其他架构请替换下载地址 Replace URL for other architectures

# 安装到PATH目录 (Install to PATH directory)
sudo mv ddns /usr/local/bin/

# 可选定时任务 Optional scheduled task
ddns task --install

• MacOS

# ARM 芯片 Apple Silicon (M-chip)
curl https://github.com/NewFuture/DDNS/releases/download/v4.1.3-beta1/ddns-mac-arm64 -#SLo ddns && chmod +x ddns

# Intel x86_64
curl https://github.com/NewFuture/DDNS/releases/download/v4.1.3-beta1/ddns-mac-x64 -#SLo ddns && chmod +x ddns

# 安装到PATH目录 (Install to PATH directory)
sudo mv ddns /usr/local/bin/

# 可选定时任务 Optional scheduled task
ddns task --install

使用pip安装 | Install via PIP

Pypi 安装当前版本或者更新最新版本

# 安装最新版本 (Install latest version)
pip install ddns==4.1.3b1

# 或更新为最新版本 (Or upgrade to latest)
pip install -U ddns==4.1.3b1

# 或使用pipx直接运行（无需安装）Run directly with pipx (no installation needed)
pipx run ddns -h

What's Changed

• fix(config): exclude $schema from extra parameters sent to DNS APIs by @Copilot in #576
• refactor(docker): remove redundant patch.py call from Dockerfile by @Copilot in #580

Full Changelog: v4.1.1...v4.1.2

DDNS Release Information

各版本一览表 | Download Methods Overview

Docker (推荐 Recommended)

# 当前版本 (Current version)
docker run --name ddns -v $(pwd)/:/ddns/ newfuture/ddns:v4.1.2 -h

# 最新版本 (Latest version, may use cache)
docker run --name ddns -v $(pwd)/:/ddns/ newfuture/ddns -h

# 后台运行 (Run in background)
docker run -d --name ddns -v $(pwd)/:/ddns/ newfuture/ddns:v4.1.2

📁 请将 $(pwd) 替换为你的配置文件夹
📖 Replace $(pwd) with your config folder

• 使用 -h 查看帮助信息 (Use -h for help)
• config.json 支持编辑器自动补全 (config.json supports autocompletion)
• 支持 DDNS_XXX 环境变量 (Supports DDNS_XXX environment variables)

支持源 (Supported registries):

• Docker官方源 (Docker Hub): docker.io/newfuture/ddns
• Github官方源 (Github Registry): ghcr.io/newfuture/ddns

一键安装 | One-click Install

Linux/MacOS 使用安装脚本获取并安装最新版本(Use the installer to fetch and install the latest release):

• curl 安装

  curl -#fSL https://ddns.newfuture.cc/install.sh | sh -s -- v4.1.2

• wget 安装

  wget -O- https://ddns.newfuture.cc/install.sh | sh -s -- v4.1.2

需要 root 或 sudo 权限 (Requires curl and sudo).
更多说明与源码 More details and source: https://ddns.newfuture.cc

二进制文件 | Executable Binary

手动下载各平台文件和使用方式 (Download and Usage per platform):

• Windows

1. (推荐) 下载 ZIP: x64.zip · x86.zip · arm64.zip 解压并运行 ddns.exe。
   (Recommended) Download the ZIP for your arch, extract, then run ddns.exe.

2. 直接下载 EXE: x64.exe · x86.exe · arm64.exe
   (Alternatively) Download the EXE and run in cmd or PowerShell.

   ⚠️ 注意: 单文件版exe可能会被杀毒软件误报，建议使用ZIP版本或添加信任例外。
   ⚠️ Note: Single-file EXE may be flagged by antivirus software as false positive. Consider using ZIP version or adding trust exception.

3. [可选] 定时任务: 使用内置命令 ddns task --install 创建定时任务。
   (Optionally) Use the built-in command ddns task --install to create a scheduled task.

• Linux

# 常规Linux (glibc x64)
curl https://github.com/NewFuture/DDNS/releases/download/v4.1.2/ddns-glibc-linux_amd64 -#SLo ddns && chmod +x ddns

# OpenWRT/嵌入式 (musl arm64)
curl https://github.com/NewFuture/DDNS/releases/download/v4.1.2/ddns-musl-linux_arm64 -#SLo ddns && chmod +x ddns

# 其他架构请替换下载地址 Replace URL for other architectures

# 安装到PATH目录 (Install to PATH directory)
sudo mv ddns /usr/local/bin/

# 可选定时任务 Optional scheduled task
ddns task --install

• MacOS

# ARM 芯片 Apple Silicon (M-chip)
curl https://github.com/NewFuture/DDNS/releases/download/v4.1.2/ddns-mac-arm64 -#SLo ddns && chmod +x ddns

# Intel x86_64
curl https://github.com/NewFuture/DDNS/releases/download/v4.1.2/ddns-mac-x64 -#SLo ddns && chmod +x ddns

# 安装到PATH目录 (Install to PATH directory)
sudo mv ddns /usr/local/bin/

# 可选定时任务 Optional scheduled task
ddns task --install

使用pip安装 | Install via PIP

Pypi 安装当前版本或者更新最新版本

# 安装最新版本 (Install latest version)
pip install ddns==4.1.2

# 或更新为最新版本 (Or upgrade to latest)
pip install -U ddns==4.1.2

# 或使用pipx直接运行（无需安装）Run directly with pipx (no installation needed)
pipx run ddns -h

What's Changed

• refactor(docker): remove redundant patch.py call from Dockerfile by @Copilot in #580

Full Changelog: v4.1.2-beta2...v4.1.2-beta3

DDNS Release Information

各版本一览表 | Download Methods Overview

Docker (推荐 Recommended)

# 当前版本 (Current version)
docker run --name ddns -v $(pwd)/:/ddns/ newfuture/ddns:v4.1.2-beta3 -h

# 最新版本 (Latest version, may use cache)
docker run --name ddns -v $(pwd)/:/ddns/ newfuture/ddns -h

# 后台运行 (Run in background)
docker run -d --name ddns -v $(pwd)/:/ddns/ newfuture/ddns:v4.1.2-beta3

📁 请将 $(pwd) 替换为你的配置文件夹
📖 Replace $(pwd) with your config folder

• 使用 -h 查看帮助信息 (Use -h for help)
• config.json 支持编辑器自动补全 (config.json supports autocompletion)
• 支持 DDNS_XXX 环境变量 (Supports DDNS_XXX environment variables)

支持源 (Supported registries):

• Docker官方源 (Docker Hub): docker.io/newfuture/ddns
• Github官方源 (Github Registry): ghcr.io/newfuture/ddns

一键安装 | One-click Install

Linux/MacOS 使用安装脚本获取并安装最新版本(Use the installer to fetch and install the latest release):

• curl 安装

  curl -#fSL https://ddns.newfuture.cc/install.sh | sh -s -- v4.1.2-beta3

• wget 安装

  wget -O- https://ddns.newfuture.cc/install.sh | sh -s -- v4.1.2-beta3

需要 root 或 sudo 权限 (Requires curl and sudo).
更多说明与源码 More details and source: https://ddns.newfuture.cc

二进制文件 | Executable Binary

手动下载各平台文件和使用方式 (Download and Usage per platform):

• Windows

1. (推荐) 下载 ZIP: x64.zip · x86.zip · arm64.zip 解压并运行 ddns.exe。
   (Recommended) Download the ZIP for your arch, extract, then run ddns.exe.

2. 直接下载 EXE: x64.exe · x86.exe · arm64.exe
   (Alternatively) Download the EXE and run in cmd or PowerShell.

   ⚠️ 注意: 单文件版exe可能会被杀毒软件误报，建议使用ZIP版本或添加信任例外。
   ⚠️ Note: Single-file EXE may be flagged by antivirus software as false positive. Consider using ZIP version or adding trust exception.

3. [可选] 定时任务: 使用内置命令 ddns task --install 创建定时任务。
   (Optionally) Use the built-in command ddns task --install to create a scheduled task.

• Linux

# 常规Linux (glibc x64)
curl https://github.com/NewFuture/DDNS/releases/download/v4.1.2-beta3/ddns-glibc-linux_amd64 -#SLo ddns && chmod +x ddns

# OpenWRT/嵌入式 (musl arm64)
curl https://github.com/NewFuture/DDNS/releases/download/v4.1.2-beta3/ddns-musl-linux_arm64 -#SLo ddns && chmod +x ddns

# 其他架构请替换下载地址 Replace URL for other architectures

# 安装到PATH目录 (Install to PATH directory)
sudo mv ddns /usr/local/bin/

# 可选定时任务 Optional scheduled task
ddns task --install

• MacOS

# ARM 芯片 Apple Silicon (M-chip)
curl https://github.com/NewFuture/DDNS/releases/download/v4.1.2-beta3/ddns-mac-arm64 -#SLo ddns && chmod +x ddns

# Intel x86_64
curl https://github.com/NewFuture/DDNS/releases/download/v4.1.2-beta3/ddns-mac-x64 -#SLo ddns && chmod +x ddns

# 安装到PATH目录 (Install to PATH directory)
sudo mv ddns /usr/local/bin/

# 可选定时任务 Optional scheduled task
ddns task --install

使用pip安装 | Install via PIP

Pypi 安装当前版本或者更新最新版本

# 安装最新版本 (Install latest version)
pip install ddns==4.1.2b3

# 或更新为最新版本 (Or upgrade to latest)
pip install -U ddns==4.1.2b3

# 或使用pipx直接运行（无需安装）Run directly with pipx (no installation needed)
pipx run ddns -h

What's Changed

• fix(workflows): pass GITHUB_REF_NAME to workflows for correct version in extraction path by @Copilot in #579

Full Changelog: v4.1.2-beta1...v4.1.2-beta2

DDNS Release Information

各版本一览表 | Download Methods Overview

Docker (推荐 Recommended)

# 当前版本 (Current version)
docker run --name ddns -v $(pwd)/:/ddns/ newfuture/ddns:v4.1.2-beta2 -h

# 最新版本 (Latest version, may use cache)
docker run --name ddns -v $(pwd)/:/ddns/ newfuture/ddns -h

# 后台运行 (Run in background)
docker run -d --name ddns -v $(pwd)/:/ddns/ newfuture/ddns:v4.1.2-beta2

📁 请将 $(pwd) 替换为你的配置文件夹
📖 Replace $(pwd) with your config folder

• 使用 -h 查看帮助信息 (Use -h for help)
• config.json 支持编辑器自动补全 (config.json supports autocompletion)
• 支持 DDNS_XXX 环境变量 (Supports DDNS_XXX environment variables)

支持源 (Supported registries):

• Docker官方源 (Docker Hub): docker.io/newfuture/ddns
• Github官方源 (Github Registry): ghcr.io/newfuture/ddns

一键安装 | One-click Install

Linux/MacOS 使用安装脚本获取并安装最新版本(Use the installer to fetch and install the latest release):

• curl 安装

  curl -#fSL https://ddns.newfuture.cc/install.sh | sh -s -- v4.1.2-beta2

• wget 安装

  wget -O- https://ddns.newfuture.cc/install.sh | sh -s -- v4.1.2-beta2

需要 root 或 sudo 权限 (Requires curl and sudo).
更多说明与源码 More details and source: https://ddns.newfuture.cc

二进制文件 | Executable Binary

手动下载各平台文件和使用方式 (Download and Usage per platform):

• Windows

1. (推荐) 下载 ZIP: x64.zip · x86.zip · arm64.zip 解压并运行 ddns.exe。
   (Recommended) Download the ZIP for your arch, extract, then run ddns.exe.

2. 直接下载 EXE: x64.exe · x86.exe · arm64.exe
   (Alternatively) Download the EXE and run in cmd or PowerShell.

   ⚠️ 注意: 单文件版exe可能会被杀毒软件误报，建议使用ZIP版本或添加信任例外。
   ⚠️ Note: Single-file EXE may be flagged by antivirus software as false positive. Consider using ZIP version or adding trust exception.

3. [可选] 定时任务: 使用内置命令 ddns task --install 创建定时任务。
   (Optionally) Use the built-in command ddns task --install to create a scheduled task.

• Linux

# 常规Linux (glibc x64)
curl https://github.com/NewFuture/DDNS/releases/download/v4.1.2-beta2/ddns-glibc-linux_amd64 -#SLo ddns && chmod +x ddns

# OpenWRT/嵌入式 (musl arm64)
curl https://github.com/NewFuture/DDNS/releases/download/v4.1.2-beta2/ddns-musl-linux_arm64 -#SLo ddns && chmod +x ddns

# 其他架构请替换下载地址 Replace URL for other architectures

# 安装到PATH目录 (Install to PATH directory)
sudo mv ddns /usr/local/bin/

# 可选定时任务 Optional scheduled task
ddns task --install

• MacOS

# ARM 芯片 Apple Silicon (M-chip)
curl https://github.com/NewFuture/DDNS/releases/download/v4.1.2-beta2/ddns-mac-arm64 -#SLo ddns && chmod +x ddns

# Intel x86_64
curl https://github.com/NewFuture/DDNS/releases/download/v4.1.2-beta2/ddns-mac-x64 -#SLo ddns && chmod +x ddns

# 安装到PATH目录 (Install to PATH directory)
sudo mv ddns /usr/local/bin/

# 可选定时任务 Optional scheduled task
ddns task --install

使用pip安装 | Install via PIP

Pypi 安装当前版本或者更新最新版本

# 安装最新版本 (Install latest version)
pip install ddns==4.1.2b2

# 或更新为最新版本 (Or upgrade to latest)
pip install -U ddns==4.1.2b2

# 或使用pipx直接运行（无需安装）Run directly with pipx (no installation needed)
pipx run ddns -h

What's Changed

• fix(config): exclude $schema from extra parameters sent to DNS APIs by @Copilot in #576

Full Changelog: v4.1.1...v4.1.2-beta1

DDNS Release Information

各版本一览表 | Download Methods Overview

Docker (推荐 Recommended)

# 当前版本 (Current version)
docker run --name ddns -v $(pwd)/:/ddns/ newfuture/ddns:v4.1.2-beta1 -h

# 最新版本 (Latest version, may use cache)
docker run --name ddns -v $(pwd)/:/ddns/ newfuture/ddns -h

# 后台运行 (Run in background)
docker run -d --name ddns -v $(pwd)/:/ddns/ newfuture/ddns:v4.1.2-beta1

📁 请将 $(pwd) 替换为你的配置文件夹
📖 Replace $(pwd) with your config folder

• 使用 -h 查看帮助信息 (Use -h for help)
• config.json 支持编辑器自动补全 (config.json supports autocompletion)
• 支持 DDNS_XXX 环境变量 (Supports DDNS_XXX environment variables)

支持源 (Supported registries):

• Docker官方源 (Docker Hub): docker.io/newfuture/ddns
• Github官方源 (Github Registry): ghcr.io/newfuture/ddns

一键安装 | One-click Install

Linux/MacOS 使用安装脚本获取并安装最新版本(Use the installer to fetch and install the latest release):

• curl 安装

  curl -#fSL https://ddns.newfuture.cc/install.sh | sh -s -- v4.1.2-beta1

• wget 安装

  wget -O- https://ddns.newfuture.cc/install.sh | sh -s -- v4.1.2-beta1

需要 root 或 sudo 权限 (Requires curl and sudo).
更多说明与源码 More details and source: https://ddns.newfuture.cc

二进制文件 | Executable Binary

手动下载各平台文件和使用方式 (Download and Usage per platform):

• Windows

1. (推荐) 下载 ZIP: x64.zip · x86.zip · arm64.zip 解压并运行 ddns.exe。
   (Recommended) Download the ZIP for your arch, extract, then run ddns.exe.

2. 直接下载 EXE: x64.exe · x86.exe · arm64.exe
   (Alternatively) Download the EXE and run in cmd or PowerShell.

   ⚠️ 注意: 单文件版exe可能会被杀毒软件误报，建议使用ZIP版本或添加信任例外。
   ⚠️ Note: Single-file EXE may be flagged by antivirus software as false positive. Consider using ZIP version or adding trust exception.

3. [可选] 定时任务: 使用内置命令 ddns task --install 创建定时任务。
   (Optionally) Use the built-in command ddns task --install to create a scheduled task.

• Linux

# 常规Linux (glibc x64)
curl https://github.com/NewFuture/DDNS/releases/download/v4.1.2-beta1/ddns-glibc-linux_amd64 -#SLo ddns && chmod +x ddns

# OpenWRT/嵌入式 (musl arm64)
curl https://github.com/NewFuture/DDNS/releases/download/v4.1.2-beta1/ddns-musl-linux_arm64 -#SLo ddns && chmod +x ddns

# 其他架构请替换下载地址 Replace URL for other architectures

# 安装到PATH目录 (Install to PATH directory)
sudo mv ddns /usr/local/bin/

# 可选定时任务 Optional scheduled task
ddns task --install

• MacOS

# ARM 芯片 Apple Silicon (M-chip)
curl https://github.com/NewFuture/DDNS/releases/download/v4.1.2-beta1/ddns-mac-arm64 -#SLo ddns && chmod +x ddns

# Intel x86_64
curl https://github.com/NewFuture/DDNS/releases/download/v4.1.2-beta1/ddns-mac-x64 -#SLo ddns && chmod +x ddns

# 安装到PATH目录 (Install to PATH directory)
sudo mv ddns /usr/local/bin/

# 可选定时任务 Optional scheduled task
ddns task --install

使用pip安装 | Install via PIP

Pypi 安装当前版本或者更新最新版本

# 安装最新版本 (Install latest version)
pip install ddns==4.1.2b1

# 或更新为最新版本 (Or upgrade to latest)
pip install -U ddns==4.1.2b1

# 或使用pipx直接运行（无需安装）Run directly with pipx (no installation needed)
pipx run ddns -h

What's Changed

• fix(ci): extend Windows x86 timeout to 20 minutes in publish workflow by @Copilot in #559
• feat(config): add support for extra configuration fields by @Copilot in #562
• fix(config): restore log.file configuration for v4.1 multi-provider format by @Copilot in #564
• fix(provider): ensure extra params take priority over old_record in _update_record by @Copilot in #566
• fix(cloudflare): DNS record query conditions - Boolean encoding and extra filter fallback by @Copilot in #571
• fix: add missing packages to pip distribution (config and scheduler) by @Copilot in #572
• feat(docker): add DDNS_CRON environment variable for customizable cron schedule by @Copilot in #574

Full Changelog: v4.1.0...v4.1.1

DDNS Release Information

各版本一览表 | Download Methods Overview

Docker (推荐 Recommended)

# 当前版本 (Current version)
docker run --name ddns -v $(pwd)/:/ddns/ newfuture/ddns:v4.1.1 -h

# 最新版本 (Latest version, may use cache)
docker run --name ddns -v $(pwd)/:/ddns/ newfuture/ddns -h

# 后台运行 (Run in background)
docker run -d --name ddns -v $(pwd)/:/ddns/ newfuture/ddns:v4.1.1

📁 请将 $(pwd) 替换为你的配置文件夹
📖 Replace $(pwd) with your config folder

• 使用 -h 查看帮助信息 (Use -h for help)
• config.json 支持编辑器自动补全 (config.json supports autocompletion)
• 支持 DDNS_XXX 环境变量 (Supports DDNS_XXX environment variables)

支持源 (Supported registries):

• Docker官方源 (Docker Hub): docker.io/newfuture/ddns
• Github官方源 (Github Registry): ghcr.io/newfuture/ddns

一键安装 | One-click Install

Linux/MacOS 使用安装脚本获取并安装最新版本(Use the installer to fetch and install the latest release):

• curl 安装

  curl -#fSL https://ddns.newfuture.cc/install.sh | sh -s -- v4.1.1

• wget 安装

  wget -O- https://ddns.newfuture.cc/install.sh | sh -s -- v4.1.1

需要 root 或 sudo 权限 (Requires curl and sudo).
更多说明与源码 More details and source: https://ddns.newfuture.cc

二进制文件 | Executable Binary

手动下载各平台文件和使用方式 (Download and Usage per platform):

• Windows

1. (推荐) 下载 ZIP: x64.zip · x86.zip · arm64.zip 解压并运行 ddns.exe。
   (Recommended) Download the ZIP for your arch, extract, then run ddns.exe.

2. 直接下载 EXE: x64.exe · x86.exe · arm64.exe
   (Alternatively) Download the EXE and run in cmd or PowerShell.

   ⚠️ 注意: 单文件版exe可能会被杀毒软件误报，建议使用ZIP版本或添加信任例外。
   ⚠️ Note: Single-file EXE may be flagged by antivirus software as false positive. Consider using ZIP version or adding trust exception.

3. [可选] 定时任务: 使用内置命令 ddns task --install 创建定时任务。
   (Optionally) Use the built-in command ddns task --install to create a scheduled task.

• Linux

# 常规Linux (glibc x64)
curl https://github.com/NewFuture/DDNS/releases/download/v4.1.1/ddns-glibc-linux_amd64 -#SLo ddns && chmod +x ddns

# OpenWRT/嵌入式 (musl arm64)
curl https://github.com/NewFuture/DDNS/releases/download/v4.1.1/ddns-musl-linux_arm64 -#SLo ddns && chmod +x ddns

# 其他架构请替换下载地址 Replace URL for other architectures

# 安装到PATH目录 (Install to PATH directory)
sudo mv ddns /usr/local/bin/

# 可选定时任务 Optional scheduled task
ddns task --install

• MacOS

# ARM 芯片 Apple Silicon (M-chip)
curl https://github.com/NewFuture/DDNS/releases/download/v4.1.1/ddns-mac-arm64 -#SLo ddns && chmod +x ddns

# Intel x86_64
curl https://github.com/NewFuture/DDNS/releases/download/v4.1.1/ddns-mac-x64 -#SLo ddns && chmod +x ddns

# 安装到PATH目录 (Install to PATH directory)
sudo mv ddns /usr/local/bin/

# 可选定时任务 Optional scheduled task
ddns task --install

使用pip安装 | Install via PIP

Pypi 安装当前版本或者更新最新版本

# 安装最新版本 (Install latest version)
pip install ddns==4.1.1

# 或更新为最新版本 (Or upgrade to latest)
pip install -U ddns==4.1.1

# 或使用pipx直接运行（无需安装）Run directly with pipx (no installation needed)
pipx run ddns -h

What's Changed

• feat(docker): add DDNS_CRON environment variable for customizable cron schedule by @Copilot in #574

Full Changelog: v4.1.1-beta1...v4.1.1-beta2

DDNS Release Information

各版本一览表 | Download Methods Overview

Docker (推荐 Recommended)

# 当前版本 (Current version)
docker run --name ddns -v $(pwd)/:/ddns/ newfuture/ddns:v4.1.1-beta2 -h

# 最新版本 (Latest version, may use cache)
docker run --name ddns -v $(pwd)/:/ddns/ newfuture/ddns -h

# 后台运行 (Run in background)
docker run -d --name ddns -v $(pwd)/:/ddns/ newfuture/ddns:v4.1.1-beta2

📁 请将 $(pwd) 替换为你的配置文件夹
📖 Replace $(pwd) with your config folder

• 使用 -h 查看帮助信息 (Use -h for help)
• config.json 支持编辑器自动补全 (config.json supports autocompletion)
• 支持 DDNS_XXX 环境变量 (Supports DDNS_XXX environment variables)

支持源 (Supported registries):

• Docker官方源 (Docker Hub): docker.io/newfuture/ddns
• Github官方源 (Github Registry): ghcr.io/newfuture/ddns

一键安装 | One-click Install

Linux/MacOS 使用安装脚本获取并安装最新版本(Use the installer to fetch and install the latest release):

• curl 安装

  curl -#fSL https://ddns.newfuture.cc/install.sh | sh -s -- v4.1.1-beta2

• wget 安装

  wget -O- https://ddns.newfuture.cc/install.sh | sh -s -- v4.1.1-beta2

需要 root 或 sudo 权限 (Requires curl and sudo).
更多说明与源码 More details and source: https://ddns.newfuture.cc

二进制文件 | Executable Binary

手动下载各平台文件和使用方式 (Download and Usage per platform):

• Windows

1. (推荐) 下载 ZIP: x64.zip · x86.zip · arm64.zip 解压并运行 ddns.exe。
   (Recommended) Download the ZIP for your arch, extract, then run ddns.exe.

2. 直接下载 EXE: x64.exe · x86.exe · arm64.exe
   (Alternatively) Download the EXE and run in cmd or PowerShell.

   ⚠️ 注意: 单文件版exe可能会被杀毒软件误报，建议使用ZIP版本或添加信任例外。
   ⚠️ Note: Single-file EXE may be flagged by antivirus software as false positive. Consider using ZIP version or adding trust exception.

3. [可选] 定时任务: 使用内置命令 ddns task --install 创建定时任务。
   (Optionally) Use the built-in command ddns task --install to create a scheduled task.

• Linux

# 常规Linux (glibc x64)
curl https://github.com/NewFuture/DDNS/releases/download/v4.1.1-beta2/ddns-glibc-linux_amd64 -#SLo ddns && chmod +x ddns

# OpenWRT/嵌入式 (musl arm64)
curl https://github.com/NewFuture/DDNS/releases/download/v4.1.1-beta2/ddns-musl-linux_arm64 -#SLo ddns && chmod +x ddns

# 其他架构请替换下载地址 Replace URL for other architectures

# 安装到PATH目录 (Install to PATH directory)
sudo mv ddns /usr/local/bin/

# 可选定时任务 Optional scheduled task
ddns task --install

• MacOS

# ARM 芯片 Apple Silicon (M-chip)
curl https://github.com/NewFuture/DDNS/releases/download/v4.1.1-beta2/ddns-mac-arm64 -#SLo ddns && chmod +x ddns

# Intel x86_64
curl https://github.com/NewFuture/DDNS/releases/download/v4.1.1-beta2/ddns-mac-x64 -#SLo ddns && chmod +x ddns

# 安装到PATH目录 (Install to PATH directory)
sudo mv ddns /usr/local/bin/

# 可选定时任务 Optional scheduled task
ddns task --install

使用pip安装 | Install via PIP

Pypi 安装当前版本或者更新最新版本

# 安装最新版本 (Install latest version)
pip install ddns==4.1.1b2

# 或更新为最新版本 (Or upgrade to latest)
pip install -U ddns==4.1.1b2

# 或使用pipx直接运行（无需安装）Run directly with pipx (no installation needed)
pipx run ddns -h