Dinamikus DNS (DDNS)

• Példák
  • ddclient
  • Curl
  • Synology
  • Home Assistant
  • Unifi

Azok a routerek és DDNS-kliensek, amelyek támogatják a DynDNS2 protokollt, használhatják a mi API‑t a ddns.simply.com címen.

A teljes dokumentáció itt érhető el: https://ddns.simply.com/doc/

Példa:

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

A DNS szkriptekhez és egyéb automatizáláshoz a mi REST API‑t javasoljuk, amely képes létrehozni, módosítani és törölni DNS-rekordokat.

Az azonosítás HTTP Basic Authentication‑nel történik, ahol a jelszó a fiók API‑kulcsa. A felhasználónév lehet bármi, például a fiók neve. Egy fiók API‑kulcsát a mi Vezérlőpultunkon kell létrehozni.

Ha a myip el van hagyva, akkor a kérés forrás IP-címe lesz használva. A frissítéseket HTTPS‑en kell végezni.

A rekordnak léteznie kell a DNS-zónában, mielőtt frissíthető lenne: egy A-rekord IPv4-hez és egy AAAA-rekord IPv6-hoz. Ha nem létezik, a válasz nohost, ezért először hozza létre a rekordot a vezérlőpultban.

A domain paraméter a domaint adja meg. Ezt akkor kell elküldeni, amikor a domain frissül, például hostname=example.com&domain=example.com, és akkor is használható, ha a domain nem vonható le a hostname‑ből.

A válaszok a DynDNS2 protokollt követik, például good egy frissítésnél és nochg, ha az IP-cím változatlan.

A https://ddns.simply.com/myip cím visszaadja a nyilvános IP-címet, amelyből a kérés érkezik, és nem igényel azonosítást.

¶Példák

¶ddclient

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

¶Curl

Használja a következő Curl parancsot a home.example.com beállításához a kérő kliens külső IP-címére:

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

Beállíthatja ezt a parancsot, hogy crontab‑ban fusson egy helyi gépen, körülbelül 15 percenként.

¶Synology

Synology‑n a következő szintaxist használhatja egyéni DDNS szolgáltatóként

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

A hostname ezután a teljesen kvalifikált domainnévként kell megadni, amelyet frissíteni szeretne, például home.example.com.

¶Home Assistant

Az érzékelő 5 percenként lekéri a nyilvános IP-címet, és az automatizálás csak akkor frissíti a DNS‑t, ha a cím megváltozik, illetve amikor a Home Assistant elindul. Az API‑kulcs a secrets.yaml‑ban van tárolva.

# 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

Az UniFi OS‑ben be kell állítania egy egyéni Dynamic DNS szolgáltatót, és a „Server” mezőbe a következő karakterláncot kell beírni.

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