docker-ddns-cloudflare/README.md

71 lines
1.5 KiB
Markdown
Raw Normal View History

2019-01-22 13:03:30 +01:00
# Docker DDNS Cloudflare
2020-07-23 12:52:07 +02:00
2020-07-23 12:56:36 +02:00
## Features 🌈
- Simple container for setting setting and updating to your local ip address.
- Only makes requests if the IP has changed since last time.
- By default it runs once every minute and the IP is resolved by https://canihazip.com.
2019-01-22 13:03:30 +01:00
## Quickstart 🚀
2020-07-23 12:56:36 +02:00
1. Get yout api token [here](https://dash.cloudflare.com/profile/api-tokens) (Top right -> My Profile -> API Tokens)
Click create token. You can then use the Edit DNS Zone template. Give it a name.
2020-07-23 12:58:54 +02:00
![Settings](https://i.imgur.com/dLs8PHs.png)
2019-01-22 13:12:50 +01:00
2020-07-23 12:59:48 +02:00
2. Create an `.env` file:
2019-01-22 13:03:30 +01:00
```bash
EMAIL=my@mail.com
KEY=my_api_key
ZONE=example.org
DNS_RECORD=some.example.org
```
2020-07-23 12:59:48 +02:00
3. Run the container
2019-01-22 13:03:30 +01:00
```bash
docker run -d --name ddns --restart always --env-file .env cupcakearmy/ddns-cloudflare
```
2020-07-23 12:52:07 +02:00
To check logs:
2019-01-22 13:03:30 +01:00
```bash
docker logs ddns
```
### Docker-Copmose
With docker-compose:
```bash
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
2019-01-22 13:12:50 +01:00
```
2020-07-23 12:52:07 +02:00
## 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.
```bash
# .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.
```bash
# .env
RESOLVER=https://ipv4.icanhazip.com/
```