Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lobis/cloudflare-ddns
Dynamic DNS using Cloudflare. Emute a static IP with an auto-updating DNS record.
https://github.com/lobis/cloudflare-ddns
cloudflare cronjob ddns dns ip ipv4 static
Last synced: 6 days ago
JSON representation
Dynamic DNS using Cloudflare. Emute a static IP with an auto-updating DNS record.
- Host: GitHub
- URL: https://github.com/lobis/cloudflare-ddns
- Owner: lobis
- License: mit
- Created: 2024-02-21T16:29:47.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2024-02-21T17:18:05.000Z (9 months ago)
- Last Synced: 2024-02-22T18:00:36.704Z (9 months ago)
- Topics: cloudflare, cronjob, ddns, dns, ip, ipv4, static
- Language: Shell
- Homepage:
- Size: 6.84 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# cloudflare-ddns
Dynamic DNS using Cloudflare's API.
This repository contains a bash script that updates a Cloudflare DNS record with the public IP of the machine it's running on.
In order to use this script, you need to have a Cloudflare account and a domain with Cloudflare nameservers.
## Requirements
- `curl`: The script uses `curl` to make requests to the Cloudflare API.
- `grep`: The script uses `grep` to parse the response from the Cloudflare API. This is a standard Unix utility and should be available on most systems.
- `awk`: The script uses `awk` to parse the response from the Cloudflare API. This is a standard Unix utility and should be available on most systems.
## Usage
The script takes three positional arguments:
1. `CF_API_TOKEN`: Your Cloudflare API token.
2. `CF_ZONE_ID`: The ID of the zone containing the DNS record you want to update (available in the Cloudflare dashboard).
3. `DNS_RECORD_NAME`: The name of the DNS A record you want to update as a fully qualified domain name (e.g. `record.example.com`). You need to have this record already created in your Cloudflare account.
```bash
bash ./cloudflare-update-dns-record.sh $CF_API_TOKEN $CF_ZONE_ID $DNS_RECORD_NAME
```
It is recommended to make the script executable and add it to your crontab to run it periodically.
First place the script in an appropriate location, for example `/usr/local/bin/cloudflare-update-dns-record.sh`.
```bash
# Download the script to /usr/local/bin
curl -o /usr/local/bin/cloudflare-update-dns-record.sh https://raw.githubusercontent.com/lobis/cloudflare-ddns/main/cloudflare-update-dns-record.sh
# Make the script executable
chmod +x /usr/local/bin/cloudflare-update-dns-record.sh
```
Then open your crontab:
```bash
crontab -e
```
Add the following line to run the script every 5 minutes (replace the placeholders with your actual values):
```bash
*/5 * * * * /usr/local/bin/cloudflare-update-dns-record.sh $CF_API_TOKEN $CF_ZONE_ID $DNS_RECORD_NAME
```