Dynamisch DNS (DDNS)

• Voorbeelden
  • ddclient
  • Curl
  • Synology
  • Home Assistant
  • Unifi

Routers en DDNS-clients die het DynDNS2-protocol ondersteunen, kunnen onze API op ddns.simply.com gebruiken.

Volledige documentatie is hier te vinden: https://ddns.simply.com/doc/

Voorbeeld:

https://ddns.simply.com/nic/update?hostname=home.example.com&domain=example.com&myip=1.2.3.4

Voor scripts en andere DNS-automatisering raden we onze REST API aan, die DNS-records kan aanmaken, wijzigen en verwijderen.

Authenticatie gebeurt via HTTP Basic Authentication, waarbij het wachtwoord de API-sleutel voor het account is. De gebruikersnaam kan alles zijn, bijvoorbeeld de accountnaam. De API-sleutel voor een account moet worden aangemaakt via ons Controlepaneel.

Als myip wordt weggelaten, wordt het IP-adres gebruikt vanwaar het verzoek komt. Updates moeten via HTTPS plaatsvinden.

Het record moet in de DNS-zone aanwezig zijn voordat het kan worden bijgewerkt: een A-record voor IPv4 en een AAAA-record voor IPv6. Als het niet bestaat, wordt nohost geretourneerd, dus maak het record eerst aan in het controlepaneel.

De parameter domain geeft het domein aan. Deze moet worden meegestuurd wanneer het domein zelf wordt bijgewerkt, bijvoorbeeld hostname=example.com&domain=example.com, en kan worden gebruikt wanneer het domein niet kan worden afgeleid van hostname.

De antwoorden volgen het DynDNS2-protocol, bijvoorbeeld good bij een update en nochg wanneer het IP-adres ongewijzigd is.

Het adres https://ddns.simply.com/myip retourneert het openbare IP-adres vanwaar het verzoek komt, en vereist geen authenticatie.

¶Voorbeelden

¶ddclient

protocol=dyndns2
ssl=yes
server=ddns.simply.com
login=ACCOUNTNAME
password=APIKEY
home.example.com

¶Curl

Gebruik de volgende Curl-opdracht om home.example.com in te stellen op het externe IP van de aanvragende client:

curl -s -u "ACCOUNTNAME:APIKEY" "https://ddns.simply.com/nic/update?hostname=home.example.com"

Je kunt deze opdracht instellen om te draaien in een crontab, op een lokale machine, elke 15 minuten of zo.

¶Synology

Op Synology kun je de volgende syntaxis gebruiken als Custom DDNS Provider

https://ddns.simply.com/nic/update?hostname=__HOSTNAME__&myip=__MYIP__

hostname moet vervolgens worden opgegeven als de volledige gekwalificeerde domeinnaam die je wilt bijwerken, bijvoorbeeld home.example.com.

¶Home Assistant

De sensor haalt het openbare IP-adres elke 5 minuten op, en de automatisering werkt alleen DNS bij wanneer het adres verandert, en wanneer Home Assistant start. De API-sleutel wordt opgeslagen in secrets.yaml.

# configuration.yaml
sensor:
  - platform: rest
    name: Public IP
    resource: https://ddns.simply.com/myip
    value_template: "{{ value | trim }}"
    scan_interval: 300

rest_command:
  simplycom_ddns:
    url: "https://ddns.simply.com/nic/update?hostname=home.example.com"
    username: "ACCOUNTNAME"
    password: !secret simply_api_key

# secrets.yaml
simply_api_key: "APIKEY"

# Automation
alias: Simply.com DDNS
triggers:
  - trigger: state
    entity_id: sensor.public_ip
  - trigger: homeassistant
    event: start
actions:
  - action: rest_command.simplycom_ddns

¶Unifi

In UniFi OS moet je een Custom Dynamic DNS provider instellen en de volgende string invoeren in het veld "Server".

ddns.simply.com/nic/update?hostname=%h&myip=%i