#cloudflare #ddns #dns-records #update #tiny #applet #domain

app cloudflare-ddns-updater

tiny applet to update Cloudflare DNS A records for your domain

2 stable releases

1.1.0 Feb 21, 2025
1.0.0 Dec 21, 2024

#667 in Network programming

Download history 121/week @ 2024-12-18 1/week @ 2024-12-25 3/week @ 2025-01-08 3/week @ 2025-02-05 9/week @ 2025-02-12 135/week @ 2025-02-19 28/week @ 2025-02-26

175 downloads per month

MIT license

12KB
204 lines

Cloudflare DDNS updater

Tiny applet to update Cloudflare DNS A records for your domain.

It is recommended to use a service to restart the program on a regular interval, for example systemd on Linux or Task Scheduler on Windows.


Config

The configuration is stored using the .toml format in the OS-specific config directory.

Location

OS Path
Linux $HOME/.config/cloudflare-ddns-updater/config.toml
Windows %APPDATA%/cloudflare-ddns-updater/config.toml

Entries

Key Type Required Description Default
auth_key String yes Cloudflare authentication key
My Profile > API Tokens > Create Token > Edit zone DNS (template)
none
auth_email String yes Cloudflare account Email none
zone_id String yes Cloudflare zone ID
Websites > (Your website) > Overview > API (bottom right) > Zone ID
none
ip_src Vec<String> no List of URLs for fetching the external IPv4 ["https://ipv4.icanhazip.com/",
"https://api.ipify.org"]
http_timeout_s u64 no Timeout for all HTTP requests in seconds 10

Dependencies

~7–16MB
~211K SLoC