Skip to content

Latest commit

 

History

History
47 lines (30 loc) · 1.4 KB

README.md

File metadata and controls

47 lines (30 loc) · 1.4 KB
Raw

Hetzner DynDNS

tl;dr Update a DNS record via the Hetzner DNS API to create a self-hosted DynDNS solution.

Requirements

  • A domain
  • Hetzner DNS Console
  • API Token
  • A/AAAA record

If you don't have one, go and create a Hetzner account at https://accounts.hetzner.com/. You'll need to move your DNS zone file to Hetzner for obvious reasons. Generate an API token to access the DNS API.

Environment Variables

Name Default value
HETZNER_DNS_API_BASEURL https://dns.hetzner.com/api/v1/
HETZNER_DNS_API_TOKEN
HOMEZONE_SUBDOMAIN_NAME home

These environment variables are used by the tool. Provide them as you see fit, eg. via .env file.

TODO

  • Create new A/AAAA record when not found
  • Support multiple records (home, dyn, ...)
  • Logging, Reporting

Usage

curl 'http://localhost:3000/update?domain=your-domain.tld&ipv4=1.2.3.4&ipv6=fe80::1234'

Please note: Values for domain and ipv6 are optional.

Set up AVM Fritzbox

You can provide your own DynDNS update URL in your AVM Fritzbox settings. See https://service.avm.de/help/de/FRITZ-Box-Fon-WLAN-7490/016/hilfe_dyndns for further instructions.

http://192.168.178.XXX:3000/update?domain=<domain>&ipv4=<ipaddr>&ipv6=ipaddr6

There are more parameters that are supported by the Fritzbox, but are currently not supported by this tool.