Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/daniel-lerch/dyndns-distributor

Proxy for your router to update multiple Dynamic DNS accounts/providers
https://github.com/daniel-lerch/dyndns-distributor

aspnetcore docker-image dyndns dyndns-distributor

Last synced: 15 days ago
JSON representation

Proxy for your router to update multiple Dynamic DNS accounts/providers

Awesome Lists containing this project

README

        

# DynDNS Distributor #

[![](https://img.shields.io/docker/pulls/daniellerch/dyndns-distributor.svg)](https://hub.docker.com/r/daniellerch/dyndns-distributor)
[![](https://img.shields.io/docker/image-size/daniellerch/dyndns-distributor/latest.svg)](https://hub.docker.com/r/daniellerch/dyndns-distributor)

A dynamic DNS proxy for your router to update multiple domains.

Most routers only support a single dynamic DNS update URL.
If you want to update multiple hostnames, just configure DynDNS Distributor as update URL in your router and all your configured URLs will be updated immediately.

## Installation ##

Installation is easiest with Docker Compose.
Create a `docker-compose.yml` file with the following content and move on to configuration (next heading) before start.

```yaml
version: '2.1'

services:
app:
image: daniellerch/dyndns-distributor:3
volumes:
- ./dyndnsconfig.json:/app/dyndnsconfig.json
ports:
- "8080:8080"
```

Windows is not supported anymore but if you want me to provide Windows builds, just open an issue.

## Configuration ##
The configuration of update URLs, accounts and credentials is done in the file `dyndnsconfig.json` located in the application root.
Per default, the configuration looks like this:
```json
{
"ListenerAddress": ":8080",
"IpRetrieveUrl": "https://api.ipify.org/",
"UserAgent": "VectorData - DynDNS Distributor - 3.0",
"Accounts": [
{
"Username": "proxyuser",
"Password": "localnetpw123",
"UpdateOnStartup": true,
"UpdateUrls": [
"https://13135:[email protected]/nic/update?hostname=test.feste-ip.net",
"https://username:[email protected]/update?hostname=mydomain.de&myip="
]
}
]
}
```

#### `ListenerAddress` ####
The address for DynDNS Distributor to listen for HTTP requests from your router.
Use `:8080` to listen on port 8080 on all network interfaces.

#### `IpRetrieveUrl` ####
An URL to retrieve the extern IP address for local accounts.

#### `UserAgent` ####
The user agent that will be used for DNS updates.
Some providers, like strato.de or dyn.com require a specific user agent.

#### `Accounts` ####
An array that contains all account objects.
Each account has fields for `Username`, `Password` and another array `UpdateUrls`.
Setting `Username` and `Password` to `""` disables authentication.
Set `UpdateOnStartup` to `false` for domains which should have a different external IP than the server that runs DynDNS Distributor.

## AVM Fritz!Box ##
If you use a Fritz!Box as router, you have to configure the following update URL:
```
http://:/update?hostname=&myip=
```
Do not replace `` or `` as this will be done by the router.

Example:
```
http://192.168.178.46:8080/update?hostname=&myip=
```
In the username and password field, please fill in the same values as in your config file.

## Development ##

Recommended setup:
- Git
- Go 1.19+
- VS Code with Go extension

Run it locally:

```bash
git clone https://github.com/daniel-lerch/dyndns-distributor
cd dyndns-distributor
go run .
```