Automatically updates your Cloudflare DNS records for specific zones. Especially useful if you have dynamic IP address

Niko Huuskonen

Last update: Aug 30, 2022

Related tags

Overview

Cloudflare DNS updater

What does it do?

Cloudflare DNS updater updates specified dns records for specified zones effortlessly and automatically. It was originally created to help me hosting my services under dynamic public IP address. Feel free to fork and reuse the code.

How to use

You can compile the updater from source or download the binary. To compile the program by yourself, you need to have the rustc and cargo installed.

Create your config.json that matches the example

{
  "UpdateThreshold": 120,
  "Keys": [
    {
      "AuthKey": "your auth key to some zones",
      "Zones": [
        {
          "ZoneId": "dfhmordntv8t4vb8snittvbies7nct7s47v",
          "Records": ["test2.domain.moe", "test.domain.moe", "tast.domain.moe"]
        }
      ]
    },
    {
      "AuthKey": "your auth key to some other zones",
      "Zones": [
        {
          "ZoneId": "esyigod5tihdvtudn5gitvnecrasdadg",
          "Records": ["error.bababooey.com", "backend.bababooey.com", "bababooey.com"]
        }
      ]
    }
  ]
}

Important

You have to generate your authentication key in cloudflare with necessary permissions to view and edit the specified zones and their dns records, detailed instruction can be found here

Known bugs

None yet, you tell me

Comments

Error missing field 'result' at line1 column 76
I am getting this error with the following (sanitized) config.json in the same directory as my binary. I have compiled on aarch64 using ubuntu 20.04 distro:

{ "UpdateThreshold": 120, "Keys": [ { "AuthKey": "sanitized", "Zones": [ { "ZoneId": "sanitized", "ARecords": [ "teleport.v4.some.site" ], "AaaaRecords": [ "teleport.v6.some.site.me" ] } ] } ] }

I have created an API Token according to the directions (I did limit it to my ip addresses, and a single zone, which is the zone in question and the Cloudflare token retrieval worked..
opened by symgryph 3