Δυναμικό DNS (DDNS)

• Παραδείγματα
  • ddclient
  • Curl
  • Synology
  • Home Assistant
  • Unifi

Δρομείς και πελάτες DDNS που υποστηρίζουν το πρωτόκολλο DynDNS2, μπορούν να χρησιμοποιούν το API μας στο ddns.simply.com.

Η πλήρης τεκμηρίωση μπορεί να βρεθεί εδώ: https://ddns.simply.com/doc/

Παράδειγμα:

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

Για σενάρια και άλλον αυτοματισμό του DNS συνιστούμε το REST API μας, το οποίο μπορεί να δημιουργήσει, να τροποποιήσει και να διαγράψει εγγραφές DNS.

Η πιστοποίηση γίνεται με HTTP Basic Authentication, όπου ο κωδικός πρόσβασης είναι το κλειδί API για τον λογαριασμό. Το όνομα χρήστη μπορεί να είναι οτιδήποτε, π.χ. το όνομα του λογαριασμού. Το κλειδί API για έναν λογαριασμό πρέπει να δημιουργηθεί μέσω του Πίνακα Ελέγχου μας.

Αν παραληφθεί το myip, χρησιμοποιείται η διεύθυνση IP από την οποία προέρχεται το αίτημα. Οι ενημερώσεις πρέπει να γίνονται μέσω HTTPS.

Η εγγραφή πρέπει να υπάρχει στη ζώνη DNS πριν μπορέσει να ενημερωθεί: μια A‑record για IPv4 και μια AAAA‑record για IPv6. Αν δεν υπάρχει, επιστρέφεται nohost, οπότε δημιουργήστε την εγγραφή στον πίνακα ελέγχου πρώτα.

Η παράμετρος domain υποδεικνύει το domain. Πρέπει να συμπεριλαμβάνεται όταν ενημερώνεται το ίδιο το domain, π.χ. hostname=example.com&domain=example.com, και μπορεί να χρησιμοποιηθεί όταν το domain δεν μπορεί να εξαχθεί από το hostname.

Οι απαντήσεις ακολουθούν το πρωτόκολλο DynDNS2, π.χ. good για μια ενημέρωση και nochg όταν η διεύθυνση IP δεν έχει αλλάξει.

Η διεύθυνση https://ddns.simply.com/myip επιστρέφει τη δημόσια διεύθυνση IP από την οποία προέρχεται το αίτημα και δεν απαιτεί πιστοποίηση.

¶Παραδείγματα

¶ddclient

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

¶Curl

Χρησιμοποιήστε την παρακάτω εντολή Curl για να ορίσετε το home.example.com στην εξωτερική IP του αιτούντος πελάτη:

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

Μπορείτε να ρυθμίσετε αυτήν την εντολή να εκτελείται σε ένα crontab, σε τοπικό μηχάνημα, κάθε 15 λεπτά ή περίπου.

¶Synology

Στο Synology μπορείτε να χρησιμοποιήσετε την παρακάτω σύνταξη ως Custom DDNS Provider

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

Το hostname πρέπει στη συνέχεια να οριστεί ως το πλήρες προσδιοριστικό όνομα τομέα που θέλετε να ενημερώσετε, π.χ. home.example.com.

¶Home Assistant

Ο αισθητήρας λαμβάνει τη δημόσια διεύθυνση IP κάθε 5 λεπτά, και η αυτοματοποίηση ενημερώνει το DNS μόνο όταν η διεύθυνση αλλάζει και όταν ξεκινά το Home Assistant. Το κλειδί API αποθηκεύεται στο 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

Στο UniFi OS πρέπει να ρυθμίσετε έναν Custom Dynamic DNS provider και να εισάγετε την παρακάτω συμβολοσειρά στο πεδίο "Server".

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