VYDNS

A simple DynDNS v2 client written in Python, compatible with providers such as OVH DynHost.

Features

Periodically checks the public IP address
Updates DNS records only when the IP changes
Uses a local cache to avoid unnecessary updates
No external dependencies except requests module

Usage

Run the script with Python. It will periodically:

Query a web endpoint that returns the public IP in plain text
Compare it with the cached IP
If the IP has not changed, sleep for the configured delay
If the IP has changed, update the DNS records and refresh the cache
If no cache exists, create it and perform an initial update

Configuration

The script relies on a JSON configuration file named config.json located in the working directory.

It must contain the following keys:

ip_server: URL of the endpoint used to retrieve the public IP (must return plain text)
dns_endpoint: DynDNS v2 API endpoint of the provider
username: DynDNS account username
password: DynDNS account password
domains: list of domain names to update
delay: interval in seconds between checks

You can find an example configuration file in this repo. Warning: the password is stored in plain text. Changing config file permissions is recommended.

Supported DynDNS providers

To this day, these DynDNS providers have been found to work well with the script:

License

This script and the provided examples are under the MIT license.

1.5 KiB Raw Blame History