v4.1.3

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

系统环境 (System)	架构支持 (Architecture)	说明 (Description)
Docker	x64, 386, arm64, armv7, armv6, s390x, ppc64le, riscv64 Github Registry Docker Hub	支持8种架构 docker pull ghcr.io/newfuture/ddns:v4.1.3 🚀 docker pull newfuture/ddns:v4.1.3
Windows	x64: x64.zip · x64.exe x86: x86.zip · x86.exe arm64: arm64.zip · arm64.exe	在最新 Windows 10 和 Windows 11 测试。 ✅ Tested on Windows 10 and Windows 11
GNU Linux	64-bit (ddns-glibc-linux_amd64) 32-bit (ddns-glibc-linux_386) ARM64 (ddns-glibc-linux_arm64) ARM/V7 (ddns-glibc-linux_arm_v7)	常规Linux桌面或服务器，需GLIBC≥2.28。 （如 Debian 9+、Ubuntu 20.04+、CentOS 8+） 🐧 For common Linux desktop/server with GLIBC ≥ 2.28
Musl Linux	64-bit (ddns-musl-linux_amd64) 32-bit (ddns-musl-linux_386) ARM64 (ddns-musl-linux_arm64) ARM/V7 (ddns-musl-linux_arm_v7) ARM/V6 (ddns-musl-linux_arm_v6)	适用于OpenWRT及嵌入式系统（musl ≥ 1.1.24），如OpenWRT 19+；ARMv6未测试。 🛠️ For OpenWRT and embedded systems with musl ≥ 1.1.24. ARMv6 not tested.
macOS	ARM/M-chip (ddns-mac-arm64) Intel x86_64 (ddns-mac-x64)	仅虚拟环境测试，未在真机测试 🍎 Tested in virtual environments only
PIP	ddns (全平台)	可通过 pip/pip2/pip3/easy_install 安装，部分环境自动添加至 PATH。 📦 Installable via pip and easy_install. May auto-register in PATH
Pipx	pipx run ddns (全平台)	🚀 直接运行无需安装，独立虚拟环境避免冲突。 🚀 Run directly without installation, isolated virtual environment.
Python	源码 Source code (全平台) zip + tar	可在 Python 2.7 或 Python 3 上直接运行，无需依赖 🐍 Directly runnable with Python 2.7 or Python 3. No extra dependencies.

---

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

v4.1.3-beta1

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

系统环境 (System)	架构支持 (Architecture)	说明 (Description)
Docker	x64, 386, arm64, armv7, armv6, s390x, ppc64le, riscv64 Github Registry Docker Hub	支持8种架构 docker pull ghcr.io/newfuture/ddns:v4.1.3-beta1 🚀 docker pull newfuture/ddns:v4.1.3-beta1
Windows	x64: x64.zip · x64.exe x86: x86.zip · x86.exe arm64: arm64.zip · arm64.exe	在最新 Windows 10 和 Windows 11 测试。 ✅ Tested on Windows 10 and Windows 11
GNU Linux	64-bit (ddns-glibc-linux_amd64) 32-bit (ddns-glibc-linux_386) ARM64 (ddns-glibc-linux_arm64) ARM/V7 (ddns-glibc-linux_arm_v7)	常规Linux桌面或服务器，需GLIBC≥2.28。 （如 Debian 9+、Ubuntu 20.04+、CentOS 8+） 🐧 For common Linux desktop/server with GLIBC ≥ 2.28
Musl Linux	64-bit (ddns-musl-linux_amd64) 32-bit (ddns-musl-linux_386) ARM64 (ddns-musl-linux_arm64) ARM/V7 (ddns-musl-linux_arm_v7) ARM/V6 (ddns-musl-linux_arm_v6)	适用于OpenWRT及嵌入式系统（musl ≥ 1.1.24），如OpenWRT 19+；ARMv6未测试。 🛠️ For OpenWRT and embedded systems with musl ≥ 1.1.24. ARMv6 not tested.
macOS	ARM/M-chip (ddns-mac-arm64) Intel x86_64 (ddns-mac-x64)	仅虚拟环境测试，未在真机测试 🍎 Tested in virtual environments only
PIP	ddns (全平台)	可通过 pip/pip2/pip3/easy_install 安装，部分环境自动添加至 PATH。 📦 Installable via pip and easy_install. May auto-register in PATH
Pipx	pipx run ddns (全平台)	🚀 直接运行无需安装，独立虚拟环境避免冲突。 🚀 Run directly without installation, isolated virtual environment.
Python	源码 Source code (全平台) zip + tar	可在 Python 2.7 或 Python 3 上直接运行，无需依赖 🐍 Directly runnable with Python 2.7 or Python 3. No extra dependencies.

---

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

v4.1.2

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

系统环境 (System)	架构支持 (Architecture)	说明 (Description)
Docker	x64, 386, arm64, armv7, armv6, s390x, ppc64le, riscv64 Github Registry Docker Hub	支持8种架构 docker pull ghcr.io/newfuture/ddns:v4.1.2 🚀 docker pull newfuture/ddns:v4.1.2
Windows	x64: x64.zip · x64.exe x86: x86.zip · x86.exe arm64: arm64.zip · arm64.exe	在最新 Windows 10 和 Windows 11 测试。 ✅ Tested on Windows 10 and Windows 11
GNU Linux	64-bit (ddns-glibc-linux_amd64) 32-bit (ddns-glibc-linux_386) ARM64 (ddns-glibc-linux_arm64) ARM/V7 (ddns-glibc-linux_arm_v7)	常规Linux桌面或服务器，需GLIBC≥2.28。 （如 Debian 9+、Ubuntu 20.04+、CentOS 8+） 🐧 For common Linux desktop/server with GLIBC ≥ 2.28
Musl Linux	64-bit (ddns-musl-linux_amd64) 32-bit (ddns-musl-linux_386) ARM64 (ddns-musl-linux_arm64) ARM/V7 (ddns-musl-linux_arm_v7) ARM/V6 (ddns-musl-linux_arm_v6)	适用于OpenWRT及嵌入式系统（musl ≥ 1.1.24），如OpenWRT 19+；ARMv6未测试。 🛠️ For OpenWRT and embedded systems with musl ≥ 1.1.24. ARMv6 not tested.
macOS	ARM/M-chip (ddns-mac-arm64) Intel x86_64 (ddns-mac-x64)	仅虚拟环境测试，未在真机测试 🍎 Tested in virtual environments only
PIP	ddns (全平台)	可通过 pip/pip2/pip3/easy_install 安装，部分环境自动添加至 PATH。 📦 Installable via pip and easy_install. May auto-register in PATH
Pipx	pipx run ddns (全平台)	🚀 直接运行无需安装，独立虚拟环境避免冲突。 🚀 Run directly without installation, isolated virtual environment.
Python	源码 Source code (全平台) zip + tar	可在 Python 2.7 或 Python 3 上直接运行，无需依赖 🐍 Directly runnable with Python 2.7 or Python 3. No extra dependencies.

---

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

v4.1.2-beta3

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

系统环境 (System)	架构支持 (Architecture)	说明 (Description)
Docker	x64, 386, arm64, armv7, armv6, s390x, ppc64le, riscv64 Github Registry Docker Hub	支持8种架构 docker pull ghcr.io/newfuture/ddns:v4.1.2-beta3 🚀 docker pull newfuture/ddns:v4.1.2-beta3
Windows	x64: x64.zip · x64.exe x86: x86.zip · x86.exe arm64: arm64.zip · arm64.exe	在最新 Windows 10 和 Windows 11 测试。 ✅ Tested on Windows 10 and Windows 11
GNU Linux	64-bit (ddns-glibc-linux_amd64) 32-bit (ddns-glibc-linux_386) ARM64 (ddns-glibc-linux_arm64) ARM/V7 (ddns-glibc-linux_arm_v7)	常规Linux桌面或服务器，需GLIBC≥2.28。 （如 Debian 9+、Ubuntu 20.04+、CentOS 8+） 🐧 For common Linux desktop/server with GLIBC ≥ 2.28
Musl Linux	64-bit (ddns-musl-linux_amd64) 32-bit (ddns-musl-linux_386) ARM64 (ddns-musl-linux_arm64) ARM/V7 (ddns-musl-linux_arm_v7) ARM/V6 (ddns-musl-linux_arm_v6)	适用于OpenWRT及嵌入式系统（musl ≥ 1.1.24），如OpenWRT 19+；ARMv6未测试。 🛠️ For OpenWRT and embedded systems with musl ≥ 1.1.24. ARMv6 not tested.
macOS	ARM/M-chip (ddns-mac-arm64) Intel x86_64 (ddns-mac-x64)	仅虚拟环境测试，未在真机测试 🍎 Tested in virtual environments only
PIP	ddns (全平台)	可通过 pip/pip2/pip3/easy_install 安装，部分环境自动添加至 PATH。 📦 Installable via pip and easy_install. May auto-register in PATH
Pipx	pipx run ddns (全平台)	🚀 直接运行无需安装，独立虚拟环境避免冲突。 🚀 Run directly without installation, isolated virtual environment.
Python	源码 Source code (全平台) zip + tar	可在 Python 2.7 或 Python 3 上直接运行，无需依赖 🐍 Directly runnable with Python 2.7 or Python 3. No extra dependencies.

---

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

v4.1.2-beta2

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

系统环境 (System)	架构支持 (Architecture)	说明 (Description)
Docker	x64, 386, arm64, armv7, armv6, s390x, ppc64le, riscv64 Github Registry Docker Hub	支持8种架构 docker pull ghcr.io/newfuture/ddns:v4.1.2-beta2 🚀 docker pull newfuture/ddns:v4.1.2-beta2
Windows	x64: x64.zip · x64.exe x86: x86.zip · x86.exe arm64: arm64.zip · arm64.exe	在最新 Windows 10 和 Windows 11 测试。 ✅ Tested on Windows 10 and Windows 11
GNU Linux	64-bit (ddns-glibc-linux_amd64) 32-bit (ddns-glibc-linux_386) ARM64 (ddns-glibc-linux_arm64) ARM/V7 (ddns-glibc-linux_arm_v7)	常规Linux桌面或服务器，需GLIBC≥2.28。 （如 Debian 9+、Ubuntu 20.04+、CentOS 8+） 🐧 For common Linux desktop/server with GLIBC ≥ 2.28
Musl Linux	64-bit (ddns-musl-linux_amd64) 32-bit (ddns-musl-linux_386) ARM64 (ddns-musl-linux_arm64) ARM/V7 (ddns-musl-linux_arm_v7) ARM/V6 (ddns-musl-linux_arm_v6)	适用于OpenWRT及嵌入式系统（musl ≥ 1.1.24），如OpenWRT 19+；ARMv6未测试。 🛠️ For OpenWRT and embedded systems with musl ≥ 1.1.24. ARMv6 not tested.
macOS	ARM/M-chip (ddns-mac-arm64) Intel x86_64 (ddns-mac-x64)	仅虚拟环境测试，未在真机测试 🍎 Tested in virtual environments only
PIP	ddns (全平台)	可通过 pip/pip2/pip3/easy_install 安装，部分环境自动添加至 PATH。 📦 Installable via pip and easy_install. May auto-register in PATH
Pipx	pipx run ddns (全平台)	🚀 直接运行无需安装，独立虚拟环境避免冲突。 🚀 Run directly without installation, isolated virtual environment.
Python	源码 Source code (全平台) zip + tar	可在 Python 2.7 或 Python 3 上直接运行，无需依赖 🐍 Directly runnable with Python 2.7 or Python 3. No extra dependencies.

---

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

v4.1.2-beta1

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

系统环境 (System)	架构支持 (Architecture)	说明 (Description)
Docker	x64, 386, arm64, armv7, armv6, s390x, ppc64le, riscv64 Github Registry Docker Hub	支持8种架构 docker pull ghcr.io/newfuture/ddns:v4.1.2-beta1 🚀 docker pull newfuture/ddns:v4.1.2-beta1
Windows	x64: x64.zip · x64.exe x86: x86.zip · x86.exe arm64: arm64.zip · arm64.exe	在最新 Windows 10 和 Windows 11 测试。 ✅ Tested on Windows 10 and Windows 11
GNU Linux	64-bit (ddns-glibc-linux_amd64) 32-bit (ddns-glibc-linux_386) ARM64 (ddns-glibc-linux_arm64) ARM/V7 (ddns-glibc-linux_arm_v7)	常规Linux桌面或服务器，需GLIBC≥2.28。 （如 Debian 9+、Ubuntu 20.04+、CentOS 8+） 🐧 For common Linux desktop/server with GLIBC ≥ 2.28
Musl Linux	64-bit (ddns-musl-linux_amd64) 32-bit (ddns-musl-linux_386) ARM64 (ddns-musl-linux_arm64) ARM/V7 (ddns-musl-linux_arm_v7) ARM/V6 (ddns-musl-linux_arm_v6)	适用于OpenWRT及嵌入式系统（musl ≥ 1.1.24），如OpenWRT 19+；ARMv6未测试。 🛠️ For OpenWRT and embedded systems with musl ≥ 1.1.24. ARMv6 not tested.
macOS	ARM/M-chip (ddns-mac-arm64) Intel x86_64 (ddns-mac-x64)	仅虚拟环境测试，未在真机测试 🍎 Tested in virtual environments only
PIP	ddns (全平台)	可通过 pip/pip2/pip3/easy_install 安装，部分环境自动添加至 PATH。 📦 Installable via pip and easy_install. May auto-register in PATH
Pipx	pipx run ddns (全平台)	🚀 直接运行无需安装，独立虚拟环境避免冲突。 🚀 Run directly without installation, isolated virtual environment.
Python	源码 Source code (全平台) zip + tar	可在 Python 2.7 或 Python 3 上直接运行，无需依赖 🐍 Directly runnable with Python 2.7 or Python 3. No extra dependencies.

---

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

v4.1.1

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

系统环境 (System)	架构支持 (Architecture)	说明 (Description)
Docker	x64, 386, arm64, armv7, armv6, s390x, ppc64le, riscv64 Github Registry Docker Hub	支持8种架构 docker pull ghcr.io/newfuture/ddns:v4.1.1 🚀 docker pull newfuture/ddns:v4.1.1
Windows	x64: x64.zip · x64.exe x86: x86.zip · x86.exe arm64: arm64.zip · arm64.exe	在最新 Windows 10 和 Windows 11 测试。 ✅ Tested on Windows 10 and Windows 11
GNU Linux	64-bit (ddns-glibc-linux_amd64) 32-bit (ddns-glibc-linux_386) ARM64 (ddns-glibc-linux_arm64) ARM/V7 (ddns-glibc-linux_arm_v7)	常规Linux桌面或服务器，需GLIBC≥2.28。 （如 Debian 9+、Ubuntu 20.04+、CentOS 8+） 🐧 For common Linux desktop/server with GLIBC ≥ 2.28
Musl Linux	64-bit (ddns-musl-linux_amd64) 32-bit (ddns-musl-linux_386) ARM64 (ddns-musl-linux_arm64) ARM/V7 (ddns-musl-linux_arm_v7) ARM/V6 (ddns-musl-linux_arm_v6)	适用于OpenWRT及嵌入式系统（musl ≥ 1.1.24），如OpenWRT 19+；ARMv6未测试。 🛠️ For OpenWRT and embedded systems with musl ≥ 1.1.24. ARMv6 not tested.
macOS	ARM/M-chip (ddns-mac-arm64) Intel x86_64 (ddns-mac-x64)	仅虚拟环境测试，未在真机测试 🍎 Tested in virtual environments only
PIP	ddns (全平台)	可通过 pip/pip2/pip3/easy_install 安装，部分环境自动添加至 PATH。 📦 Installable via pip and easy_install. May auto-register in PATH
Pipx	pipx run ddns (全平台)	🚀 直接运行无需安装，独立虚拟环境避免冲突。 🚀 Run directly without installation, isolated virtual environment.
Python	源码 Source code (全平台) zip + tar	可在 Python 2.7 或 Python 3 上直接运行，无需依赖 🐍 Directly runnable with Python 2.7 or Python 3. No extra dependencies.

---

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

v4.1.1-beta2

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

系统环境 (System)	架构支持 (Architecture)	说明 (Description)
Docker	x64, 386, arm64, armv7, armv6, s390x, ppc64le, riscv64 Github Registry Docker Hub	支持8种架构 docker pull ghcr.io/newfuture/ddns:v4.1.1-beta2 🚀 docker pull newfuture/ddns:v4.1.1-beta2
Windows	x64: x64.zip · x64.exe x86: x86.zip · x86.exe arm64: arm64.zip · arm64.exe	在最新 Windows 10 和 Windows 11 测试。 ✅ Tested on Windows 10 and Windows 11
GNU Linux	64-bit (ddns-glibc-linux_amd64) 32-bit (ddns-glibc-linux_386) ARM64 (ddns-glibc-linux_arm64) ARM/V7 (ddns-glibc-linux_arm_v7)	常规Linux桌面或服务器，需GLIBC≥2.28。 （如 Debian 9+、Ubuntu 20.04+、CentOS 8+） 🐧 For common Linux desktop/server with GLIBC ≥ 2.28
Musl Linux	64-bit (ddns-musl-linux_amd64) 32-bit (ddns-musl-linux_386) ARM64 (ddns-musl-linux_arm64) ARM/V7 (ddns-musl-linux_arm_v7) ARM/V6 (ddns-musl-linux_arm_v6)	适用于OpenWRT及嵌入式系统（musl ≥ 1.1.24），如OpenWRT 19+；ARMv6未测试。 🛠️ For OpenWRT and embedded systems with musl ≥ 1.1.24. ARMv6 not tested.
macOS	ARM/M-chip (ddns-mac-arm64) Intel x86_64 (ddns-mac-x64)	仅虚拟环境测试，未在真机测试 🍎 Tested in virtual environments only
PIP	ddns (全平台)	可通过 pip/pip2/pip3/easy_install 安装，部分环境自动添加至 PATH。 📦 Installable via pip and easy_install. May auto-register in PATH
Pipx	pipx run ddns (全平台)	🚀 直接运行无需安装，独立虚拟环境避免冲突。 🚀 Run directly without installation, isolated virtual environment.
Python	源码 Source code (全平台) zip + tar	可在 Python 2.7 或 Python 3 上直接运行，无需依赖 🐍 Directly runnable with Python 2.7 or Python 3. No extra dependencies.

---

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

v4.1.1-beta1

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

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

DDNS Release Information

各版本一览表 | Download Methods Overview

系统环境 (System)	架构支持 (Architecture)	说明 (Description)
Docker	x64, 386, arm64, armv7, armv6, s390x, ppc64le, riscv64 Github Registry Docker Hub	支持8种架构 docker pull ghcr.io/newfuture/ddns:v4.1.1-beta1 🚀 docker pull newfuture/ddns:v4.1.1-beta1
Windows	x64: x64.zip · x64.exe x86: x86.zip · x86.exe arm64: arm64.zip · arm64.exe	在最新 Windows 10 和 Windows 11 测试。 ✅ Tested on Windows 10 and Windows 11
GNU Linux	64-bit (ddns-glibc-linux_amd64) 32-bit (ddns-glibc-linux_386) ARM64 (ddns-glibc-linux_arm64) ARM/V7 (ddns-glibc-linux_arm_v7)	常规Linux桌面或服务器，需GLIBC≥2.28。 （如 Debian 9+、Ubuntu 20.04+、CentOS 8+） 🐧 For common Linux desktop/server with GLIBC ≥ 2.28
Musl Linux	64-bit (ddns-musl-linux_amd64) 32-bit (ddns-musl-linux_386) ARM64 (ddns-musl-linux_arm64) ARM/V7 (ddns-musl-linux_arm_v7) ARM/V6 (ddns-musl-linux_arm_v6)	适用于OpenWRT及嵌入式系统（musl ≥ 1.1.24），如OpenWRT 19+；ARMv6未测试。 🛠️ For OpenWRT and embedded systems with musl ≥ 1.1.24. ARMv6 not tested.
macOS	ARM/M-chip (ddns-mac-arm64) Intel x86_64 (ddns-mac-x64)	仅虚拟环境测试，未在真机测试 🍎 Tested in virtual environments only
PIP	ddns (全平台)	可通过 pip/pip2/pip3/easy_install 安装，部分环境自动添加至 PATH。 📦 Installable via pip and easy_install. May auto-register in PATH
Pipx	pipx run ddns (全平台)	🚀 直接运行无需安装，独立虚拟环境避免冲突。 🚀 Run directly without installation, isolated virtual environment.
Python	源码 Source code (全平台) zip + tar	可在 Python 2.7 或 Python 3 上直接运行，无需依赖 🐍 Directly runnable with Python 2.7 or Python 3. No extra dependencies.

---

Docker (推荐 Recommended)

# 当前版本 (Current version)
docker run --name ddns -v $(pwd)/:/ddns/ newfuture/ddns:v4.1.1-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.1-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.1-beta1

• wget 安装

  wget -O- https://ddns.newfuture.cc/install.sh | sh -s -- v4.1.1-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.1-beta1/ddns-glibc-linux_amd64 -#SLo ddns && chmod +x ddns

# OpenWRT/嵌入式 (musl arm64)
curl https://github.com/NewFuture/DDNS/releases/download/v4.1.1-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.1-beta1/ddns-mac-arm64 -#SLo ddns && chmod +x ddns

# Intel x86_64
curl https://github.com/NewFuture/DDNS/releases/download/v4.1.1-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.1b1

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

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

v4.1.0

What's Changed

• refact(provider): 重构和统一Provider by @NewFuture in #484
• Fix(cache): loading bug and improve cache status logging by @Copilot in #495
• Refactor(base): HMAC-SHA256 signature logic by @NewFuture in #496
• [feature] Add SSL certificate validation configuration support by @Copilot in #499
• fix(cache): Implement per-record caching to fix partial failure issue by @Copilot in #500
• feat(config:line): 支持自定义线路参数 by @Copilot in #501
• Refact(tests): improve base ,test, and instructions by @NewFuture in #503
• Add No-IP (noip.com) Dynamic DNS Provider Support by @Copilot in #505
• feat(AliESA) 阿里云边缘安全加速 DNS provider support by @Copilot in #498
• feat: current time as remark for aliesa by @eallion in #509
• Refact(config): 统一配置和文档 by @NewFuture in #506
• Convert cache storage from pickle to JSON format by @Copilot in #512
• chore(docker): Update glibc.Dockerfile by @NewFuture in #517
• feat(config): 支持当行注释 Add JSON comment support with # and // styles for configuration files by @Copilot in #515
• feat(provider:NameSilo):添加NameSilo支持(待验证) by @Copilot in #514
• fix(http): fix and refactor http by @NewFuture in #520
• doc(providers): all providers doc by @NewFuture in #522
• feat(provider:edgeone): 支持腾讯EdgeOne Add Tencent Cloud EdgeOne DNS provider support by @Copilot in #521
• filter out: bz2,csv by @NewFuture in #525
• enhance(noip): Remove base64 dependency and use URL-embedded authentication for NoIP provider by @Copilot in #528
• feat(config): support multi config/providers by @NewFuture in #531
• feat(http.retry): Add HTTP auto-retry with exponential backoff by @Copilot in #536
• refactor(http.proxy): add "SYSTEM" and fix "DIRECT" proxy, implement proxy list support with automatic fallback by @Copilot in #537
• feat(config): 支持远程配置文件 add remote HTTP(S) config loading support by @Copilot in #539
• fix(cli): new config default path by @NewFuture in #542
• feat(cli): add task subcommand for automated scheduled task management by @Copilot in #541
• feat: replace flake8 and black with ruff for unified linting and formatting by @Copilot in #544
• feat(install): add POSIX-compatible one-click installation script with multilingual support and comprehensive testing by @Copilot in #546
• feat(scheduler): enhance Windows task scheduling and command executio… by @NewFuture in #547
• feat(ip): implement automatic failover for public IP detection APIs with unified interface by @Copilot in #549
• fix(scheduler ): scheduler path and check by @NewFuture in #550

New Contributors

• @Copilot made their first contribution in #495
• @eallion made their first contribution in #509

Full Changelog: v4.0.2...v4.1.0

DDNS Release Information

各版本一览表 | Download Methods Overview

系统环境 (System)	架构支持 (Architecture)	说明 (Description)
Docker	x64, 386, arm64, armv7, armv6, s390x, ppc64le, riscv64 Github Registry Docker Hub	支持8种架构 docker pull ghcr.io/newfuture/ddns:v4.1.0 🚀 docker pull newfuture/ddns:v4.1.0
Windows	x64: x64.zip · x64.exe x86: x86.zip · x86.exe arm64: arm64.zip · arm64.exe	在最新 Windows 10 和 Windows 11 测试。 ✅ Tested on Windows 10 and Windows 11
GNU Linux	64-bit (ddns-glibc-linux_amd64) 32-bit (ddns-glibc-linux_386) ARM64 (ddns-glibc-linux_arm64) ARM/V7 (ddns-glibc-linux_arm_v7)	常规Linux桌面或服务器，需GLIBC≥2.28。 （如 Debian 9+、Ubuntu 20.04+、CentOS 8+） 🐧 For common Linux desktop/server with GLIBC ≥ 2.28
Musl Linux	64-bit (ddns-musl-linux_amd64) 32-bit (ddns-musl-linux_386) ARM64 (ddns-musl-linux_arm64) ARM/V7 (ddns-musl-linux_arm_v7) ARM/V6 (ddns-musl-linux_arm_v6)	适用于OpenWRT及嵌入式系统（musl ≥ 1.1.24），如OpenWRT 19+；ARMv6未测试。 🛠️ For OpenWRT and embedded systems with musl ≥ 1.1.24. ARMv6 not tested.
macOS	ARM/M-chip (ddns-mac-arm64) Intel x86_64 (ddns-mac-x64)	仅虚拟环境测试，未在真机测试 🍎 Tested in virtual environments only
PIP	ddns (全平台)	可通过 pip/pip2/pip3/easy_install 安装，部分环境自动添加至 PATH。 📦 Installable via pip and easy_install. May auto-register in PATH
Pipx	pipx run ddns (全平台)	🚀 直接运行无需安装，独立虚拟环境避免冲突。 🚀 Run directly without installation, isolated virtual environment.
Python	源码 Source code (全平台) zip + tar	可在 Python 2.7 或 Python 3 上直接运行，无需依赖 🐍 Directly runnable with Python 2.7 or Python 3. No extra dependencies.

---

Docker (推荐 Recommended)

# 当前版本 (Current version)
docker run --name ddns -v $(pwd)/:/ddns/ newfuture/ddns:v4.1.0 -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.0

📁 请将 $(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.0

• wget 安装

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

需要 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](ht...