Dynamiczny DNS (DDNS)

• Przykłady
  • ddclient
  • Curl
  • Synology
  • Home Assistant
  • Unifi

Routery i klienci DDNS obsługujący protokół DynDNS2 mogą korzystać z naszego API pod adresem ddns.simply.com.

Pełna dokumentacja jest dostępna tutaj: https://ddns.simply.com/doc/

Przykład:

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

Do skryptów i innej automatyzacji DNS zalecamy nasze REST API, które może tworzyć, modyfikować i usuwać rekordy DNS.

Uwierzytelnianie odbywa się przy użyciu HTTP Basic Authentication, gdzie hasłem jest klucz API konta. Nazwa użytkownika może być dowolna, np. nazwa konta. Klucz API dla konta należy utworzyć w naszym Panelu kontrolnym.

Jeśli pominięto parametr myip, używany jest adres IP, z którego pochodzi żądanie. Aktualizacje muszą odbywać się przez HTTPS.

Rekord musi znajdować się w strefie DNS, zanim będzie można go zaktualizować: rekord A dla IPv4 i rekord AAAA dla IPv6. Jeśli nie istnieje, zwracane jest nohost, więc najpierw utwórz rekord w panelu kontrolnym.

Parametr domain określa domenę. Należy go przesłać, gdy aktualizowana jest sama domena, np. hostname=example.com&domain=example.com, i może być użyty, gdy domena nie może być wyprowadzona z hostname.

Odpowiedzi są zgodne z protokołem DynDNS2, np. good przy aktualizacji oraz nochg, gdy adres IP nie uległ zmianie.

Adres https://ddns.simply.com/myip zwraca publiczny adres IP, z którego pochodzi żądanie i nie wymaga uwierzytelnienia.

¶Przykłady

¶ddclient

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

¶Curl

Użyj następującego polecenia Curl, aby ustawić home.example.com na zewnętrzny adres IP żądającego klienta:

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

Możesz skonfigurować to polecenie do uruchamiania w crontabie, na lokalnym komputerze, co 15 minut lub w przybliżeniu.

¶Synology

W Synology możesz użyć następującej składni jako własnego dostawcy DDNS

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

hostname powinien być podany jako pełna kwalifikowana nazwa domeny, którą chcesz zaktualizować, np. home.example.com.

¶Home Assistant

Czujnik pobiera publiczny adres IP co 5 minut, a automatyzacja aktualizuje DNS tylko wtedy, gdy adres się zmieni i przy uruchomieniu Home Assistant. Klucz API jest przechowywany w 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

W UniFi OS należy skonfigurować własnego dostawcę Dynamic DNS i wprowadzić następujący ciąg w polu „Server”.

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