cupcakearmy/docker-ddns-cloudflare
1
0
Fork 0
mirror of https://github.com/cupcakearmy/docker-ddns-cloudflare.git synced 2024-12-21 23:36:24 +00:00
Code Issues Packages Projects Releases Wiki Activity
Cloudflare DDNS Script
49 Commits 1 Branch 12 Tags 161 KiB
TypeScript 94.7%
Dockerfile 5.3%
144d5abeb6
Go to file
Niccolo Borgioli 144d5abeb6
update pnpm version
2024-02-27 13:14:34 +01:00
.github 1.3.0 (#6) 2022-10-20 15:18:57 +02:00
src 1.3.1 (#7) 2022-11-28 02:12:08 +01:00
.dockerignore pnpm & typescript 2021-10-22 17:47:49 +02:00
.gitignore changelog, update deps & adapt pr 2022-05-14 15:58:38 +02:00
.sample.env update sample env 2022-10-20 15:25:21 +02:00
CHANGELOG.md update packages 2024-02-27 13:13:47 +01:00
docker-compose.yml pnpm & typescript 2021-10-22 17:47:49 +02:00
Dockerfile update deps and use corepack for pnpm 2023-08-20 22:37:36 +02:00
package.json update pnpm version 2024-02-27 13:14:34 +01:00
pnpm-lock.yaml update packages 2024-02-27 13:13:47 +01:00
README.md 1.3.0 (#6) 2022-10-20 15:18:57 +02:00
tsconfig.json update deps 2023-06-24 16:19:36 +02:00

README.md

Docker DDNS Cloudflare

Docker Pulls Docker Image Size (tag) Docker Image Version (tag latest semver)

Features 🌈

  • Simple container for setting setting and updating cloudflare records to your local ip address.
  • Only makes requests if the IP has changed.
  • By default it runs once every minute and the IP is resolved by https://api.ipify.org/.

Quickstart 🚀

  1. Get your API Token here (Top right -> My Profile -> API Tokens)

Click create token. You can then use the Edit DNS Zone template. Give it a name.

  1. Create an .env file:
TOKEN=mytoken

ZONE=example.org
DNS_RECORD=some.example.org
PROXIED=false
  1. Run the container
docker run -d --name ddns --restart always --env-file .env cupcakearmy/ddns-cloudflare

Docker-Copmose

With docker-compose:

git clone https://github.com/CupCakeArmy/docker-ddns-cloudflare.git
cp .sample.env .env
# Edit the .env file with your data
docker-compose up -d

ENV Reference

Env Default Description
TOKEN API Token.
ZONE Cloudflare zone where your domain is.
DNS_RECORD The actual DNS record that should be updated.
PROXIED true Whether the record is proxied by CloudFlare or not.
CRON */5 * * * * Frequency of updates.
RESOLVER https://api.ipify.org/ The endpoint used to determine your public ip.
LOG_LEVEL info Log level to run at. See winston for possible values

Customize

Custom CRON

By default the script runs every 5 minutes. You can customize this by simply setting the CRON value in the .env file.

# .env

# e.g. every minute
CRON=* * * * *

Custom Resolver

By default the script checks the own ip by calling https://api.ipify.org/. This also can be configured. It has to be an endpoint that return a plain text containing the ip by get request.

# .env

RESOLVER=https://ipv4.icanhazip.com/