DDNS/.github/release.md

---

各版本一览表 (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=${BUILD_VERSION} (全平台)	可通过 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)

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

📁 请将 $(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/${BUILD_VERSION}/ddns-glibc-linux_amd64 -#SLo ddns && chmod +x ddns

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

MacOS

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

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

使用pip安装 (Install via PIP)

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

# 安装当前版本 (Install current version)
pip install ddns==${BUILD_VERSION}

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