Simple program to auto update DNS information

When would you need this utility?

• Your public ip address is dynamic
• You want to use self hosted DDNS service (such as dprandzioch/docker-ddns)
• Your router is worth a piece of shit
  • There is no functionality for custom DDNS update url
  • CLI interface does not provide information about public IP address
  • The only possible way is through crappy web management

If you meet all these conditions above, congratulations! You are the second one on this planet who could appreciate this simple program.

Available IP providers

• Static (pre-defined IP address)
• Router TP-LINK Archer MR200

Basic info

• Author: Adam Zelycz
• Created: 2019-06-17

Requirements

• Docker
  or
• Linux (tested on Debian with apt-get)
• Python 3
• Make

Installation (if you do not use Docker)

make install

Usage

1. Open ddns-updater.sh and set your router model (ip provider). You can choose from available types in model folder
2. Also do not forget to fill update url with custom variables (secret, domain etc.) and possible custom configuration of selected provider
3. Make sure that script has correct permissions to be executed - chmod +x ddns-udater.sh
4. Run ddns-updater.sh
5. Configure your cron to run this script repetetively. You can be inspired by crontab.docker.txt.

Debugging

Configuration allows you to turn on generating debug information during running the script. log files and screenshots are located in log folder.

Configuration examples

(Content of ddns-update.sh)

Archer MR200

#!/bin/bash

# You can choose from available providers in `providers/` folder
IP_PROVIDER="mr200" # Default "static"
DYN_NAME="computer"
SECRET="secret"
# You can use "%<ip>%" as placeholder for provided IP
UPDATE_URL="https://example.com/update?secret=${SECRET}&domain=${DYN_NAME}&addr=%<ip>%"
# Custom arguments for given ip provider (e.g. password to an administration or static IP for "static" provider)
CUSTOM_ARGS="http://192.168.0.1 routeradminpassword123"

# 0 = OFF, 1 = ON
DEBUG=0

# EXECUTION
DIR=$(dirname $0)
python3 $DIR/ddns-updater.py "$IP_PROVIDER" "$UPDATE_URL" "$DEBUG" $CUSTOM_ARGS

Static

#!/bin/bash

# You can choose from available providers in `providers/` folder
IP_PROVIDER="static" # Default "static"
DYN_NAME="custom-domain"
SECRET="custom-secret"
# You can use "%<ip>%" as placeholder for provided IP
UPDATE_URL="https://example.com/update?secret=${SECRET}&domain=${DYN_NAME}&addr=%<ip>%"
# Custom arguments for given ip provider (e.g. password to an administration or static IP for "static" provider)
CUSTOM_ARGS="1.2.3.4"

# 0 = OFF, 1 = ON
DEBUG=0

# EXECUTION
DIR=$(dirname $0)
python3 $DIR/ddns-updater.py "$IP_PROVIDER" "$UPDATE_URL" "$DEBUG" $CUSTOM_ARGS