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: about 2 months ago
JSON representation
Proxy for your router to update multiple Dynamic DNS accounts/providers
- Host: GitHub
- URL: https://github.com/daniel-lerch/dyndns-distributor
- Owner: daniel-lerch
- License: mit
- Created: 2018-04-26T19:41:32.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2024-12-19T14:06:18.000Z (4 months ago)
- Last Synced: 2025-03-09T05:47:06.520Z (about 2 months ago)
- Topics: aspnetcore, docker-image, dyndns, dyndns-distributor
- Language: Go
- Homepage:
- Size: 75.2 KB
- Stars: 3
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# DynDNS Distributor #
[](https://hub.docker.com/r/daniellerch/dyndns-distributor)
[](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 `compose.yaml` file with the following content and move on to configuration (next heading) before start.
```yaml
services:
app:
image: daniellerch/dyndns-distributor:4
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": "localhost:8080",
"IpRetrieveUrl": "https://api.ipify.org/",
"UserAgent": "DynDNS Distributor - 4.0",
"UpdateOnStartup": true,
"Username": "proxyuser",
"Password": "localnetpw123",
"Records": [
{
"UpdateUrl": "https://13135:[email protected]/nic/update?hostname=test.feste-ip.net"
},
{
"UpdateUrl": "https://username:[email protected]/update?hostname=mydomain.de&myip="
},
{
"UpdateUrl": "https://api.cloudflare.com/client/v4/zones/{zone_id}/dns_records/{dns_record_id}",
"Method": "PATCH",
"Headers": [
"Authorization: Bearer {api_token}"
],
"Body": "{\"content\":\"\"}"
}
]
}
```
#### `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.
#### `Username` & `Password` ####
Credentials for basic authentication. Setting `Username` and `Password` to `""` disables authentication.
> ⚠️ Note that an attacker in your local network can still capture packets sent from your router to the device running DynDNS Distributor and thereby gain access to change your DNS records to arbitrary IP addresses, generate valid TLS certificates, and so on. Basic authentication just makes it harder because the attacker must wait for some hours or days until an IP address change happens.
#### `UpdateOnStartup` ####
If set to `true`, DynDNS Distributor will query `IpRetrieveUrl` on startup and update all records according to its value.
#### `Records` ####
An array of records to update which must at least have a `UpdateUrl`. More sophisticated requests as required for Cloudflare are supported since DynDNS Distributor 4, too.
## 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.23+
- VS Code with Go extension
Run it locally:
```bash
git clone https://github.com/daniel-lerch/dyndns-distributor
cd dyndns-distributor
go run .
```