Compare commits

...

3 commits
v1.0 ... main

Author SHA1 Message Date
7e4452347f README.md: add reverse proxy as optional requirement
All checks were successful
continuous-integration/drone Build is passing
2021-11-20 00:46:24 +01:00
c21c47892e add README.md 2021-11-20 00:42:04 +01:00
e104767f13 drone-ci: also generate sha512 checksum for releases
All checks were successful
continuous-integration/drone/push Build is passing
2021-10-16 22:30:00 +02:00
2 changed files with 28 additions and 0 deletions

View file

@ -20,5 +20,6 @@ steps:
- dyndns-server - dyndns-server
checksum: checksum:
- sha256 - sha256
- sha512
when: when:
event: tag event: tag

27
README.md Normal file
View file

@ -0,0 +1,27 @@
dyndns-server
=============
`dyndns-server` is a simple self-hosted dynamic DNS API service which can be used
together with e.g. AVM FritzBox's DynDNS functionality or
[ddclient](https://github.com/ddclient/ddclient). It implements a subset of the
API described by
[Google Domains](https://support.google.com/domains/answer/6147083?hl=en#zippy=%2Cuse-the-api-to-update-your-dynamic-dns-recordhttps://support.google.com/domains/answer/6147083?hl=en#zippy=%2Cuse-the-api-to-update-your-dynamic-dns-record)
and forwards DNS Updates to an authoritive DNS server as per
[RFC2136](https://datatracker.ietf.org/doc/html/rfc2136).
Requirements
-------------
- `go` for building the `dyndns-server` binary
- an authoritive DNS server responsible for the records to be dynamically
updated which is capable of RFC2136 (e.g. knot, bind)
- `knsupdate` needs to be installed for sending DNS update requests
- a reverse-proxy for https (e.g. nginx), this is optional and `dyndns-server`
can also directly operate at port 80 which is discouraged as otherwise
secrets will be transmitted unencrypted
Configuration
-------------
`dyndns-server` will look for a file named `config.toml` inside the current
working directory unless a different config path has been supplied via `-config
<path to config file>`. For details regarding the configuration file format,
please consult `config.example.toml`.