Dünaamiline DNS (DDNS)

• Näited
  • ddclient
  • Curl
  • Synology
  • Home Assistant
  • Unifi

Ruutere ja DDNS-klientid, mis toetavad DynDNS2-protokolli, saavad kasutada meie API-d aadressil ddns.simply.com.

Täielik dokumentatsioon on saadaval siin: https://ddns.simply.com/doc/

Näide:

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

Skriptide ja muu DNS-automatiseerimise jaoks soovitame meie REST API-d, mis suudab luua, muuta ja kustutada DNS-kirjeid.

Autentimine toimub HTTP Basic Authentication abil, kus parool on konto API-võti. Kasutajanimi võib olla mis tahes, näiteks konto nimi. Konto API-võti tuleb luua meie juhtpaneeli kaudu.

Kui myip jäetakse välja, kasutatakse IP-aadressi, kust päring pärineb. Värskendused peavad toimuma üle HTTPS-i.

Kirje peab olema DNS-tsoonis olemas, enne kui seda saab värskendada: A-kirje IPv4 jaoks ja AAAA-kirje IPv6 jaoks. Kui seda ei leita, vastatakse nohost, seega loo kirje kõigepealt juhtpaneelis.

Parameeter domain määrab domeeni. See tuleb kaasa saata, kui domeeni ennast värskendatakse, näiteks hostname=example.com&domain=example.com, ja seda saab kasutada, kui domeeni ei saa tuletada hostname-ist.

Vastused järgivad DynDNS2-protokolli, näiteks good värskenduse korral ja nochg, kui IP-aadress on muutumata.

Aadress https://ddns.simply.com/myip tagastab avaliku IP-aadressi, kust päring pärineb, ja ei nõua autentimist.

¶Näited

¶ddclient

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

¶Curl

Kasutage järgmist Curl käsku, et määrata home.example.com kliendi välisele IP-le:

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

Seda käsku saab seadistada crontabi käivitamiseks kohalikus masinas, iga 15 minuti või umbes.

¶Synology

Synology'l saate kasutada järgmist süntaksit kohandatud DDNS pakkujana

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

hostname tuleb seejärel määrata täieliku kvalifitseeritud domeeninimega, mida soovite värskendada, näiteks home.example.com.

¶Home Assistant

Sensor hangib avalikku IP-aadressi iga 5 minuti järel ning automatiseerimine värskendab DNS-i ainult siis, kui aadress muutub ja kui Home Assistant käivitub. API-võti salvestatakse faili 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

UniFi OS-is peate seadistama kohandatud dünaamilise DNS pakkuja ja sisestama järgmise stringi "Server" väljale.

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