Sign inSign up

xjonathanlei/cfdydns

By xjonathanlei

•Updated over 2 years ago

Image
0

1.4K

xjonathanlei/cfdydns repository overview

⁠cfdydns

Cloudflare dynamic DNS client

A simplistic dynamic DNS client that only works with Cloudflare, for only one domain. It's easily configurable via environment variables, making it an ideal choice to use in containers.

⁠Installation

The recommended way of using cfdydns is through containers. Built containers are available in:

  • GitHub Container Registry: ghcr.io/xjonathanlei/cfdydns:latest
  • Docker Hub⁠: xjonathanlei/cfdydns:latest

You may also install the binary directly. With the Rust toolchain installed:

cargo install --locked --path .

⁠Getting started

cfdydns is configurable via command line options and environment variables. Running cfdydns --help reveals the options:

OptionEnv varOptionalDescription
--fqdnCFDYDNS_FQDNNoFully-qualified domain name to set A record on
--zoneCFDYDNS_ZONENoZone name of the FQDN (e.g. example.com)
--api-tokenCFDYDNS_API_TOKENNoCloudflare API token with the DNS: Edit permission for the target zone
--intervalCFDYDNS_INTERVALYesNumber of seconds to wait between each check

Tip

cfdydns does not create new records for you. The target A record for the FQDN must already exist.

⁠Why not ddclient⁠?

ddclient is hard to configure and barely maintained. Who cares about all the DNS provider integration when you're only using Cloudflare anyways.

⁠License

Licensed under either of

at your option.

Tag summary

Content type

Image

Digest

sha256:8c95cbb23…

Size

5.9 MB

Last updated

over 2 years ago

docker pull xjonathanlei/cfdydns