timothymiller/cloudflare-ddns
Cloudflare Ddns
这是一个基于 Rust 的网络实用程序和动态 DNS 客户端，旨在监控公共 IP 地址并自动更新 Cloudflare DNS 记录和 Web 应用防火墙（WAF）访问列表。它结合使用 HTTP API 和 DNS-over-HTTPS 提供程序来识别当前的 IPv4 和 IPv6 地址。
该工具通过管理域名记录和 WAF IP 列表来保持对互联网连接不断变化的主机的安全访问。它包括一个 DNS 更改预览模式，可在不修改实时记录的情况下模拟更新，并利用任播（anycast）范围过滤来防止提供商地址空间导致的不正确记录更新。
该系统通过 Cron 表达式或固定间隔处理调度，并实现抖动 API 请求计时以避免速率限制。它涵盖了广泛的能力领域，包括双栈网络支持、基于环境的身份验证令牌秘密注入、外部状态通知以及基于心跳的健康监控。
Features
- DNS Record Updaters - Automatically synchronizes current public IP addresses with Cloudflare DNS records.
- Public IP Detectors - Identifies current public IPv4 and IPv6 addresses using HTTP APIs and DNS-over-HTTPS providers.
- Dual-Stack Record Management - Processes and updates both IPv4 and IPv6 records simultaneously to maintain connectivity across different network stacks.
- Dynamic DNS Mappings - Automatically refreshes DNS records when the public IP changes to ensure constant host connectivity.
- Dynamic DNS Clients - A dedicated client for monitoring public IPs and automatically updating Cloudflare DNS and WAF lists.
- IP Address Discovery Tools - Determines the current public IPv4 and IPv6 addresses by querying remote HTTP and DoH providers.
- Anycast Range Filters - Filters out anycast and private IP addresses to ensure only valid public IPs are used for DNS updates.
- WAF IP List Synchronization - Maintains secure access for dynamic clients by updating IP addresses in Cloudflare WAF lists.
- DNS Record Automation - Updates Cloudflare DNS records to map custom domains and wildcards to a changing public IP.
- IP Allow/Deny Lists - Automatically updates Cloudflare WAF IP allow lists to maintain secure access for hosts with dynamic addresses.
- WAF IP List Management - Keeps Web Application Firewall access lists current by updating them with the latest host IP.
- Cron Scheduling - Uses cron expressions to trigger periodic updates of DNS records and WAF lists.
- DoH IP Detection - Identifies current public IPv4 and IPv6 addresses using secure DNS-over-HTTPS providers.
- Time-Interval Update Schedulers - Schedules update checks using cron expressions or fixed intervals with added jitter to avoid API rate limits.
- DNS Update Scheduling - Schedules recurring background checks and updates specifically for DNS records.
- Self-Hosted Service Access Automation - Automates network reachability for home servers or remote hosts using dynamic DNS.
