Dinamisks DNS (DDNS)

• Piemēri
  • ddclient
  • Curl
  • Synology
  • Home Assistant
  • Unifi

Maršrutētāji un DDNS klienti, kas atbalsta DynDNS2 protokolu, var izmantot mūsu API vietnē ddns.simply.com.

Pilna dokumentācija ir pieejama šeit: https://ddns.simply.com/doc/

Piemērs:

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

Skriptiem un citai DNS automatizācijai mēs iesakām mūsu REST API, kas var izveidot, mainīt un dzēst DNS ierakstus.

Autentifikācija notiek, izmantojot HTTP Basic Authentication, kur parole ir konta API atslēga. Lietotājvārds var būt jebkas, piemēram, konta nosaukums. API atslēga kontam jāizveido caur mūsu Kontroles paneli.

Ja myip tiek izlaists, tiek izmantota IP adrese, no kuras nāk pieprasījums. Atjauninājumiem jānotiek, izmantojot HTTPS.

Ieraksts jābūt DNS zonā, pirms to var atjaunināt: A ieraksts IPv4 un AAAA ieraksts IPv6. Ja tas nepastāv, tiek atgriezts nohost, tāpēc vispirms izveidojiet ierakstu Kontroles panelī.

Parametrs domain norāda domēnu. To jānosūta, kad pats domēns tiek atjaunināts, piemēram, hostname=example.com&domain=example.com, un to var izmantot, ja domēns nevar tikt izvilkts no hostname.

Atbildes seko DynDNS2 protokolam, piemēram, good pie atjauninājuma un nochg, kad IP adrese nav mainījusies.

Adrese https://ddns.simply.com/myip atgriež publisko IP adresi, no kuras nāk pieprasījums, un neprasa autentifikāciju.

¶Piemēri

¶ddclient

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

¶Curl

Izmantojiet šo Curl komandu, lai iestatītu home.example.com uz pieprasītāja klienta ārējo IP:

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

Jūs varat iestatīt šo komandu, lai tā tiktu izpildīta crontab, lokālajā datorā, ik pēc 15 minūtēm vai apmēram.

¶Synology

Synology var izmantot šo sintaksi kā Custom DDNS Provider

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

hostname jānorāda kā pilns kvalificēts domēna nosaukums, ko vēlaties atjaunināt, piemēram, home.example.com.

¶Home Assistant

Sensors ik pēc 5 minūtēm iegūst publisko IP adresi, un automatizācija atjaunina DNS tikai tad, kad adrese mainās, un kad Home Assistant tiek palaists. API atslēga tiek saglabāta 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 jāizveido Custom Dynamic DNS pakalpojuma sniedzējs un jāievada šī virkne “Server” laukā.

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