DNS Dinâmico (DDNS)

• Exemplos
  • ddclient
  • Curl
  • Synology
  • Home Assistant
  • Unifi

Roteadores e clientes DDNS que suportam o protocolo DynDNS2 podem usar a nossa API em ddns.simply.com.

A documentação completa pode ser encontrada aqui: https://ddns.simply.com/doc/

Exemplo:

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

Para scripts e outras automações de DNS recomendamos a nossa API REST, que pode criar, alterar e eliminar registos DNS.

A autenticação é feita com HTTP Basic Authentication, onde a palavra‑passe é a chave API da conta. O nome de utilizador pode ser qualquer coisa, por exemplo o nome da conta. A chave API de uma conta deve ser criada através do nosso Painel de Controlo.

Se o parâmetro myip for omitido, será usado o endereço IP de onde a solicitação provém. As atualizações devem ser feitas via HTTPS.

O registo deve existir na zona DNS antes de poder ser atualizado: um registo A para IPv4 e um registo AAAA para IPv6. Se não existir, a resposta será nohost, portanto crie o registo no painel de controlo primeiro.

O parâmetro domain indica o domínio. Deve ser enviado quando o próprio domínio é atualizado, por exemplo hostname=example.com&domain=example.com, e pode ser usado quando o domínio não pode ser inferido a partir de hostname.

As respostas seguem o protocolo DynDNS2, por exemplo good para uma atualização e nochg quando o endereço IP não mudou.

O endereço https://ddns.simply.com/myip devolve o endereço IP público de onde a solicitação provém e não requer autenticação.

¶Exemplos

¶ddclient

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

¶Curl

Use o seguinte comando Curl para definir home.example.com para o IP externo do cliente que faz a solicitação:

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

Pode programar este comando para ser executado numa crontab, numa máquina local, a cada 15 minutos ou aproximadamente.

¶Synology

No Synology pode usar a seguinte sintaxe como Provedor DDNS Personalizado

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

hostname deve então ser especificado como o nome de domínio totalmente qualificado que deseja atualizar, por exemplo home.example.com.

¶Home Assistant

O sensor obtém o endereço IP público a cada 5 minutos, e a automação atualiza o DNS apenas quando o endereço muda e quando o Home Assistant inicia. A chave API é guardada em 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

No UniFi OS deve configurar um provedor Dynamic DNS Personalizado e inserir a seguinte cadeia no campo "Server" campo.

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