DNS dinamic (DDNS)

• Exemple
  • ddclient
  • Curl
  • Synology
  • Home Assistant
  • Unifi

Routere și clienți DDNS care suportă protocolul DynDNS2 pot folosi API-ul nostru la ddns.simply.com.

Documentația completă poate fi găsită aici: https://ddns.simply.com/doc/

Exemplu:

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

Pentru scripturi și alte automatizări DNS recomandăm API-ul nostru REST, care poate crea, modifica și șterge înregistrări DNS.

Autentificarea se face cu HTTP Basic Authentication, unde parola este cheia API pentru cont. Numele de utilizator poate fi orice, de exemplu numele contului. Cheia API pentru un cont trebuie creată prin Panoul nostru de control.

Dacă se omite myip, se folosește adresa IP de la care provine cererea. Actualizările trebuie să se facă prin HTTPS.

Înregistrarea trebuie să existe în zona DNS înainte de a fi actualizată: un A-record pentru IPv4 și un AAAA-record pentru IPv6. Dacă nu există, se răspunde cu nohost, așa că creează înregistrarea în panoul de control mai întâi.

Parametrul domain indică domeniul. Acesta trebuie trimis când domeniul este actualizat, de exemplu hostname=example.com&domain=example.com, și poate fi folosit când domeniul nu poate fi dedus din hostname.

Răspunsurile urmează protocolul DynDNS2, de exemplu good la o actualizare și nochg când adresa IP nu s-a schimbat.

Adresa https://ddns.simply.com/myip returnează adresa IP publică de la care provine cererea și nu necesită autentificare.

¶Exemple

¶ddclient

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

¶Curl

Folosește următoarea comandă Curl pentru a seta home.example.com la IP-ul extern al clientului care face cererea:

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

Poți programa această comandă să ruleze într-un crontab, pe o mașină locală, la fiecare 15 minute sau în jur.

¶Synology

Pe Synology poți folosi următoarea sintaxă ca furnizor DDNS personalizat

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

hostname trebuie apoi specificat ca numele de domeniu complet calificat pe care dorești să-l actualizezi, de exemplu home.example.com.

¶Home Assistant

Senzorul preia adresa IP publică la fiecare 5 minute, iar automatizarea actualizează DNS doar când adresa se schimbă și când Home Assistant pornește. Cheia API este stocată în 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

În UniFi OS trebuie să configurezi un furnizor Custom Dynamic DNS și să introduci următorul șir în câmpul „Server”.

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