Dinaminis DNS (DDNS)

• Pavyzdžiai
  • ddclient
  • Curl
  • Synology
  • Home Assistant
  • Unifi

Maršrutizatoriai ir DDNS klientai, kurie palaiko DynDNS2 protokolą, gali naudoti mūsų API adresu ddns.simply.com.

Visą dokumentaciją galite rasti čia: https://ddns.simply.com/doc/

Pavyzdys:

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

Skriptams ir kitai DNS automatizacijai rekomenduojame mūsų REST API, kuri gali kurti, keisti ir ištrinti DNS įrašus.

Autentifikacija vyksta naudojant HTTP Basic Authentication, kur slaptažodis yra paskyros API raktas. Naudotojo vardas gali būti bet kas, pvz., paskyros pavadinimas. API raktas paskyrai turi būti sukurtas per mūsų Valdymo skydelį.

Jei nenurodytas myip, naudojamas IP adresas, iš kurio ateina užklausa. Atnaujinimai turi būti atliekami per HTTPS.

Įrašas turi būti rastas DNS zonoje, prieš jį atnaujinant: A įrašas IPv4 ir AAAA įrašas IPv6. Jei jo nėra, grąžinama nohost, todėl pirmiausia sukurkite įrašą valdymo skydelyje.

Parametras domain nurodo domeną. Jis turi būti perduodamas, kai atnaujinamas pats domenas, pvz., hostname=example.com&domain=example.com, ir gali būti naudojamas, kai domenas negali būti išvestas iš hostname.

Atsakymai atitinka DynDNS2 protokolą, pvz., good atnaujinimo metu ir nochg, kai IP adresas nepasikeitė.

Adresas https://ddns.simply.com/myip grąžina viešąjį IP adresą, iš kurio ateina užklausa, ir nereikalauja autentifikacijos.

¶Pavyzdžiai

¶ddclient

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

¶Curl

Naudokite šią Curl komandą, kad nustatytumėte home.example.com į išorinį IP užklausą teikiančiam klientui:

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

Galite sukonfigūruoti šią komandą veikti crontab, vietinėje mašinoje, kas 15 minučių arba panašiai.

¶Synology

Synology galite naudoti šią sintaksę kaip Custom DDNS Provider

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

hostname turi būti nurodytas kaip pilnas kvalifikuotas domeno vardas, kurį norite atnaujinti, pvz., home.example.com.

¶Home Assistant

Jutiklis gauna viešąjį IP adresą kas 5 minutes, o automatizacija atnaujina DNS tik kai adresas pasikeičia ir kai Home Assistant paleidžiamas. API raktas saugomas 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 turite sukonfigūruoti Custom Dynamic DNS teikėją ir įvesti šią eilutę į „Server“ laukelį.

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