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-hfor help) - config.json 支持编辑器自动补全 (config.json supports autocompletion)
- 支持
DDNS_XXX环境变量 (SupportsDDNS_XXXenvironment 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
-
(推荐) 下载 ZIP:
x64.zip·x86.zip·arm64.zip解压并运行ddns.exe。
(Recommended) Download the ZIP for your arch, extract, then runddns.exe. -
直接下载 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. -
[可选] 定时任务: 使用内置命令
ddns task --install创建定时任务。
(Optionally) Use the built-in commandddns task --installto 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