Personal DDNS client with Digital Ocean Networking DNS as backend.
There are services like DynDNS, No-IP to access PCs remotely. But do we need them? This is your own DDNS solution which works for free (thanks to Digital Ocean Networking DNS).
From Wikipedia
Dynamic DNS (DDNS) is a method of automatically updating a name server in the Domain Name System (DNS), often in real time, with the active DDNS configuration of its configured hostnames, addresses or other information.
Download binary from releases.
And start it as:
ddns
Or you can download Docker image and use it:
docker run \
-v /path/to/config.yml:/config/ddns.yml \
skibish/ddns -conf-file /config/ddns.yml
Run ddns -h
, to see help.
It will output:
Usage of ./ddns:
-conf-file string
Location of the configuration file. If not provided, searches current directory, then $HOME for ddns.yml file
-ver
Show version
You need to setup your domain in Digital Ocean Networks panel.
In your domain name provider configuration point domain to Digital Ocean NS records.
Refer to: How To Point to DigitalOcean Nameservers From Common Domain Registrars
Configuration file ddns.yml
:
# DDNS configuration file.
# Mandatory, DigitalOcean API token.
# It can be also set using environment variable DDNS_TOKEN.
token: ""
# By default, IP check occurs every 5 minutes.
# It can be also set using environment variable DDNS_CHECKPERIOD.
checkPeriod: "5m"
# By default, timeout to external resources is set to 10 seconds.
# It can be also set using environment variable DDNS_REQUESTTIMEOUT.
requestTimeout: "10s"
# By default, IPv6 address is not requested.
# IPv6 address can be forced by setting it to `true`.
# It can be also set using environment variable DDNS_IPV6.
ipv6: false
# List of domains and their records to update.
domains:
example.com:
# More details about the fields can be found here:
# https://developers.digitalocean.com/documentation/v2/#create-a-new-domain-record
- type: "A"
name: "www"
- type: "TXT"
name: "demo"
# By default, is set to "{{.IP}}" (key .IP is reserved).
# Supports Go template engine.
# Additional keys can be set in "params" block below.
data: "My IP is {{.IP}} and I am {{.mood}}"
# By default, 1800 seconds (5 minutes).
ttl: 1800
# By default, params is empty.
params:
mood: "cool"
# By default, notifications is empty.
notifications:
# Gotify (https://gotify.net)
- type: "gotify"
app_url: "https://gotify.example.com"
app_token: ""
title: "DDNS"
# SMTP
- type: "smtp"
user: "[email protected]"
password: "1234"
host: "localhost"
port: "468"
from: "[email protected]"
to: "[email protected]"
subject: "My DDNS sending me a message"
# Telegram (https://telegram.org)
- type: "telegram"
token: "telegram bot token"
chat_id: "1234"