Dynamisk DNS (DDNS)

• Eksempler
  • ddclient
  • Curl
  • Synology
  • Home Assistant
  • Unifi

Rutere og DDNS-klienter som støtter DynDNS2-protokollen, kan bruke vårt API på ddns.simply.com.

Full dokumentasjon kan finnes her: https://ddns.simply.com/doc/

Eksempel:

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

Til skript og annen automatisering av DNS anbefaler vi vårt REST API, som kan opprette, endre og slette DNS-poster.

Autentisering skjer med HTTP Basic Authentication, hvor passordet er API-nøkkelen for kontoen. Brukernavnet kan være hva som helst, f.eks. kontonavnet. API-nøkkelen for en konto må opprettes gjennom vårt Kontrollpanel.

Hvis myip utelates, brukes IP-adressen som forespørselen kommer fra. Oppdateringer må skje over HTTPS.

Posten må finnes i DNS-sonen før den kan oppdateres: en A-post for IPv4 og en AAAA-post for IPv6. Finnes den ikke, svarer den med nohost, så opprett posten i kontrollpanelet først.

Parameteren domain angir domenet. Den skal sendes med når selve domenet oppdateres, f.eks. hostname=example.com&domain=example.com, og kan brukes når domenet ikke kan avledes fra hostname.

Svarene følger DynDNS2-protokollen, f.eks. good ved en oppdatering og nochg når IP-adressen er uendret.

Adressen https://ddns.simply.com/myip returnerer den offentlige IP-adressen som forespørselen kommer fra, og krever ingen autentisering.

¶Eksempler

¶ddclient

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

¶Curl

Bruk følgende Curl-kommando for å sette home.example.com til den eksterne IP-en for den forespørrende klienten:

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

Du kan sette opp denne kommandoen til å kjøre i en crontab på en lokal maskin, hvert 15. minutt eller deromkring.

¶Synology

På Synology kan du bruke følgende syntaks som Custom DDNS Provider

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

hostname skal deretter angis som det fullstendige kvalifiserte domenenavnet du ønsker å oppdatere, f.eks. home.example.com.

¶Home Assistant

Sensoren henter den offentlige IP-adressen hvert 5. minutt, og automasjonen oppdaterer kun DNS når adressen endrer seg, og når Home Assistant starter. API-nøkkelen lagres i 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

I UniFi OS skal du sette opp en Custom Dynamic DNS provider og skrive inn følgende streng i «Server»-feltet.

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