Dinamico DNS (DDNS)

• Esempi
  • ddclient
  • Curl
  • Synology
  • Home Assistant
  • Unifi

Router e client DDNS che supportano il protocollo DynDNS2 possono utilizzare la nostra API su ddns.simply.com.

La documentazione completa è disponibile qui: https://ddns.simply.com/doc/

Esempio:

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

Per script e altre automazioni DNS consigliamo la nostra REST API, che può creare, modificare e cancellare record DNS.

L'autenticazione avviene con HTTP Basic Authentication, dove la password è la chiave API per l'account. Il nome utente può essere qualsiasi, ad esempio il nome dell'account. La chiave API per un account deve essere creata tramite il nostro Pannello di Controllo.

Se myip viene omesso, viene utilizzato l'indirizzo IP da cui proviene la richiesta. Gli aggiornamenti devono avvenire tramite HTTPS.

Il record deve trovarsi nella zona DNS prima di poter essere aggiornato: un record A per IPv4 e un record AAAA per IPv6. Se non esiste, viene restituito nohost, quindi crea il record nel pannello di controllo prima.

Il parametro domain indica il dominio. Deve essere inviato quando il dominio stesso viene aggiornato, ad esempio hostname=example.com&domain=example.com, e può essere usato quando il dominio non può essere dedotto da hostname.

Le risposte seguono il protocollo DynDNS2, ad esempio good per un aggiornamento e nochg quando l'indirizzo IP non è cambiato.

L'indirizzo https://ddns.simply.com/myip restituisce l'indirizzo IP pubblico da cui proviene la richiesta e non richiede autenticazione.

¶Esempi

¶ddclient

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

¶Curl

Usa il seguente comando Curl per impostare home.example.com all'IP esterno del client richiedente:

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

Puoi configurare questo comando per essere eseguito in una crontab, su una macchina locale, ogni 15 minuti circa.

¶Synology

Su Synology puoi utilizzare la seguente sintassi come Custom DDNS Provider

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

hostname deve quindi essere specificato come nome di dominio pienamente qualificato che desideri aggiornare, ad esempio home.example.com.

¶Home Assistant

Il sensore recupera l'indirizzo IP pubblico ogni 5 minuti, e l'automazione aggiorna il DNS solo quando l'indirizzo cambia e quando Home Assistant si avvia. La chiave API è salvata in 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

In UniFi OS devi configurare un provider Custom Dynamic DNS e inserire la seguente stringa nel campo "Server".

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