Dynamisches DNS (DDNS)

• Beispiele
  • ddclient
  • Curl
  • Synology
  • Home Assistant
  • Unifi

Router und DDNS-Clients, die das DynDNS2-Protokoll unterstützen, können unsere API unter ddns.simply.com verwenden.

Vollständige Dokumentation finden Sie hier: https://ddns.simply.com/doc/

Beispiel:

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

Für Skripte und andere DNS-Automatisierungen empfehlen wir unsere REST-API, die DNS‑Einträge erstellen, ändern und löschen kann.

Die Authentifizierung erfolgt über HTTP Basic Authentication, wobei das Passwort der API‑Schlüssel des Kontos ist. Der Benutzername kann beliebig sein, z. B. der Kontoname. Der API‑Schlüssel für ein Konto muss über unser Kontrollpanel erstellt werden.

Wird myip weggelassen, wird die IP‑Adresse verwendet, von der die Anfrage stammt. Aktualisierungen müssen über HTTPS erfolgen.

Der Eintrag muss in der DNS‑Zone vorhanden sein, bevor er aktualisiert werden kann: ein A‑Record für IPv4 und ein AAAA‑Record für IPv6. Existiert er nicht, wird nohost zurückgegeben, sodass Sie den Eintrag zuerst im Kontrollpanel anlegen müssen.

Der Parameter domain gibt die Domain an. Er muss mitgesendet werden, wenn die Domain selbst aktualisiert wird, z. B. hostname=example.com&domain=example.com, und kann verwendet werden, wenn die Domain nicht aus hostname abgeleitet werden kann.

Die Antworten folgen dem DynDNS2‑Protokoll, z. B. good bei einer Aktualisierung und nochg, wenn die IP‑Adresse unverändert ist.

Die Adresse https://ddns.simply.com/myip gibt die öffentliche IP‑Adresse zurück, von der die Anfrage stammt, und erfordert keine Authentifizierung.

¶Beispiele

¶ddclient

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

¶Curl

Verwenden Sie den folgenden Curl‑Befehl, um home.example.com auf die externe IP des anfragenden Clients zu setzen:

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

Sie können diesen Befehl in einem Crontab auf einem lokalen Rechner einrichten, etwa alle 15 Minuten.

¶Synology

Auf Synology können Sie die folgende Syntax als benutzerdefinierten DDNS‑Provider verwenden

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

hostname muss dann als vollqualifizierter Domänenname angegeben werden, den Sie aktualisieren möchten, z. B. home.example.com.

¶Home Assistant

Der Sensor holt alle 5 Minuten die öffentliche IP‑Adresse, und die Automation aktualisiert DNS nur, wenn sich die Adresse ändert und wenn Home Assistant startet. Der API‑Schlüssel wird in secrets.yaml gespeichert.

# 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 müssen Sie einen benutzerdefinierten Dynamic‑DNS‑Provider einrichten und den folgenden String im Feld „Server“ eingeben.

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