DDNS/docs/install.md

一键安装脚本

DDNS 一键安装脚本，支持 Linux 和 macOS 系统自动下载安装。

快速安装

# 在线安装最新稳定版
curl -fsSL https://ddns.newfuture.cc/install.sh | sh
# 如需 root 权限安装到系统目录，使用 sudo
curl -fsSL https://ddns.newfuture.cc/install.sh | sudo sh

# 或使用 wget
wget -qO- https://ddns.newfuture.cc/install.sh | sh

说明： 默认安装到 /usr/local/bin，如果该目录需要管理员权限，脚本会自动提示使用 sudo，或者可以预先使用 sudo 运行。

版本选择

# 安装最新稳定版
curl -fsSL https://ddns.newfuture.cc/install.sh | sh -s -- latest

# 安装最新测试版
curl -fsSL https://ddns.newfuture.cc/install.sh | sh -s -- beta

# 安装指定版本
curl -fsSL https://ddns.newfuture.cc/install.sh | sh -s -- v4.0.2

命令行选项

选项	说明
latest	安装最新稳定版（默认）
beta	安装最新测试版
v4.0.2	安装指定版本
--install-dir PATH	指定安装目录（默认：/usr/local/bin）
--proxy URL	指定代理域名前缀（例如：https://hub.gitmirror.com/），覆盖自动探测
--force	强制重新安装
--uninstall	卸载已安装的 ddns
--help	显示帮助信息

高级用法

# 自定义安装目录
curl -fsSL https://ddns.newfuture.cc/install.sh | sh -s -- beta --install-dir ~/.local/bin

# 强制重新安装
curl -fsSL https://ddns.newfuture.cc/install.sh | sh -s -- --force

# 卸载
curl -fsSL https://ddns.newfuture.cc/install.sh | sh -s -- --uninstall

# 指定代理域名（覆盖自动探测）
curl -fsSL https://ddns.newfuture.cc/install.sh | sh -s -- --proxy https://hub.gitmirror.com/

系统支持

操作系统： Linux（glibc/musl）、macOS
架构： x86_64、ARM64、ARM v7、ARM v6、i386
依赖： curl 或 wget

自动检测功能

• 系统检测： 自动识别操作系统、架构和 libc 类型
• 工具检测： 自动选择 curl 或 wget 下载工具
• 网络优化： 自动测试并选择最佳下载镜像（github.com → 国内镜像站）
• 手动覆盖： 通过 --proxy 指定代理域名/镜像前缀，优先于自动探测

验证安装

ddns --version    # 检查版本
which ddns        # 检查安装位置

更新与卸载

# 更新到最新版本
curl -fsSL https://ddns.newfuture.cc/install.sh | sh -s -- latest

# 卸载
curl -fsSL https://ddns.newfuture.cc/install.sh | sh -s -- --uninstall

# 手动卸载
sudo rm -f /usr/local/bin/ddns

故障排除

权限问题： 使用 sudo 或安装到用户目录
网络问题： 脚本自动使用镜像站点（hub.gitmirror.com、proxy.gitwarp.com 等）
架构不支持： 查看 releases 页面 确认支持的架构 代理环境: 脚本会尊重系统代理设置（HTTP_PROXY/HTTPS_PROXY）；也可以使用 --proxy https://hub.gitmirror.com/ 指定 GitHub 镜像前缀（覆盖自动探测）