Dynamický DNS (DDNS)

• Príklady
  • ddclient
  • Curl
  • Synology
  • Home Assistant
  • Unifi

Routery a DDNS klienti, ktoré podporujú protokol DynDNS2, môžu používať naše API na ddns.simply.com.

Úplná dokumentácia je k dispozícii tu: https://ddns.simply.com/doc/

Príklad:

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

Pre skripty a ďalšiu automatizáciu DNS odporúčame naše REST API, ktoré dokáže vytvárať, meniť a mazať DNS záznamy.

Overovanie prebieha pomocou HTTP Basic Authentication, kde heslo je API kľúč pre účet. Používateľské meno môže byť akékoľvek, napríklad názov účtu. API kľúč pre účet je potrebné vytvoriť prostredníctvom nášho ovládacieho panela.

Ak sa vynechá myip, použije sa IP adresa, z ktorej požiadavka prichádza. Aktualizácie musia prebiehať cez HTTPS.

Záznam musí existovať v DNS zóne, skôr než ho môžete aktualizovať: A-záznam pre IPv4 a AAAA-záznam pre IPv6. Ak neexistuje, odpovie sa nohost, preto najprv vytvorte záznam v ovládacom paneli.

Parameter domain určuje doménu. Musí sa odoslať, keď sa aktualizuje samotná doména, napríklad hostname=example.com&domain=example.com, a môže sa použiť, keď doména nie je odvodená z hostname.

Odpovede nasledujú protokol DynDNS2, napríklad good pri aktualizácii a nochg, keď sa IP adresa nezmenila.

Adresa https://ddns.simply.com/myip vráti verejnú IP adresu, z ktorej požiadavka prichádza, a nevyžaduje overovanie.

¶Príklady

¶ddclient

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

¶Curl

Použite nasledujúci príkaz Curl na nastavenie home.example.com na externú IP adresu požadujúceho klienta:

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

Tento príkaz môžete nastaviť, aby bežal v crontabe na lokálnom počítači každých 15 minút alebo približne tak.

¶Synology

Na Synology môžete použiť nasledujúcu syntax ako Custom DDNS Provider

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

hostname musí byť potom zadaný ako úplne kvalifikovaný názov domény, ktorý chcete aktualizovať, napríklad home.example.com.

¶Home Assistant

Senzor načítava verejnú IP adresu každých 5 minút a automatizácia aktualizuje DNS len keď sa adresa zmení a keď Home Assistant spustí. API kľúč sa ukladá v 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

V UniFi OS musíte nastaviť Custom Dynamic DNS provider a zadať nasledujúci reťazec do poľa „Server“.

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