NewFuture/DDNS
DDNS
This project is a multi-provider dynamic DNS client and synchronizer that monitors local IPv4 and IPv6 addresses and automatically updates DNS records across various cloud providers. It functions as an IP address monitoring tool and a network IP update webhook, ensuring that domain names remain pointed to current network addresses.
The system distinguishes itself through a wide range of native provider integrations, including Cloudflare, AliDNS, DNSPod, Huawei Cloud, and HE.net. Beyond simple record updates, it allows for the management of CDN proxy status, TTL durations, and regional routing lines, while supporting custom HTTP webhooks to trigger external notifications whenever an IP change is detected.
The capability surface includes public IP discovery via API queries and shell commands, local state caching to prevent redundant API calls, and automated scheduling through cron expressions or system-native task managers. It also provides flexible configuration through environment variables, JSON files, and remote HTTP URLs.
Features
- Dynamic DNS Mappings - Automatically updates DNS records to map hostnames to a changing public IPv4 or IPv6 address.
- Dynamic DNS Clients - Provides a service for automatically updating domain name records with changing local IP addresses.
- Dynamic DNS Synchronization - Provides automated updates of DNS records to maintain remote access when host IP addresses change.
- Automated DNS Record Synchronization - Implements automated synchronization of multiple or nested domain records with the current local network addresses.
- Cron Job Automation - Uses cron-style scheduling to automate periodic checks of local IP addresses and subsequent DNS updates.
- Automated DNS Managers - Automates the management of DNS records, including TTL values, routing lines, and CDN proxy status.
- DNS Management Clients - Acts as a client to interact with cloud DNS provider APIs for synchronizing domain records.
- DNS Record Updaters - Synchronizes DNS records with external providers via custom HTTP API endpoints using GET or POST methods.
- IP Address Discovery Tools - Detects public IP changes using discovery APIs to trigger updates to external DNS records.
- IPv6 Address Support - Detects and updates DNS records using IPv6 addresses to maintain connectivity in dual-stack environments.
- DNS Record Address Selection - Detects and selects the current IPv6 address to synchronize into DNS records for dual-stack environments.
- Public IP Detectors - Identifies the current public network address of the host machine using various detection methods.
- IP Change Alerts - Monitors for local IP address changes and triggers automatic record updates via system schedulers.
- DNS Update Scheduling - Schedules recurring background checks to ensure DNS records always point to the current local IP.
- System Task Scheduling - Integrates with system-native schedulers like cron to run background DNS synchronization tasks.
- CDN Proxy Control - Controls the CDN proxy status of DNS entries to enable or disable security and acceleration protection.
- Automatic Record Generation - Automatically generates new DNS entries when they do not exist for a specified hostname.
- Network Webhooks - Implements mechanisms for triggering external events via webhooks based on network state changes.
- Data Change Callbacks - Triggers external callbacks to notify other systems when local network IP addresses change.
- CDN Origin IP Management - Provides the ability to update the source IP address of acceleration domains to ensure correct routing.
- Record Attribute Configuration - Allows users to set TTL durations and target resolution lines for DNS records.
- No-IP Integrations - Updates dynamic DNS records using Basic Authentication or DDNS keys to maintain hostname mapping.
- Network Change Webhooks - Triggers custom HTTP webhooks or external APIs whenever a local IP address change is detected and updated.
- DNS-Based Routing - Implements regional traffic steering by configuring specific route lines and TTL values for DNS records.
- AliDNS Integrations - Synchronizes local IPv4 and IPv6 addresses with AliDNS records using API authentication and custom TTLs.
- Cloudflare Integrations - Synchronizes local IPv4 and IPv6 addresses with Cloudflare DNS records using API tokens.
- DNSPod Integrations - Synchronizes local IPv4 and IPv6 addresses with DNSPod international records using API tokens.
- ESA DNS Integrations - Synchronizes local IPv4 and IPv6 addresses with edge security acceleration records using provider credentials.
- HE.net Integrations - Synchronizes local IPv4 and IPv6 addresses with HE.net DNS records using a dedicated dynamic DNS password.
- Huawei Cloud Integrations - Synchronizes local IP addresses to Huawei Cloud DNS records using API authentication with access keys.
- NameSilo Integrations - Updates dynamic DNS records for IPv4 and IPv6 addresses using NameSilo API key authentication.
- TencentCloud Integrations - Updates IPv4 and IPv6 DNS records on TencentCloud DNSPod using API credentials.
- DNS Provider Interfaces - Provides a standard interface for implementing and integrating new DNS service providers.
- 51DNS Integrations - Synchronizes dynamic DNS records specifically for the 51DNS provider using API authentication.
- HTTP Callbacks - Sends automatic HTTP POST requests to custom endpoints upon detection of an IP address change.
- Self-Hosted Service Access Automation - Maintains reliable access to home-hosted services by automating the link between a static domain and a dynamic IP.
- Custom Webhook Integrations - Implements custom HTTP API and webhook integrations to send IP updates when standard providers are unavailable.
Star history
How this analysis was created: This summary and feature list were written by an AI model that read the project's README and public documentation pages. Each feature links to the documentation it came from; stars, license and language come straight from the GitHub API. The model does not read the source code, and the analysis is refreshed when the project is re-analysed. Learn more on our About page.
