1 stable release
| new 1.0.0 | Dec 21, 2024 |
|---|
#9 in #ddns
14KB
204 lines
Cloudflare DDNS updater
This is a very simple application that updates the Cloudflare DNS A records of your domain with your current global IPv4 address.
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/config.toml |
| Windows | %APPDATA%/cloudflare-ddns/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
~14–22MB
~428K SLoC