Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Releases: NewFuture/DDNS

v4.1.1

31 Oct 07:36
91c9a0b

Choose a tag to compare

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

Github ReleaseDocker Image VersionPyPI version

各版本一览表 | 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) Docker Image SizeDocker Platforms

# 当前版本 (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):

一键安装 | 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 cross platform

手动下载各平台文件和使用方式 (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 - Python Version PyPI - Wheel

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

27 Oct 04:05
91c9a0b

Choose a tag to compare

v4.1.1-beta2 Pre-release
Pre-release

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

Github ReleaseDocker Image VersionPyPI version

各版本一览表 | 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) Docker Image SizeDocker Platforms

# 当前版本 (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):

一键安装 | 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 cross platform

手动下载各平台文件和使用方式 (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 - Python Version PyPI - Wheel

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

22 Oct 01:05
f74438c

Choose a tag to compare

v4.1.1-beta1 Pre-release
Pre-release

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

Github ReleaseDocker Image VersionPyPI version

各版本一览表 | 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) Docker Image SizeDocker Platforms

# 当前版本 (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):

一键安装 | 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 cross platform

手动下载各平台文件和使用方式 (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 - Python Version PyPI - Wheel

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

09 Oct 03:24
6f5984c

Choose a tag to compare

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

Github ReleaseDocker Image VersionPyPI version

各版本一览表 | 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) Docker Image SizeDocker Platforms

# 当前版本 (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):

一键安装 | 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 cross platform

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

  • Windows

  1. (推荐) 下载 ZIP: x64.zip · x86.zip · [arm64.zip](ht...
Read more

v4.1.0-beta4

16 Aug 02:39
6f5984c

Choose a tag to compare

v4.1.0-beta4 Pre-release
Pre-release

What's Changed

  • 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

Full Changelog: v4.1.0-beta2...v4.1.0-beta4

DDNS Release Information

Github ReleaseDocker Image VersionPyPI version

各版本一览表 | 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-beta4
🚀 docker pull newfuture/ddns:v4.1.0-beta4
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
Python 源码 Source code (全平台)
zip + tar
可在 Python 2.7 或 Python 3 上直接运行,无需依赖
🐍 Directly runnable with Python 2.7 or Python 3. No extra dependencies.

Docker (推荐 Recommended) Docker Image SizeDocker Platforms

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

📁 请将 $(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):

一键安装 | 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-beta4
  • wget 安装
    wget -O- https://ddns.newfuture.cc/install.sh | sh -s -- v4.1.0-beta4

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

二进制文件 | Executable Binary cross platform

手动下载各平台文件和使用方式 (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.0-beta4/ddns-glibc-linux_amd64 -#SLo ddns && chmod +x ddns

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

# Intel x86_64
curl https://github.com/NewFuture/DDNS/releases/download/v4.1.0-beta4/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 - Python Version PyPI - Wheel

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

...
Read more

v4.1.0-beta2

15 Jul 02:21
5e1a8d5

Choose a tag to compare

v4.1.0-beta2 Pre-release
Pre-release

What's Changed

  • 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

New Contributors

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


Github ReleaseDocker Image VersionPyPI version

各版本一览表 (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-beta2
🚀 docker pull newfuture/ddns:v4.1.0-beta2
Windows 64-bit (ddns-windows-x64.exe)
32-bit (ddns-windows-x86.exe)
ARM (ddns-windows-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=v4.1.0-beta2 (全平台) 可通过 pip/pip2/pip3/easy_install 安装,部分环境自动添加至 PATH。
📦 Installable via pip and easy_install. May auto-register in PATH
Python 源码 Source code (全平台)
zip + tar
可在 Python 2.7 或 Python 3 上直接运行,无需依赖
🐍 Directly runnable with Python 2.7 or Python 3. No extra dependencies.

Docker (推荐 Recommended) Docker Image SizeDocker Platforms

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

二进制文件 (Executable Binary) cross platform

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

  • Windows

  1. 下载 ddns-windows-x64.exeddns-windows-x86.exeddns-windows-arm64.exe 保存为 ddns.exe 并在终端运行.
    (Download the binary, rename it as ddns.exe, then run in cmd or PowerShell.)
  2. [可选] 定时任务: 下载 create-task.bat 于相同目录,以管理员权限运行.
    (Optionally, download and run create-task.bat with administrator privileges to create a scheduled task.)

Linux

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

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

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

# 可选定时任务 (仅支持systemd系统)
# Optional scheduled task (systemd only)
curl -sSL https://github.com/NewFuture/DDNS/releases/download/v4.1.0-beta2/create-task.sh | bash

MacOS

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

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

使用pip安装 (Install via PIP) PyPI - Python Version PyPI - Wheel

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

# 安装当前版本 (Install current version)
pip install ddns==v4.1.0-beta2

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

v4.1.0-beta1

03 Jul 13:15
3d155b6

Choose a tag to compare

v4.1.0-beta1 Pre-release
Pre-release

What's Changed

New Contributors

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


Github ReleaseDocker Image VersionPyPI version

各版本一览表 (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-beta1
🚀 docker pull newfuture/ddns:v4.1.0-beta1
Windows 64-bit (ddns-windows-x64.exe)
32-bit (ddns-windows-x86.exe)
ARM (ddns-windows-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=v4.1.0-beta1 (全平台) 可通过 pip/pip2/pip3/easy_install 安装,部分环境自动添加至 PATH。
📦 Installable via pip and easy_install. May auto-register in PATH
Python 源码 Source code (全平台)
zip + tar
可在 Python 2.7 或 Python 3 上直接运行,无需依赖
🐍 Directly runnable with Python 2.7 or Python 3. No extra dependencies.

Docker (推荐 Recommended) Docker Image SizeDocker Platforms

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

二进制文件 (Executable Binary) cross platform

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

  • Windows

  1. 下载 ddns-windows-x64.exeddns-windows-x86.exeddns-windows-arm64.exe 保存为 ddns.exe 并在终端运行.
    (Download the binary, rename it as ddns.exe, then run in cmd or PowerShell.)
  2. [可选] 定时任务: 下载 create-task.bat 于相同目录,以管理员权限运行.
    (Optionally, download and run create-task.bat with administrator privileges to create a scheduled task.)

Linux

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

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

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

# 可选定时任务 (仅支持systemd系统)
# Optional scheduled task (systemd only)
curl -sSL https://github.com/NewFuture/DDNS/releases/download/v4.1.0-beta1/create-task.sh | bash

MacOS

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

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

使用pip安装 (Install via PIP) PyPI - Python Version PyPI - Wheel

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

# 安装当前版本 (Install current version)
pip install ddns==v4.1.0-beta1

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

v4.0.2

25 Jun 01:07
1d2fffa

Choose a tag to compare

What's Changed

Full Changelog: v4.0.0...v4.0.2


Github ReleaseDocker Image VersionPyPI version

各版本一览表 (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.0.2
🚀 docker pull newfuture/ddns:v4.0.2
Windows 64-bit (ddns-windows-x64.exe)
32-bit (ddns-windows-x86.exe)
ARM (ddns-windows-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=v4.0.2 (全平台) 可通过 pip/pip2/pip3/easy_install 安装,部分环境自动添加至 PATH。
📦 Installable via pip and easy_install. May auto-register in PATH
Python 源码 Source code (全平台)
zip + tar
可在 Python 2.7 或 Python 3 上直接运行,无需依赖
🐍 Directly runnable with Python 2.7 or Python 3. No extra dependencies.

Docker (推荐 Recommended) Docker Image SizeDocker Platforms

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

二进制文件 (Executable Binary) cross platform

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

  • Windows

  1. 下载 ddns-windows-x64.exeddns-windows-x86.exeddns-windows-arm64.exe 保存为 ddns.exe 并在终端运行.
    (Download the binary, rename it as ddns.exe, then run in cmd or PowerShell.)
  2. [可选] 定时任务: 下载 create-task.bat 于相同目录,以管理员权限运行.
    (Optionally, download and run create-task.bat with administrator privileges to create a scheduled task.)

Linux

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

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

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

# 可选定时任务 (仅支持systemd系统)
# Optional scheduled task (systemd only)
curl -sSL https://github.com/NewFuture/DDNS/releases/download/v4.0.2/create-task.sh | bash

MacOS

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

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

使用pip安装 (Install via PIP) PyPI - Python Version PyPI - Wheel

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

# 安装当前版本 (Install current version)
pip install ddns==v4.0.2

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

v4.0.0

20 Jun 15:32
b6215fb

Choose a tag to compare

支持更多架构二进制和docker版本,文件体积,运行兼容性和性能大量优化。
配置和代码重构,配置文件更新到v4.0,和之前稍有变化

What's Changed

Full Changelog: v3.1.5...v4.0.0


Github ReleaseDocker Image VersionPyPI version

各版本一览表 (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.0.0
🚀 docker pull newfuture/ddns:v4.0.0
Windows 64-bit (ddns-windows-x64.exe)
32-bit (ddns-windows-x86.exe)
ARM (ddns-windows-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=v4.0.0 (全平台) 可通过 pip/pip2/pip3/easy_install 安装,部分环境自动添加至 PATH。
📦 Installable via pip and easy_install. May auto-register in PATH
Python 源码 Source code (全平台)
zip + tar
可在 Python 2.7 或 Python 3 上直接运行,无需依赖
🐍 Directly runnable with Python 2.7 or Python 3. No extra dependencies.

Docker (推荐 Recommended) Docker Image SizeDocker Platforms

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

二进制文件 (Executable Binary) cross platform

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

  • Windows

  1. 下载 ddns-windows-x64.exeddns-windows-x86.exeddns-windows-arm64.exe 保存为 ddns.exe 并在终端运行.
    (Download the binary, rename it as ddns.exe, then run in cmd or PowerShell.)
  2. [可选] 定时任务: 下载 create-task.bat 于相同目录,以管理员权限运行.
    (Optionally, download and run create-task.bat with administrator privileges to create a scheduled task.)

Linux

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

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

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

# 可选定时任务 (仅支持systemd系统)
# Optional scheduled task (systemd only)
curl -sSL https://github.com/NewFuture/DDNS/releases/download/v4.0.0/create-task.sh | bash

MacOS

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

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

使用pip安装 (Install via PIP) PyPI - Python Version PyPI - Wheel

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

# 安装当前版本 (Install current version)
pip install ddns==v4.0.0

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

v4.0.0-beta8

19 Jun 10:34
a1395ac

Choose a tag to compare

v4.0.0-beta8 Pre-release
Pre-release

What's Changed

Full Changelog: v4.0.0-beta7...v4.0.0-beta8


Github ReleaseDocker Image VersionPyPI version

各版本一览表 (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:${BUILD_VERSION}
🚀 docker pull newfuture/ddns:${BUILD_VERSION}
Windows 64-bit (ddns-windows-x64.exe)
32-bit (ddns-windows-x86.exe)
ARM (ddns-windows-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=v4.0.0-beta8 (全平台) 可通过 pip/pip2/pip3/easy_install 安装,部分环境自动添加至 PATH。
📦 Installable via pip and easy_install. May auto-register in PATH
Python 源码 Source code (全平台)
zip + tar
可在 Python 2.7 或 Python 3 上直接运行,无需依赖
🐍 Directly runnable with Python 2.7 or Python 3. No extra dependencies.

Docker (推荐 Recommended) Docker Image SizeDocker Platforms

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

📁 请将 $(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):

二进制文件 (Executable Binary) cross platform

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

  • Windows

  1. 下载 ddns-windows-x64.exeddns-windows-x86.exeddns-windows-arm64.exe 保存为 ddns.exe 并在终端运行.
    (Download the binary, rename it as ddns.exe, then run in cmd or PowerShell.)
  2. [可选] 定时任务: 下载 create-task.bat 于相同目录,以管理员权限运行.
    (Optionally, download and run create-task.bat with administrator privileges to create a scheduled task.)

Linux

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

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

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

# 可选定时任务 (仅支持systemd系统)
# Optional scheduled task (systemd only)
curl -sSL https://github.com/NewFuture/DDNS/releases/download/v4.0.0-beta8/create-task.sh | bash

MacOS

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

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

使用pip安装 (Install via PIP) PyPI - Python Version PyPI - Wheel

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

# 安装当前版本 (Install current version)
pip install ddns==v4.0.0-beta8

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