Skip to content

psi-4ward/hetzner-dyndns

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Oct 3, 2022
e3e81a5 · Oct 3, 2022

History

2 Commits
Oct 3, 2022
Oct 3, 2022
Oct 3, 2022
Oct 3, 2022
Oct 3, 2022
Oct 3, 2022
Oct 3, 2022
Oct 3, 2022

Repository files navigation

Hetzner DNS Updater - DynDNS

A very simple Deno script to update Records of Hetzner DNS based on the x-real-ip Header.
So be sure to run the Service behind a HTTP-Proxy (ie Traefik) which:

  • Handles SSL for you
  • Overwrites the x-real-ip Header to match the clients IP

It's recommended to use absolute DNS-Records - thus with the trailing dot.

DNS-Updater Configuration

# config.yaml

# Hetzner API Token
apiToken: xxxxx

# Available records
records:
  # Record for home.example.com
  # A-Record is configured relative in the DNS Server (without trailing dot)
  # Attention: This is not recommended cause some dyndns clients try to resolve the configured hostname
  home:
    # Credentials that have to be configured in your dyndns client
    user: user
    pass: pass
    # ZoneID can be copy pasted from the URL in Hetzner DNS Console
    # Ie https://dns.hetzner.com/zone/zzzzz
    zone: example.com-ZoneID

  # Record for office.example.com
  # A-Record is configured absolute in the DNS Server (with trailing dot)
  office.example.com:
    user: user
    pass: pass
    zone: example.com-ZoneID

  # Another example
  mynas.fuu.bar:
    user: user
    pass: pass
    zone: fubar.bar-ZoneID

Client Configuration

Unifi Dream Machine

Internet > your WAN Connection > Dynamic DNS

Field Value
Service dyndns
Hostname DNS-Record to update (ie home.example.com)
Username The user from config.yaml
Password The pass from config.yaml
Server The Domain (without protocol) where u've deployed the Hetzner DNS Updater with a /set/ suffix (ie dydns.example.com/set/ )

About

Simple DynDNS Update for Hetzner DNS API

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published