Dynamic DNS service using Amazon's Route 53 product.
There exist externally hosted services that manage mapping and updating dynamic IP addresses to domain names, but not near as many that can be run self hosted. The ddns53 utility allows one to directly update the IP address a registered domain name should point to provided that the domain is managed in Amazon's Route 53. In order to acomplish this task, boto3, the official Python library for accessing AWS, is leveraged.
Note, this utility is not by any means endorsed by Amazon. In addition, use of this software may violate the terms of service specified by your internet service provider. The end user assumes all responsiblity for the use of this software.
The following steps should briefly outline all that is needed to do in order to get this utility to work.
- Install Python.
sudo apt install python3
- Install boto3.
pip3 install boto3
- Configure AWS IAM user credentials (
~/.aws/credentials).
[default]
aws_access_key_id = YOUR_ACCESS_KEY
aws_secret_access_key = YOUR_SECRET_KEY
- Configure AWS region (
~/.aws/config).
[default]
region=us-west-2
To run the utility from the command line, all that is needed is to provide the domain hosted in Amazon's Route 53 that is to be updated.
./ddns53 [DOMAIN]
For example, if the domain foo.com is to be targeted, the utlitlity would be
run as follows.
./ddns53 foo.com
For best results, this tool can be scheduled to run as a cron job to
automatically update the DNS address record if/when your ISP decides to assign
you a new IP address. For an example, here is an entry in crontab to run
every hour while logging any errors to a local file.
0 * * * * /home/pi/ddns53 foo.com >> /home/pi/ddns53.log 2>&1
If systemd is preferred, the tool can be set up to run by systemd.timer.
/etc/systemd/system/ddns53.service
[Unit]
Description=Updates IP address on AWS Route 53
Wants=ddns53.timer
[Service]
Type=oneshot
ExecStart=/home/anon/Git/ddns53 YOUR_DOMAIN_HERE
KillMode=control-group
[Install]
WantedBy=multi-user.target
/etc/systemd/system/ddns53.timer
[Unit]
Description=Updates IP address on AWS Route 53
Requires=ddns53.service
[Timer]
Unit=ddns53.service
OnBootSec=1min
OnUnitActiveSec=1h
RandomizedDelaySec=2min
[Install]
WantedBy=timers.target
After doing some more digging, it looks like a lot of other domain registrars have API access available. Given this is a small program, I'm not totally sure if it makes sense to extend it to support other registrars given they will definitely have web API differences. On the other hand, it would be interesting to have a more generic solution or something that at least supports the major players out there. Stay tuned to find out more...