cfdns

README

Cloudflare Dynamic DNS Tool

cfdns is a small tool used to update dynamic DNS entries on Cloudflare.

Instructions

Standalone

1. Download the latest release binary from https://github.com/someone-stole-my-name/cfdns/releases
2. Create a json config file with your Cloudflare credentials, zones and names that looks like this (you can add as many records as you need):

{
   "IPEndpoint": "https://ipinfo.io/ip",
   "Sleep": 60,
   "Records":
   [
       {
           "Username": "myaccount@someone.com",
           "API-Key": "88b2b8e3d2b68b9cc4b945d81516v91d77k6g",
           "Zone": "myzone.xyz",
           "Entry": "myzone.xyz"
       },
       {
           "Username": "myaccount_1@someone.com",
           "API-Key": "55b2b8e3d2b68b9cc4b945d81516v91d77k6g",
           "Zone": "anotherzone.xyz",
           "Entry": "sub.anotherzone.xyz"
       }
   ]
}

1. Run the program cfdns --config config.json

Systemd autostart (Linux)

1. Edit the cfdns.service file and move it to /etc/systemd/system/, then run:

sudo systemctl daemon-reload
sudo systemctl enable cfdns
sudo systemctl start cfdns

Container

1. Create a json config file (see example above).
2. Run the program docker run -it --rm -v /my/path/to/config.json:/go/src/app/config.json chn2guevara/cfdns:1.0 --config /go/src/app/config.json