Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/benjaminbear/docker-ddns-server
Dynamic DNS Server with Web UI written in Go
https://github.com/benjaminbear/docker-ddns-server
bind9 ddns docker docker-compose dyndns echo echo-framework go golang
Last synced: 19 days ago
JSON representation
Dynamic DNS Server with Web UI written in Go
- Host: GitHub
- URL: https://github.com/benjaminbear/docker-ddns-server
- Owner: benjaminbear
- License: mit
- Created: 2020-03-28T08:54:21.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-05-27T22:40:37.000Z (about 1 month ago)
- Last Synced: 2024-05-28T07:48:33.693Z (about 1 month ago)
- Topics: bind9, ddns, docker, docker-compose, dyndns, echo, echo-framework, go, golang
- Language: Go
- Homepage:
- Size: 956 KB
- Stars: 139
- Watchers: 7
- Forks: 45
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Lists
- awesome-stars - benjaminbear/docker-ddns-server - Dynamic DNS Server with Web UI written in Go (Go)
- awesome-starred - benjaminbear/docker-ddns-server - Dynamic DNS Server with Web UI written in Go (golang)
README
# Dynamic DNS Server for Docker with Web UI written in Go
With docker-ddns-server you can set up your own dynamic DNS server. This project is inspired by https://github.com/dprandzioch/docker-ddns . In addition to the original version, you can setup and maintain your dyndns entries via simple web ui.
## Installation
You can either take the docker image or build it on your own.
### Using the docker image
https://registry.hub.docker.com/r/bbaerthlein/docker-ddns-server
Just customize this to your needs and run:
```
docker run -it -d \
-p 8080:8080 \
-p 53:53 \
-p 53:53/udp \
-v /somefolder:/var/cache/bind \
-v /someotherfolder:/root/database \
-e DDNS_ADMIN_LOGIN=admin:123455546. \
-e DDNS_DOMAINS=dyndns.example.com \
-e DDNS_PARENT_NS=ns.example.com \
-e DDNS_DEFAULT_TTL=3600 \
--name=dyndns \
bbaerthlein/docker-ddns-server:latest
```
### Using docker-compose
You can also use Docker Compose to set up this project. For an example `docker-compose.yml`, please refer to this file: https://github.com/benjaminbear/docker-ddns-server/blob/master/deployment/docker-compose.yml
### Configuration
`DDNS_ADMIN_LOGIN` is a htpasswd username password combination used for the web ui. You can create one by using htpasswd:
```
htpasswd -nb user password
```
If you want to embed this into a docker-compose.yml you have to double the dollar signs for escaping:
```
echo $(htpasswd -nb user password) | sed -e s/\\$/\\$\\$/g
```
If `DDNS_ADMIN_LOGIN` is not set, all /admin routes are without protection. (use case: auth proxy)
`DDNS_DOMAINS` are the domains of the webservice and the domain zones of your dyndns server (see DNS Setup) i.e. `dyndns.example.com,dyndns.example.org` (comma separated list)
`DDNS_PARENT_NS` is the parent name server of your domain i.e. `ns.example.com`
`DDNS_DEFAULT_TTL` is the default TTL of your dyndns server.
`DDNS_CLEAR_LOG_INTERVAL` optional: clear log entries automatically in days (integer) e.g. `DDNS_CLEAR_LOG_INTERVAL:30`
`DDNS_ALLOW_WILDCARD` optional: allows all `*.subdomain.dyndns.example.com` to point to your ip (boolean) e.g. `true`
`DDNS_LOGOUT_URL` optional: allows a logout redirect to certain url by clicking the logout button (string) e.g. `https://example.com`
### DNS setup
If your parent domain is `example.com` and you want your dyndns domain to be `dyndns.example.com`,
an example domain of your dyndns server would be `blog.dyndns.example.com`.
You have to add these entries to your parent dns server:
```
dyndns IN NS ns
ns IN A
ns IN AAAA
```
## Updating entry
After you have added a host via the web ui you can setup your router.
Example update URL:
```
http://dyndns.example.com:8080/update?hostname=blog.dyndns.example.com&myip=1.2.3.4
or
http://username:[email protected]:8080/update?hostname=blog.dyndns.example.com&myip=1.2.3.4
```
this updates the host `blog.dyndns.example.com` with the IP 1.2.3.4. You have to setup basic authentication with the username and password from the web ui.
If your router doensn't support sending the ip address (OpenWRT) you don't have to set myip field:
```
http://dyndns.example.com:8080/update?hostname=blog.dyndns.example.com
or
http://username:[email protected]:8080/update?hostname=blog.dyndns.example.com
```
The handler will also listen on:
* /nic/update
* /v2/update
* /v3/update