Dynaaminen DNS (DDNS)

• Esimerkit
  • ddclient
  • Curl
  • Synology
  • Home Assistant
  • Unifi

Reitittimet ja DDNS-asiakkaat, jotka tukevat DynDNS2-protokollaa, voivat käyttää APIamme osoitteessa ddns.simply.com.

Täydellinen dokumentaatio löytyy täältä: https://ddns.simply.com/doc/

Esimerkki:

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

Skripteihin ja muuhun DNS-automaatioon suosittelemme REST-APIamme, jonka avulla voidaan luoda, muokata ja poistaa DNS-tietueita.

Todennus tapahtuu HTTP Basic Authentication -menetelmällä, jossa salasanana käytetään tilin API-avainta. Käyttäjänimen voi olla mikä tahansa, esimerkiksi tilin nimi. API-avain tilille täytyy luoda hallintapaneelin kautta.

Jos myip jätetään pois, käytetään sitä IP-osoitetta, josta pyyntö tulee. Päivitykset on tehtävä HTTPS:n kautta.

Tietueen täytyy löytyä DNS-alueesta, ennen kuin sitä voidaan päivittää: A-tietue IPv4:lle ja AAAA-tietue IPv6:lle. Jos sitä ei löydy, vastataan nohost, joten luo tietue hallintapaneelissa ensin.

Parametri domain määrittää domainin. Se on lähetettävä, kun itse domainia päivitetään, esimerkiksi hostname=example.com&domain=example.com, ja sitä voidaan käyttää, kun domainia ei voida päätellä hostname-parametrista.

Vastaukset noudattavat DynDNS2-protokollaa, esimerkiksi good päivityksen yhteydessä ja nochg, kun IP-osoite ei ole muuttunut.

Osoite https://ddns.simply.com/myip palauttaa julkisen IP-osoitteen, josta pyyntö tulee, eikä vaadi todennusta.

¶Esimerkit

¶ddclient

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

¶Curl

Käytä seuraavaa Curl-komentoa asettaaksesi home.example.com pyytävän asiakkaan ulkoiseen IP-osoitteeseen:

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

Voit asettaa tämän komennon suoritettavaksi crontabissa paikallisella koneella, noin 15 minuutin välein.

¶Synology

Synologyssä voit käyttää seuraavaa syntaksia Custom DDNS Providerina

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

hostname on sen jälkeen annettava täydellisenä kelvollisena domain-nimenä, jonka haluat päivittää, esimerkiksi home.example.com.

¶Home Assistant

Sensori hakee julkisen IP-osoitteen 5 minuutin välein, ja automaatio päivittää DNS:n vain kun osoite muuttuu ja kun Home Assistant käynnistyy. API-avain tallennetaan secrets.yaml-tiedostoon.

# 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:ssä sinun täytyy määrittää Custom Dynamic DNS -palveluntarjoaja ja syöttää seuraava merkkijono "Server"-kenttään.

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