Questa pagina raccoglie esempi pronti per aggiornare i record DNS dinamici tramite l'endpoint dynamicURL di ICBS. Se non hai ancora abilitato il DNS dinamico sul record, segui prima Primi passi con il DNS dinamico.
Dalla finestra Record URL dinamico della Console ICBS (icona con le due frecce sul record A o AAAA) copia l'URL dinamico completo dopo Abilita, oppure componilo così:
| Record | Endpoint |
|---|---|
| A (IPv4) | https://ipv4.icbs.it/api/dynamicURL/{token}?host={host}&username={dominio}&password={password} |
| AAAA (IPv6) | https://ipv6.icbs.it/api/dynamicURL/{token}?host={host}&username={dominio}&password={password} |
/dynamicURL/www, mail, oppure il dominio per il record radice)tuodominio.it)Gli URL con /v1/dynamicURL/ restano supportati (compatibilità legacy).
Racchiudi sempre l'URL tra apici singoli negli script e nel crontab, soprattutto se la password contiene caratteri speciali.
Apri l'URL nel browser oppure da terminale:
curl -fsS 'https://ipv4.icbs.it/api/dynamicURL/{token}?host={host}&username={dominio}&password={password}'
Se l'IP non è cambiato, la risposta è in genere OK. Se l'IP è cambiato, la risposta testuale include anche le righe Previous IP, New IP e Hostname.
Risposta JSON (parametro opzionale response=json):
curl -fsS 'https://ipv4.icbs.it/api/dynamicURL/{token}?host={host}&username={dominio}&password={password}&response=json'
Esempio di risposta quando l'IP cambia:
{
"status": "success",
"host": "www.tuodominio.it",
"previousIp": "1.2.3.4",
"newIp": "5.6.7.8"
}
Per i record AAAA usa ipv6.icbs.it al posto di ipv4.icbs.it.
Salva il testo in uno script a tua scelta e incolla l'URL dalla Console al posto del segnaposto:
# Aggiornamento DNS dinamico ICBS — incolla l'URL completo dalla Console ICBS.
DYNAMIC_URL='https://ipv4.icbs.it/api/dynamicURL/{token}?host={host}&username={dominio}&password={password}'
if command -v curl >/dev/null 2>&1; then
curl -fsS "$DYNAMIC_URL"
elif command -v wget >/dev/null 2>&1; then
wget -q --delete-after "$DYNAMIC_URL"
else
echo "Serve curl o wget." >&2
exit 1
fi
Esecuzione manuale:
curl -fsS "$DYNAMIC_URL"
Se lo esegui in modo pianificato, incolla l'URL al posto di DYNAMIC_URL:
0 * * * * curl -fsS "$DYNAMIC_URL" >/dev/null 2>&1
Variante cron con URL inline (senza file script):
0 * * * * curl -fsS 'https://ipv4.icbs.it/api/dynamicURL/{token}?host={host}&username={dominio}&password={password}' >/dev/null 2>&1
*/5 * * * * wget -q --delete-after 'https://ipv4.icbs.it/api/dynamicURL/{token}?host={host}&username={dominio}&password={password}'
Se usi Windows, router, NAS o altri dispositivi, richiama lo stesso URL con il sistema di pianificazione disponibile nel tuo ambiente.
L'importante è mantenere l'URL completo generato dalla Console ICBS e usare la versione corretta per record A o AAAA.
Per aggiornare un record AAAA usa sempre l'host ipv6.icbs.it. Il client che esegue lo script deve uscire su Internet con IPv6; altrimenti l'aggiornamento viene rifiutato.
curl -fsS 'https://ipv6.icbs.it/api/dynamicURL/{token}?host={host}&username={dominio}&password={password}'
Cron (ogni ora):
0 * * * * curl -fsS 'https://ipv6.icbs.it/api/dynamicURL/{token}?host={host}&username={dominio}&password={password}' >/dev/null 2>&1