Dynamisk DNS (DDNS)

• Exempel
  • ddclient
  • Curl
  • Synology
  • Home Assistant
  • Unifi

Routrar och DDNS-klienter som stöder DynDNS2-protokollet kan använda vårt API på ddns.simply.com.

Fullständig dokumentation finns här: https://ddns.simply.com/doc/

Exempel:

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

För skript och annan automatisering av DNS rekommenderar vi vårt REST API, som kan skapa, ändra och ta bort DNS-poster.

Autentisering sker med HTTP Basic Authentication, där lösenordet är API-nyckeln för kontot. Användarnamnet kan vara vad som helst, t.ex. kontonamnet. API-nyckeln för ett konto måste skapas via vår Kontrollpanel.

Om myip utelämnas används den IP-adress som begäran kommer från. Uppdateringar måste ske över HTTPS.

Posten måste finnas i DNS-zonen innan den kan uppdateras: en A-post för IPv4 och en AAAA-post för IPv6. Om den inte finns svaras med nohost, så skapa posten i kontrollpanelen först.

Parametern domain anger domänen. Den måste skickas med när själva domänen uppdateras, t.ex. hostname=example.com&domain=example.com, och kan användas när domänen inte kan härledas från hostname.

Svaren följer DynDNS2-protokollen, t.ex. good vid en uppdatering och nochg när IP-adressen är oförändrad.

Adressen https://ddns.simply.com/myip returnerar den offentliga IP-adressen som begäran kommer från och kräver ingen autentisering.

¶Exempel

¶ddclient

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

¶Curl

Använd följande Curl-kommando för att sätta home.example.com till den externa IP:n för den begärande klienten:

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

Du kan schemalägga detta kommando i en crontab på en lokal maskin, var 15:e minut eller liknande.

¶Synology

På Synology kan du använda följande syntax som Custom DDNS Provider

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

hostname ska därefter anges som det fullständiga kvalificerade domännamnet som du vill uppdatera, t.ex. home.example.com.

¶Home Assistant

Sensorn hämtar den offentliga IP-adressen var 5:e minut, och automationen uppdaterar bara DNS när adressen förändras och när Home Assistant startar. API-nyckeln sparas 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 ska du konfigurera en Custom Dynamic DNS provider och ange följande sträng i fältet "Server".

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