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

各版本一览表 | Download Methods Overview

Docker (推荐 Recommended)

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

• 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-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

手动下载各平台文件和使用方式 (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 安装当前版本或者更新最新版本

...

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

• @eallion made their first contribution in #509

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

各版本一览表 (Download Methods Overview)

Docker (推荐 Recommended)

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

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

二进制文件 (Executable Binary)

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

• Windows

1. 下载 ddns-windows-x64.exe 或 ddns-windows-x86.exe 或 ddns-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 安装当前版本或者更新最新版本

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

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

What's Changed

• refact(provider): 重构和统一Provider by @NewFuture in #484
  • 支持debug 和 tencentcloud
• Fix(cache): loading bug and improve cache status logging by @copilot-swe-agent in #495
• Refactor(base): HMAC-SHA256 signature logic by @NewFuture in #496
• [feature] Add SSL certificate validation configuration support by @copilot-swe-agent in #499
• fix(cache): Implement per-record caching to fix partial failure issue by @copilot-swe-agent in #500
• feat(config:line): 支持自定义线路参数 by @copilot-swe-agent in #501
• Refact(tests): improve base ,test, and instructions by @NewFuture in #503

New Contributors

• @copilot-swe-agent made their first contribution in #495

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

各版本一览表 (Download Methods Overview)

Docker (推荐 Recommended)

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

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

二进制文件 (Executable Binary)

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

• Windows

1. 下载 ddns-windows-x64.exe 或 ddns-windows-x86.exe 或 ddns-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 安装当前版本或者更新最新版本

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

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

What's Changed

• fix(docker): compatibility of old default config path by @NewFuture in #487
• feat(log): add funcName in log by @NewFuture in #488
• fix(log): set default log level by @NewFuture in #491

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

各版本一览表 (Download Methods Overview)

Docker (推荐 Recommended)

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

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

二进制文件 (Executable Binary)

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

• Windows

1. 下载 ddns-windows-x64.exe 或 ddns-windows-x86.exe 或 ddns-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 安装当前版本或者更新最新版本

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

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

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

What's Changed

• using Nuitka for binary build by @NewFuture in #456
• docker build multi-arch by @NewFuture in #457
• PR 检查docker 架构 并上传docker构建 bin by @NewFuture in #458
• 优化docker镜像 by @NewFuture in #459
• Reintroduce Python 2 Compatibility in setup.py (#460) by @NewFuture in #462
• update icons by @NewFuture in #461
• build Linux version in centos docker by @NewFuture in #464
• 重构日志配置，移除调试模式，添加日志级别和输出文件选项；更新配置文件模式至v4.0 by @NewFuture in #465
• Update release actions and documentation and config by @NewFuture in #466
• 优化ico by @NewFuture in #467
• feat(config): Optimize configuration file loading logic by @NewFuture in #468
• install deps from apk by @NewFuture in #469
• build(docker): 优化build检查和push tag by @NewFuture in #470
• build(docker): lock alpine main version to 3.21 by @NewFuture in #471
• buid(bin):binary for musl by @NewFuture in #472
• build(bin): 统一Linux build python 版本，添加Glibc 支持 by @NewFuture in #473
• fix(encoding): python2 encoding 兼容 by @NewFuture in #474
• feat(config): 支持环境变量传递数组参数 Support array in environment variables and improve logic by @NewFuture in #476
• build(docker): improve prebuild container size by @NewFuture in #477
• chore(ci): 重构pipeline using prebuilt docker by @NewFuture in #478
• feat(log+doc): 增加log配置，完善文档 by @NewFuture in #480
• Refactor structure by @NewFuture in #481
• fix(config): logger and array by @NewFuture in #485

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

各版本一览表 (Download Methods Overview)

Docker (推荐 Recommended)

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

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

二进制文件 (Executable Binary)

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

• Windows

1. 下载 ddns-windows-x64.exe 或 ddns-windows-x86.exe 或 ddns-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 安装当前版本或者更新最新版本

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

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

What's Changed

• Refactor structure by @NewFuture in #481
• fix(pypi): py2 by @NewFuture in #483 #482

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

各版本一览表 (Download Methods Overview)

Docker (推荐 Recommended)

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

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

二进制文件 (Executable Binary)

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

• Windows

1. 下载 ddns-windows-x64.exe 或 ddns-windows-x86.exe 或 ddns-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 安装当前版本或者更新最新版本

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

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

What's Changed

• build(docker): improve prebuild container size by @NewFuture in #477
• chore(ci): 重构pipeline using prebuilt docker by @NewFuture in #478
• feat(log+doc): 增加log配置，完善文档 by @NewFuture in #480

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

各版本一览表 (Download Methods Overview)

Docker (推荐 Recommended)

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

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

二进制文件 (Executable Binary)

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

• Windows

1. 下载 ddns-windows-x64.exe 或 ddns-windows-x86.exe 或 ddns-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-beta7/ddns-glibc-linux_amd64 -#SLo ddns && chmod +x ddns

# OpenWRT/嵌入式 (musl arm64)
curl https://github.com/NewFuture/DDNS/releases/download/v4.0.0-beta7/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-beta7/create-task.sh | bash

MacOS

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

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

使用pip安装 (Install via PIP)

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

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

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

What's Changed

• fix(encoding): python2 encoding 兼容 by @NewFuture in #474
• feat(config): 支持环境变量传递数组参数 Support array in environment variables and improve logic by @NewFuture in #476

Full Changelog: v4.0.0-beta4...v4.0.0-beta5

各版本一览表 (Download Methods Overview)

Docker (推荐 Recommended)

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

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

二进制文件 (Executable Binary)

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

• Windows

1. 下载 ddns-windows-x64.exe 或 ddns-windows-x86.exe 或 ddns-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-beta5/ddns-glibc-linux_amd64 -#SLo ddns && chmod +x ddns

# OpenWRT/嵌入式 (musl arm64)
curl https://github.com/NewFuture/DDNS/releases/download/v4.0.0-beta5/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-beta5/create-task.sh | bash

MacOS

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

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

使用pip安装 (Install via PIP)

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

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

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

What's Changed

优化docker，和二进制发布

• buid(bin):binary for musl by @NewFuture in #472
• build(bin): 统一Linux build python 版本，添加Glibc 支持 by @NewFuture in #473
• fix 非utf8的编码问题

Full Changelog: v4.0.0-beta3...v4.0.0-beta4

各版本一览表 (Download Methods Overview)

Docker (推荐 Recommended)

# 当前版本 (Current version)
docker --name ddns -v $(pwd)/:/DDNS newfuture/ddns:v4.0.0-beta4 -h
# 最新版本 (Latest version, may use cache)
docker --name ddns -v $(pwd)/:/DDNS newfuture/ddns -h

请将 $(pwd)/ 替换为你的配置文件夹。(Replace $(pwd)/ with your configuration folder.)

• 使用 -h 查看命令行帮助 (Use -h for command-line help)
• 配置文件config.json支持编辑器自动提示 (config.json supports auto-completion in editors)
• 支持环境变量DDNS_XXX (Supports environment variables DDNS_XXX)

支持源 (Supported registries):

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

二进制文件 (Executable Binary)

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

• Windows

1. 下载 (Download) ddns-windows-x64.exe 或 (or) ddns-windows-x86.exe 或 (or) ddns-windows-arm64.exe 保存为 (save as) ddns.exe 并运行 (and run)
2. [可选 Optional] 定时任务 (Scheduled task): 下载 (Download) create-task.bat 于相同目录 (in same directory)，以管理员权限运行 (run as administrator)

Linux

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

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

# 其他版本请自行替换链接 (Replace URL for other versions)

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

MacOS

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

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

使用pip安装 (Install via PIP)

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

• 安装当前版本[current version]: pip install ddns=v4.0.0-beta4
• 更新最新版[update latest version]: pip install -U ddns

What's Changed

• feat(config): Optimize configuration file loading logic by @NewFuture in #468

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

版本下载方式一览表

Docker (推荐)

# 当前版本
docker --name ddns -v $(pwd)/:/DDNS newfuture/ddns:v4.0.0-beta3 -h
# 最新版本(可能有缓存)
docker --name ddns -v $(pwd)/:/DDNS newfuture/ddns -h

请将 $(pwd)/ 替换为你的配置文件夹。

• 命令行参数使用 -h
• 配置文件config.json，使用vscode等编辑会有自动提示
• 环境变量DDNS_XXX

支持源:

• Docker官方源: docker.io/newfuture/ddns
• Github镜像源: ghcr.io/newfuture/ddns

使用二进制文件

各平台下载/使用方式

• Windows

1. 下载 ddns-windows-x64.exe 或者 ddns-windows-x86.exe 或者ddns-windows-arm64.exe 保存为ddns.exe 运行
2. [可选] 定时任务 下载 create-task.bat 于相同目录，以管理员权限运行

• Linux 系统

# 1. 下载ddns 
# x64 版本
curl https://github.com/NewFuture/DDNS/releases/download/v4.0.0-beta3/ddns-linux-x64 -#SLo ddns && chmod +x ddns

# arm64 版本
curl https://github.com/NewFuture/DDNS/releases/download/v4.0.0-beta3/ddns-linux-arm64 -#SLo ddns && chmod +x ddns

# 2. [可选] 定时任务(当前目录): 
curl -sSL https://github.com/NewFuture/DDNS/releases/download/v4.0.0-beta3/create-task.sh | bash

• Mac OSX

# 命令行下载
# arm64
curl https://github.com/NewFuture/DDNS/releases/download/v4.0.0-beta3/ddns-mac-arm64 -#SLo ddns && chmod +x ddns

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

使用PIP 安装

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

• 安装当前版本[current version]: pip install ddns=v4.0.0-beta3
• 更新最新版[update latest version]: pip install -U ddns