Sign inSign up

xjonathanlei/cfdydns

By xjonathanlei

Updated over 2 years ago

Image
0

1.3K

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