Il DNS dinamico, o DDNS, è un servizio DNS che consente di aggiornare automaticamente gli indirizzi IP dei record A e AAAA quando il provider Internet assegna un nuovo IP al tuo collegamento. È una soluzione utile soprattutto per le reti domestiche, dove l'IP pubblico cambia spesso.
Per prima cosa accedi alla Console ICBS. Se non hai ancora un account, registrati dalla stessa pagina.
Con l'account attivo, crea una zona DNS per il tuo dominio. Se il dominio è già tuo, puoi aggiungere una zona DNS Master in pochi passaggi. Per i dettagli consulta Zona DNS Master.
Il DNS dinamico aggiorna automaticamente i record A/AAAA: devi quindi crearne almeno uno. Nella pagina di gestione della zona DNS apri il menu Azioni e scegli Aggiungi record DNS, poi compila così:
@) oppure inserisci il sottodominio desideratoSalva il record, poi clicca l'icona con le due frecce nella riga del record A o AAAA. Si apre la finestra Record URL dinamico. Clicca Abilita: vengono generate le credenziali e l'URL di aggiornamento da usare negli script o nei dispositivi.
Nella finestra trovi:
www, mail) oppure il dominio per il record radice (es. tuodominio.it)tuodominio.it)Formato dell'URL (i valori reali li vedi nella finestra dopo Abilita):
https://ipv4.icbs.it/api/dynamicURL/...https://ipv6.icbs.it/api/dynamicURL/...https://ipv4.icbs.it/api/dynamicURL/{token}?host={host}&username={dominio}&password={password}
https://ipv6.icbs.it/api/dynamicURL/{token}?host={host}&username={dominio}&password={password}
Gli URL già in uso con /v1/dynamicURL/ su ipv4.icbs.it o ipv6.icbs.it continuano a funzionare (compatibilità legacy).
Aprendo l'URL dal browser o con uno script, il record viene aggiornato con l'indirizzo IP pubblico del dispositivo che effettua la richiesta: IPv4 per i record A, IPv6 per i record AAAA (usa l'URL con ipv6.icbs.it e una connessione IPv6 verso Internet). Se l'IP è già quello del record, la richiesta viene accettata senza modificare il DNS; quando l'IP cambia, l'aggiornamento compare anche in Attività dell'account.
Il DNS dinamico funziona sui principali sistemi operativi e dispositivi. Guide dedicate:
Prima di automatizzare, verifica l'URL dalla Console ICBS:
curl -fsS 'https://ipv4.icbs.it/api/dynamicURL/{token}?host={host}&username={dominio}&password={password}'
Per la risposta JSON aggiungi &response=json in coda all'URL. Altri esempi (script completi, Windows, router) sono in Esempi di script per dynamicURL.
Puoi schedulare l'aggiornamento richiamando l'URL copiato dalla Console ICBS. Esempio con wget ogni ora (sostituisci i valori con quelli della tua finestra Record URL dinamico):
0 * * * * wget -q --delete-after 'https://ipv4.icbs.it/api/dynamicURL/{token}?host={host}&username={dominio}&password={password}'
Con curl:
0 * * * * curl -fsS 'https://ipv4.icbs.it/api/dynamicURL/{token}?host={host}&username={dominio}&password={password}' > /dev/null
Racchiudi sempre l'URL tra apici singoli nel crontab. Per script completi (file .sh, systemd, PowerShell, MikroTik) vedi Esempi di script per dynamicURL.
Se l'IP non è cambiato, la risposta è in genere OK. Per una risposta strutturata puoi aggiungere il parametro opzionale response=json alla fine dell'URL:
https://ipv4.icbs.it/api/dynamicURL/{token}?host={host}&username={dominio}&password={password}&response=json
Se sul record è attivo il DNS Failover, l'aggiornamento allinea automaticamente anche l'IP principale del monitoraggio failover (non serve alcun parametro aggiuntivo nell'URL).