https://github.com/n1ko23/cloudflare-dns-updater

Automatically updates your Cloudflare DNS records for specific zones. Especially useful if you have dynamic IP address
https://github.com/n1ko23/cloudflare-dns-updater

automatic cloudflare dns rust

Last synced: about 1 month ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/n1ko23/cloudflare-dns-updater
• Owner: N1kO23
• License: mit
• Created: 2021-11-19T20:47:05.000Z (about 3 years ago)
• Default Branch: main
• Last Pushed: 2024-09-08T16:22:31.000Z (4 months ago)
• Last Synced: 2024-09-08T18:21:29.489Z (4 months ago)
• Topics: automatic, cloudflare, dns, rust
• Language: Rust
• Homepage:
• Size: 42 KB
• Stars: 9
• Watchers: 1
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# 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

```json

{

  "UpdateThreshold": 120,

  "Keys": [

    {

      "AuthKey": "nice key bro",

      "Zones": [

        {

          "ZoneId": "dfhmordntv8t4vb8snittvbies7nct7s47v",

          "ARecords": ["test2.domain.moe", "test.domain.moe", "tast.domain.moe"],

          "AaaaRecords": ["test2.domain.moe", "test.domain.moe", "tast.domain.moe"]

        }

      ]

    },

    {

      "AuthKey": "another pog key",

      "Zones": [

        {

          "ZoneId": "esyigod5tihdvtudn5gitvnecrasdadg",

          "ARecords": ["error.bababooey.com", "backend.bababooey.com", "bababooey.com"],

          "AaaaRecords": ["error.bababooey.com"]

        }

      ]

    }

  ]

}

```

#### Field values

- `UpdateThreshold`: Interval in seconds how often to check current IP and update the records if they don't match the IP

- `AuthKey`: Your private key to authenticate into Cloudflare

- `ZoneId`: ID of the zone to be edited

- `ARecords`: List of A-Records to be updated inside the zone, IPv4

- `AaaaRecords`: List of AAAA-Records to be updated inside the zone, IPv6

You can add more different keys and zones to those keys, as well as A and AAAA records to your needs, as long as your config follows the same structure

### 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](https://support.cloudflare.com/hc/en-us/articles/200167836-Managing-API-Tokens-and-Keys)

## Known bugs

None yet, you tell me