DNS dinamico

Il DNS dinamico tiene aggiornato un record A (IPv4) o AAAA (IPv6) quando l'indirizzo IP della tua connessione cambia: casa, ufficio, una telecamera o un server dietro un router con IP non fisso. Funziona con la gestione DNS dei tuoi domini ed è incluso, senza costi.

Attivarlo

  1. Apri Domini → nome del dominio → DNS.
  2. Nella riga del record A o AAAA clicca l'icona con le frecce su e giù (oppure ⋮ → DNS dinamico).
  3. Clicca Attiva. Compaiono l'indirizzo di aggiornamento, la riga per cron e i dati per il router, ognuno con il pulsante Copia.

Il record deve essere uno solo con quel nome e tipo: se ce ne sono due (per esempio due record A su casa), il DNS dinamico non sa quale aggiornare. Il record dinamico ha l'etichetta Dinamico nell'elenco.

La chiave si rivede quando vuoi dalla stessa finestra con Indirizzo e chiave.

Da uno script o da cron

Chiama l'indirizzo di aggiornamento (GET o POST): il record prende l'indirizzo IP da cui arriva la chiamata.

https://sitelyra.it/api/ddns/LA-TUA-CHIAVE

Per indicare tu l'indirizzo aggiungi ?ip=:

https://sitelyra.it/api/ddns/LA-TUA-CHIAVE?ip=203.0.113.10

Per controllarlo ogni 5 minuti con cron, su Linux o macOS:

*/5 * * * * curl -fsS "https://sitelyra.it/api/ddns/LA-TUA-CHIAVE" >/dev/null

Dal router (dyndns2)

Molti router e programmi conoscono già il protocollo dyndns2: Fritz!Box, MikroTik, Synology, OpenWrt, ddclient e altri. Scegli un fornitore personalizzato (o «dyndns2», «custom») e inserisci:

CampoValore
Indirizzo di aggiornamentohttps://sitelyra.it/api/nic/update?hostname=<nome>&myip=<ipaddr>
Nome host / dominioil nome completo del record, per esempio casa.esempio.it
Nome utenteil nome completo del record
Passwordla chiave del DNS dinamico

<ipaddr> lo sostituisce il router con il suo indirizzo (il segnaposto cambia da router a router: per esempio <ipaddr> sul Fritz!Box). Senza myip vale l'indirizzo da cui arriva la chiamata.

Con ddclient (/etc/ddclient.conf):

protocol=dyndns2
server=sitelyra.it
script=/api/nic/update
ssl=yes
login=casa.esempio.it
password=LA-TUA-CHIAVE
casa.esempio.it

Risposte

RispostaSignificato
good 203.0.113.10record aggiornato con l'indirizzo indicato
nochg 203.0.113.10l'indirizzo era già quello: nessuna modifica
badauthchiave sbagliata o DNS dinamico spento
nohostil nome non corrisponde al record, o il record non c'è più
numhostci sono più record con quel nome e tipo
abusetroppe chiamate: al massimo una al minuto per record
dnserrindirizzo non valido per il tipo del record, o errore temporaneo: riprova più tardi

IPv6

Per un record AAAA la chiamata deve arrivare in IPv6 (per esempio curl -6 …), oppure con l'indirizzo in ?ip= o myip=. Un indirizzo IPv4 su un record AAAA (o viceversa) viene rifiutato.

Rigenerare la chiave o disattivarlo

Dalla finestra DNS dinamico del record:

  • Rigenera la chiave: la chiave precedente smette subito di funzionare; aggiorna router e script con quella nuova.
  • Disattiva: la chiave non funziona più e il record resta con l'ultimo indirizzo.

Se elimini il record, anche il DNS dinamico si spegne.

Tratta la chiave come una password: chi la conosce può cambiare l'indirizzo del record. Ogni modifica resta nel registro delle attività.