Dynamické DNS (DDNS)

• Příklady
  • ddclient
  • Curl
  • Synology
  • Home Assistant
  • Unifi

Routery a DDNS klienti, kteří podporují protokol DynDNS2, mohou používat naše API na ddns.simply.com.

Úplná dokumentace je k dispozici zde: https://ddns.simply.com/doc/

Příklad:

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

Pro skripty a další automatizaci DNS doporučujeme naše REST API, které může vytvářet, měnit a mazat DNS záznamy.

Ověřování probíhá pomocí HTTP Basic Authentication, kde heslo je API klíč účtu. Uživatelské jméno může být libovolné, např. název účtu. API klíč pro účet je třeba vytvořit prostřednictvím našeho ovládacího panelu.

Pokud je vynechán parametr myip, použije se IP adresa, ze které požadavek přichází. Aktualizace musí probíhat přes HTTPS.

Záznam musí být v DNS zóně, než může být aktualizován: A záznam pro IPv4 a AAAA záznam pro IPv6. Pokud neexistuje, vrátí se nohost, takže nejprve vytvořte záznam v ovládacím panelu.

Parametr domain udává doménu. Musí být odeslán, když se samotná doména aktualizuje, např. hostname=example.com&domain=example.com, a může být použit, když doménu nelze odvodit z hostname.

Odpovědi odpovídají protokolu DynDNS2, např. good při aktualizaci a nochg, když se IP adresa nezměnila.

Adresa https://ddns.simply.com/myip vrací veřejnou IP adresu, ze které požadavek přichází, a nevyžaduje ověření.

¶Příklady

¶ddclient

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

¶Curl

Použijte následující příkaz Curl k nastavení home.example.com na externí IP požadujícího klienta:

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

Tento příkaz můžete naplánovat v crontabu na lokálním počítači, každých 15 minut nebo tak.

¶Synology

Na Synology můžete použít následující syntaxi jako Custom DDNS Provider

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

hostname musí být zadáno jako plně kvalifikovaný název domény, který chcete aktualizovat, např. home.example.com.

¶Home Assistant

Senzor získává veřejnou IP adresu každých 5 minut a automatizace aktualizuje DNS pouze když se adresa změní a když Home Assistant startuje. API klíč je uložen 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 nastavit Custom Dynamic DNS provider a zadat následující řetězec do pole „Server“.

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