Skip to content

One-Click Installation Script

DDNS one-click installation script with support for automatic download and installation on Linux and macOS systems.

Quick Installation

bash
# Install latest stable version online
curl -#fSL https://ddns.newfuture.cc/install.sh | sh

# Use sudo if root permission is needed for system directory
curl -#fSL https://ddns.newfuture.cc/install.sh | sudo sh

# Or using wget
wget -qO- https://ddns.newfuture.cc/install.sh | sh

Note: Default installation to /usr/local/bin. If the directory requires administrator privileges, the script will automatically prompt to use sudo, or you can run with sudo in advance.

Version Selection

bash
# Install latest stable version
curl -#fSL https://ddns.newfuture.cc/install.sh | sh -s -- latest

# Install latest beta version
curl -#fSL https://ddns.newfuture.cc/install.sh | sh -s -- beta

# Install specific version
curl -#fSL https://ddns.newfuture.cc/install.sh | sh -s -- v4.0.2

Command Line Options

OptionDescription
latestInstall latest stable version (default)
betaInstall latest beta version
v4.0.2Install specific version
--install-dir PATHSpecify installation directory (default: /usr/local/bin)
--proxy URLSpecify proxy domain/prefix (e.g., https://hub.gitmirror.com/), overrides auto-detection
--forceForce reinstallation
--uninstallUninstall installed ddns
--helpShow help information

Advanced Usage

bash
# Custom installation directory
curl -#fSL https://ddns.newfuture.cc/install.sh | sh -s -- beta --install-dir ~/.local/bin

# Force reinstallation
curl -#fSL https://ddns.newfuture.cc/install.sh | sh -s -- --force

# Uninstall
curl -#fSL https://ddns.newfuture.cc/install.sh | sh -s -- --uninstall

# Specify proxy domain (override auto-detection)
curl -#fSL https://ddns.newfuture.cc/install.sh | sh -s -- --proxy https://hub.gitmirror.com/

System Support

Operating Systems: Linux (glibc/musl), macOS
Architectures: x86_64, ARM64, ARM v7, ARM v6, i386
Dependencies: curl or wget

Auto-Detection Features

  • System Detection: Automatically identifies operating system, architecture and libc type
  • Tool Detection: Automatically selects curl or wget download tool
  • Network Optimization: Automatically tests and selects the best download mirror (github.com → China mirror sites)
  • Manual Override: Use --proxy to specify a proxy domain/mirror prefix, which takes precedence over auto-detection

Verify Installation

bash
ddns --version    # Check version
which ddns        # Check installation location

Update & Uninstall

bash
# Update to latest version
curl -#fSL https://ddns.newfuture.cc/install.sh | sh -s -- latest

# Uninstall
curl -#fSL https://ddns.newfuture.cc/install.sh | sh -s -- --uninstall

# Manual uninstall
sudo rm -f /usr/local/bin/ddns

Troubleshooting

Permission Issues: Use sudo or install to user directory
Network Issues: Script automatically uses mirror sites (hub.gitmirror.com, proxy.gitwarp.com, etc.)
Unsupported Architecture: Check releases page for supported architectures
Proxy Environment: The script respects system proxy settings (HTTP_PROXY/HTTPS_PROXY); you can also use --proxy https://hub.gitmirror.com/ to specify a GitHub mirror prefix (overrides auto-detection)

Released under the MIT License