Dinamik DNS (DDNS)

• Örnekler
  • ddclient
  • Curl
  • Synology
  • Home Assistant
  • Unifi

Router ve DynDNS2 protokolünü destekleyen DDNS istemcileri, ddns.simply.com üzerindeki API'mizi kullanabilir.

Tam dokümantasyon burada bulunabilir: https://ddns.simply.com/doc/

Örnek:

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

DNS için betikler ve diğer otomasyonlarda, DNS kayıtlarını oluşturabilen, değiştirebilen ve silebilen REST API'mizi öneriyoruz.

Kimlik doğrulama, hesabın API anahtarı şifre olarak kullanılan HTTP Basic Authentication ile yapılır. Kullanıcı adı herhangi bir şey olabilir, örneğin hesap adı. Bir hesabın API anahtarı Kontrol Panelimiz üzerinden oluşturulmalıdır.

myip parametresi atlanırsa, isteğin geldiği IP adresi kullanılır. Güncellemeler HTTPS üzerinden yapılmalıdır.

Kayıt, güncellenmeden önce DNS bölgesinde bulunmalıdır: IPv4 için bir A kaydı ve IPv6 için bir AAAA kaydı. Eğer bulunmazsa, nohost yanıtı verilir, bu yüzden önce kontrol panelinde kaydı oluşturun.

domain parametresi alanı belirtir. Alan adı güncellenirken gönderilmelidir, örneğin hostname=example.com&domain=example.com, ve hostname üzerinden türetilmesi mümkün olmadığında kullanılabilir.

Yanıtlar DynDNS2 protokolüne uyar, örneğin bir güncellemede good ve IP adresi değişmediğinde nochg.

https://ddns.simply.com/myip adresi, isteğin geldiği genel IP adresini döndürür ve kimlik doğrulama gerektirmez.

¶Örnekler

¶ddclient

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

¶Curl

İsteği yapan istemcinin dış IP'sini home.example.com olarak ayarlamak için aşağıdaki Curl komutunu kullanın:

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

Bu komutu bir crontab içinde, yerel bir makinede, her 15 dakikada bir veya benzer bir sıklıkta çalışacak şekilde ayarlayabilirsiniz.

¶Synology

Synology'de Custom DDNS Provider olarak aşağıdaki sözdizimini kullanabilirsiniz

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

hostname daha sonra güncellemek istediğiniz tam nitelikli alan adı olarak belirtilmelidir, örneğin home.example.com.

¶Home Assistant

Sensör her 5 dakikada bir genel IP adresini alır ve otomasyon, adres değiştiğinde ve Home Assistant başlatıldığında yalnızca DNS'i günceller. API anahtarı secrets.yaml içinde saklanır.

# 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

UniFi OS'de bir Custom Dynamic DNS sağlayıcı ayarlamalı ve "Server" alanına aşağıdaki dizeyi girmelisiniz.

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