Cloudflare DNS Updater written in Rust. Works for IPv4 and IPv6 alike.
Find a file
Neshura dec6834920
All checks were successful
Run Tests on Code / run-tests (push) Successful in 9s
Build binary file and bundle packages / test (pull_request) Successful in 8s
Build binary file and bundle packages / build (pull_request) Successful in 28s
Remove User Service file from cargo deb config
2024-01-08 08:43:43 +00:00
.forgejo/workflows Filter out build.env file for releases 2023-12-29 14:28:04 +01:00
debian Remove deprecated scripts for User Service File 2024-01-08 08:43:14 +00:00
src Potential Bugfix whereby the code threw an otherwise unexplained error 2023-12-29 01:56:48 +01:00
.gitignore Update .gitignore 2023-12-29 01:56:57 +01:00
Cargo.lock Release 1.1.3 2023-12-29 14:28:22 +01:00
Cargo.toml Remove User Service file from cargo deb config 2024-01-08 08:43:43 +00:00
COPYING Add GPLv3 License 2023-12-28 23:21:25 +01:00
README.md Specify config directory in Readme 2023-12-29 02:21:12 +01:00

Cloudflare DNS Updater

Using the application

The application necessarily requires a valid Cloudflare API Token. Further the application must be located in the same network as the configured zones.

The actual configuration happens in three or more files located in ~/.config/cloudflare-dns-updater/: config.toml contains general configuration parameters for the application interfaces.toml contains all IPv6 interfaces available/used by the zone config files.
.toml files in zone.d contain settings for individual zones.

Example:

config.toml

cf_api_token = "0123456789abcdef0123456789abcdef01234"  # Cloudflare API Token
check_interval_seconds = 30                             # Defaults to 60 if missing
uptime_url = "https://example.org/uptime/id12"          # Post Endpoint for a Uptime Monitor

interfaces.toml

host_address = "::edcb:a098:7654:3210"

[interfaces]
example-interface = "::0123:4567:890a:bcde"   # static part of the IP, the rest will be dynamically generated using the host

zone.d/example.org.toml

email = "owner@example.org"             # Email of User owning the Zone
zone = "example.org"                    # Zone Name
id = "01234567890abcdefghijklmnopqrstu" # Zone ID

[[entry]]
name = "example.org"                # "@" Symbol is not currently supported 
type = ["AAAA", "A"]                # Options are: "A" (IPv4/A Record) and/or "AAAA" (IPv6/AAAA Record) 
interface = "example-interface"     # Only required on type values 6 and 10

Debian Repository

Currently supported:

  • Debian 12 'Bookworm'

Includes systemd system and user unit files

For more details see the package registry