Dýnamísk DNS (DDNS)

• Dæmi
  • ddclient
  • Curl
  • Synology
  • Home Assistant
  • Unifi

Routerar og DDNS-viðskiptavinir sem styðja DynDNS2-kerfið geta notað API-ið okkar á ddns.simply.com.

Fullur skjölun er að finna hér: https://ddns.simply.com/doc/

Dæmi:

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

Fyrir skriftur og aðra sjálfvirkni DNS mælum við með REST API-ið okkar, sem getur búið til, breytt og eytt DNS-færslum.

Auðkenning fer fram með HTTP Basic Authentication, þar sem lykilorðið er API-lykillinn fyrir reikninginn. Notandanafn getur verið hvað sem er, t.d. reikningsnafnið. API-lykillinn fyrir reikning þarf að búa til í stjórnborðinu okkar.

Ef myip er sleppt, er notuð IP-vistfangið sem beiðnin kemur frá. Uppfærslur skulu gerast yfir HTTPS.

Færslan þarf að vera í DNS-svæðinu áður en hægt er að uppfæra hana: A-færsla fyrir IPv4 og AAAA-færsla fyrir IPv6. Ef hún er ekki til, svarar kerfið nohost, þannig að þú þarft að búa til færsluna í stjórnborðinu fyrst.

Breytan domain tilgreinir lénið. Hún þarf að vera með þegar sjálft lénið er uppfært, t.d. hostname=example.com&domain=example.com, og má nota þegar lénið er ekki hægt að draga af hostname.

Svörin fylgja DynDNS2-kerfinu, t.d. good við uppfærslu og nochg þegar IP-vistfangið er óbreytt.

Vistfangið https://ddns.simply.com/myip skilar opinbera IP-vistfanginu sem beiðnin kemur frá, og krefst ekki auðkenningar.

¶Dæmi

¶ddclient

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

¶Curl

Notaðu eftirfarandi Curl skipun til að setja home.example.com á ytri IP-ið fyrir biðandi biðlara:

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

Þú getur stillt þessa skipun til að keyra í crontab, á staðbundnum vél, á hverjum 15. mínútu eða þar nálægt.

¶Synology

Á Synology geturðu notað eftirfarandi setninguna sem sérsniðinn DDNS-veitanda

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

hostname þarf síðan að vera fullt skráð lén, eins og þú vilt uppfæra, t.d. home.example.com.

¶Home Assistant

Skynjarinn sækir opinbera IP-vistfangið á hverjum 5. mínútu, og sjálfvirkni uppfærir aðeins DNS þegar vistfangið breytist og þegar Home Assistant ræsir. API-lykillinn er geymdur í 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 þarftu að setja upp sérsniðinn Dynamic DNS veitu og slá inn eftirfarandi streng í reitinn „Server“.

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