qdm12/ddns-updater
Ddns Updater
This project is a containerized dynamic DNS update client designed to automate the synchronization of domain records with changing public IP addresses. It functions as a multi-provider synchronization engine that monitors network connectivity and updates DNS records across various cloud platforms and custom services to ensure consistent domain resolution.
The system distinguishes itself through a provider-based adapter pattern that abstracts diverse third-party APIs into a unified interface, allowing for consistent record management. It employs multi-source IP discovery to mitigate rate limits and service outages, while its polling-based reconciliation logic ensures that updates are only triggered when a drift between the current public IP and remote DNS records is detected.
The software includes a responsive web-based management dashboard for monitoring system health, viewing update status, and adjusting configurations. It also features an event-driven notification pipeline for system alerts and automated conflict resolution to handle root and wildcard domain records. The application maintains local state persistence and historical logs to support reliable synchronization and data recovery.
The service is designed for deployment as a containerized utility within environments like Kubernetes, supporting ingress exposure for remote access to its management interface.
Features
- Dynamic DNS Clients - Automates the synchronization of domain name records with changing public IP addresses across multiple providers.
- Dynamic DNS Synchronization - Updates domain records with current dynamic IP addresses by authenticating with various providers.
- Polling-Based Synchronization Controllers - Periodically polls external systems and reconciles DNS records only when a drift between the current IP and remote records is detected.
- IP Address Discovery Tools - Automatically identifies the current public IP address by querying multiple independent network services.
- Public IP Detectors - Identifies current IPv4 and IPv6 addresses by querying multiple network providers to ensure reliable connectivity data.
- Local State Databases - Maintains a local database of historical IP addresses and timestamps to support reliable synchronization logic.
- Management Dashboards - Provides a responsive graphical interface for monitoring and controlling the containerized application.
- Cloud Provider Integrations - Automates synchronization for major cloud platforms by authenticating against cloud service accounts.
- Network Utilities - Provides a self-hosted utility for managing network configurations and automated service updates within isolated container environments.
- Cloud DNS Services - Manages and updates DNS records programmatically within cloud environments for dynamic workloads.
- Ingress Controllers - Configures network routes to expose the management interface externally while managing security certificates.
- Web-Based Configuration Dashboards - Provides a responsive browser-based dashboard for monitoring system health and adjusting dynamic DNS settings.
- DNS Provider Interfaces - Standardizes diverse third-party DNS vendor APIs into a unified interface for consistent record management.
- Event-Driven Notification Triggers - Dispatches alerts and status updates to external messaging platforms in response to real-time system events.
- DNS Management Interfaces - Provides a web-based graphical interface for monitoring DNS record status and configuring update settings.
- Home Network Service Hosting - Ensures consistent remote access to self-hosted services by keeping domain names pointed at dynamic home network connections.
- Network Connectivity Monitoring - Tracks public IP address changes and verifies DNS record health to ensure continuous availability of internet-facing services.
- Custom Webhook Integrations - Enables dynamic DNS updates for unsupported providers by sending HTTP GET requests to custom webhook endpoints.
Star history
How this analysis was created: This summary and feature list are AI-generated from collected project material and can contain mistakes. Stars, license and language are imported from GitHub. Inclusion does not mean that we have tested or audited this project. Check the source documentation for any feature you depend on. Learn more on our About page.
