According to the Wikipedia, DDNS is: Dynamic DNS ( DDNS or DynDNS) 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. — Wikipedia ( source ) The most common use of a DDNS service is to access your computer at home or work when your IP changes dynamically. You may heard about services like or . You create account, install client on your machine and they give you a domain to access your computer. The most common cons of these services are the following: DynDNS No-IP These services are not free (or for a limited time) You are tied to one DNS provider A custom domain is an extra feature What additional features I wanted to see in DDNS service: Specified DNS records should be updated on IP change. Not only A, but also TXT records andothers When an IP is changed, I want to be notified about it It should be free In the end, I haven’t found service that had such features, so that’s how was born. Personal DDNS Client The decision was made to write client in . Golang For a DNS provider my choice fell on DNS. Why? DigitalOcean Networking I use DigitalOcean for pet projects Their Networking stack is free DigitalOcean has amazing API for their inner services DigitalOcean DNS became a backend for the client. To make everything work you need to have a DigitalOcean account and setup a domain you would like to use. You can follow . But we will continue. this tutorial to setup your domain How to setup DDNS client? This example will use Ubuntu Linux. You can apply the same approach to whatever distribution you like. Client installation The first thing to do is — you should download the client using following commands: > curl -L https://github.com/skibish/ddns/releases/download/2.1.3/ddns-`uname -s`-`uname -m` > /usr/local/bin/ddns > chmod +x /usr/local/bin/ddns Now binary will be available at . To check, that it is installed, run in the terminal. If you will see this output: ddns /usr/local/bin/ddns ddns -h Usage of ddns: -check-period duration Check if IP has been changed period (default 5m0s) -conf-file string Location of the configuration file (default "$HOME/.ddns.yml") -req-timeout duration Request timeout to external resources (default 10s) You are ready to move forward. Configuration file setup To use the client with DigitalOcean, you need to get OAuth token. How to generate it, . read here The client requires a configuration file, where the rules to update the DNS records are described. Create a file named in your home directory. The most simple setup is the following: .ddns.yml token: "TOKEN" # DigitalOcean tokendomain: "example.com" # Domain to updaterecords: # Records of the domain to update type: "A" # Record typename: "@" # Record name In this case, the record with the name of the domain will be updated with your IP. If you want to update multiple records, add them. A @ example.com token: "TOKEN"domain: "example.com"records: type: "A"name: "@" type: "A"name: "www" type: "TXT"name: "info" Now, if you will start the client, everything should work. Congratulations! You have your own personal DDNS. Put DDNS in the background But how to leave it to work in the background? A good solution would be to register a new service on your linux machine. Create a file (you want to create this file under user). Paste in it the configuration that is specified bellow: /etc/systemd/system/ddns.service sudo [Unit]Description=DDNS client with DigitalOcean as backendAfter=network.target[Service]ExecStart=/usr/local/bin/ddnsUser=<YOUR USERNAME>Type=simpleRestart=always[Install]WantedBy=default.target In this configuration change to your username. Save file. <YOUR USERNAME> While you are under user enable and start this service. sudo $ systemctl enable ddns$ systemctl start ddns Cool, now you have a service that will start after computer boot up. Advanced configuration In the beginning, I’ve told, that one of the advantages would be to get notifications via email. How to setup notifications? Currently supported notification is only SMTP. If there will be more, you would be able to find them in the of the project. README.md token: "TOKEN"domain: "example.com"records: type: "A"name: "@"notify:smtp:user: "foo@example.com"password: "1234"host: "smtp.example.com"port: "465"to: "foobar@gmail.com"subject: "My DDNS sending me a message"secure: true # Optional flag. Set it, if you will send emails with SSL With this configuration you have now the ability to send emails. But your emails most likely will appear in the folder. How to fix this? We can create record for the domain and mark your IP as safe for email provider. spam SPF token: "TOKEN"domain: "example.com"records: type: "A"name: "@" type: "TXT"name: "@"data: "v=spf1 ip4:{{.IP}} include:_spf.example.com ~all"notify:smtp:user: "foo@example.com"password: "1234"host: "smtp.example.com"port: "465"to: "foobar@gmail.com"subject: "My DDNS sending me a message"secure: true A new record was added with a field. This field is optional. But when it is set, you can use the full potential of engine. In this case, when the IP will be updated, this TXT record will be updated too. TXT data Golang text/template Using this example of a SPF record, consider, that you need to add two more IPs, but they are static values. What to do? For this case you have . parameters token: "TOKEN"domain: "example.com"records: type: "A"name: "@" type: "TXT"name: "@"data: "v=spf1 ip4:{{.IP}} ip4:{{.ipOne}} ip4:{{.ipTwo}} include:_spf.example.com ~all"params:ipOne: "10.10.10.10"ipTwo: "20.20.20.20"notify:smtp:user: "foo@example.com"password: "1234"host: "smtp.example.com"port: "465"to: "foobar@gmail.com"subject: "My DDNS sending me a message"secure: true As you can see, setup is flexible and you can update a lot of things in your DNS using this tool. What’s next The next step would be to add the ability to choose your DNS provider, because somebody could be using, for example, . But it is a step for the next release and I would be happy to accept contributions :) Cloudflare . Personal DDNS is open and is available on the GitHub
