Dinámico DNS (DDNS)

• Ejemplos
  • ddclient
  • Curl
  • Synology
  • Home Assistant
  • Unifi

Los routers y clientes DDNS que soportan el protocolo DynDNS2 pueden usar nuestra API en ddns.simply.com.

La documentación completa se puede encontrar aquí: https://ddns.simply.com/doc/

Ejemplo:

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

Para scripts y otras automatizaciones de DNS recomendamos nuestra API REST, que puede crear, modificar y eliminar registros DNS.

La autenticación se realiza con HTTP Basic Authentication, donde la contraseña es la clave API de la cuenta. El nombre de usuario puede ser cualquiera, por ejemplo el nombre de la cuenta. La clave API para una cuenta debe crearse a través de nuestro Panel de Control.

Si se omite myip, se utiliza la dirección IP desde la que proviene la solicitud. Las actualizaciones deben realizarse a través de HTTPS.

El registro debe existir en la zona DNS antes de poder actualizarse: un registro A para IPv4 y un registro AAAA para IPv6. Si no existe, se responde con nohost, así que crea el registro en el panel de control primero.

El parámetro domain indica el dominio. Debe enviarse cuando se actualiza el propio dominio, por ejemplo hostname=example.com&domain=example.com, y puede usarse cuando el dominio no se puede deducir del hostname.

Las respuestas siguen el protocolo DynDNS2, por ejemplo good tras una actualización y nochg cuando la dirección IP no ha cambiado.

La dirección https://ddns.simply.com/myip devuelve la dirección IP pública desde la que proviene la solicitud y no requiere autenticación.

¶Ejemplos

¶ddclient

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

¶Curl

Utiliza el siguiente comando Curl para establecer home.example.com a la IP externa del cliente solicitante:

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

Puedes programar este comando para que se ejecute en una crontab, en una máquina local, cada 15 minutos o aproximadamente.

¶Synology

En Synology puedes usar la siguiente sintaxis como proveedor DDNS personalizado

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

hostname debe especificarse a continuación como el nombre de dominio totalmente cualificado que deseas actualizar, por ejemplo home.example.com.

¶Home Assistant

El sensor obtiene la dirección IP pública cada 5 minutos, y la automatización actualiza DNS solo cuando la dirección cambia y cuando Home Assistant se inicia. La clave API se guarda en 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

En UniFi OS debes configurar un proveedor Dynamic DNS personalizado e introducir la siguiente cadena en el campo "Server" campo.

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