Довідка та інструкції
Інструкції з налаштування роутерів, DNS-провайдерів та API.
Перші кроки
- Створіть обліковий запис і підтвердьте свою адресу електронної пошти.
- У панелі керування перейдіть до Імена хостів → Створити і додайте субдомен на кшталт
myhouse.dnsfollowme.uk. - На вкладці API-ключі створіть API-ключ (напр. «Fritz!Box у вітальні») і надійно збережіть його — він показується лише один раз.
- Налаштуйте свій роутер згідно з розділом Налаштування роутера — використайте API-ключ як пароль.
Налаштування роутера
Волієте встановити програму на сам пристрій, а не налаштовувати роутер? Саме для цього існують нативні клієнти.
IPv4 чи IPv6?
Значення вище оновлюють адресу IPv4 (запис A) — звичайний випадок для підключень із власною публічною IPv4. Для IPv6 (запис AAAA) пристрій додатково або замість цього надсилає параметр &myipv6=<IPv6>. Як це зробити на цьому пристрої, описано в рядку «IPv6» таблиці.
DS-Lite або CGNAT (багато кабельних і оптоволоконних підключень): роутер тоді не має публічної IPv4, а приватну WAN-адресу сервіс відхиляє з відповіддю «abuse». У такому разі надсилайте лише myipv6 — або використовуйте клієнт DNS Beacon безпосередньо на цільовому пристрої, який сам визначає обидва сімейства адрес.
Fritz!Box (AVM)
Internet → Permit Access → DynDNS
- Провайдер:
- Custom
- URL оновлення:
- https://api.dnsbeacon.com/nic/update?hostname=<domain>&myip=<ipaddr>
- Доменне ім'я:
- myhouse.dnsfollowme.uk
- Ім'я користувача:
- ваша адреса електронної пошти
- Пароль:
- ваш API-ключ
- IPv6:
- Заповнювач <ip6addr>. Dual stack: додайте &myipv6=<ip6addr> до URL оновлення. DS-Lite: надсилайте лише ?hostname=<domain>&myipv6=<ip6addr>, без <ipaddr>.
Synology NAS
Control Panel → External Access → DDNS → Add
- Провайдер:
- Custom
- Ім'я хоста:
- myhouse.dnsfollowme.uk
- Ім'я користувача:
- ваша адреса електронної пошти
- Пароль:
- ваш API-ключ
- URL сервера:
- https://api.dnsbeacon.com/nic/update?hostname=__HOSTNAME__&myip=__MYIP__
- IPv6:
- DSM 7: заповнювач __MYIPV6__ — додайте &myipv6=__MYIPV6__ до URL сервера (за DS-Lite приберіть &myip=__MYIP__). Старіші версії DSM цього заповнювача не знають.
Ubiquiti UniFi
Settings → Internet → WAN → Dynamic DNS
- Сервіс:
- custom (або dyndns)
- Ім'я хоста:
- myhouse.dnsfollowme.uk
- Ім'я користувача:
- ваша адреса електронної пошти
- Пароль:
- ваш API-ключ
- Сервер:
- api.dnsbeacon.com/nic/update?hostname=%h&myip=%i
- IPv6:
- Лише IPv4 – UniFi OS не підтримує оновлення AAAA. Для IPv6 використовуйте клієнт DNS Beacon безпосередньо на цільовому пристрої.
Примітка: UniFi надсилає оновлення лише тоді, коли WAN-IP справді змінюється. Щоб примусово оновити, вимкніть конфігурацію DynDNS, збережіть, знову увімкніть, збережіть.
Докладна інструкція з налаштування →pfSense / OPNsense
Services → Dynamic DNS → Add
- Тип сервісу:
- Custom
- URL оновлення:
- https://api.dnsbeacon.com/nic/update?hostname=%h&myip=%IP%
- Ім'я хоста:
- myhouse.dnsfollowme.uk
- Ім'я користувача:
- ваша адреса електронної пошти
- Пароль:
- ваш API-ключ
- IPv6:
- Додайте другий запис із Service Type «Custom (v6)», використовуючи в його URL оновлення &myipv6=%IP% замість &myip=%IP%.
OpenWrt
Services → Dynamic DNS
- Провайдер:
- -- custom --
- URL оновлення:
- https://api.dnsbeacon.com/nic/update?hostname=[DOMAIN]&myip=[IP]
- Доменне ім'я:
- myhouse.dnsfollowme.uk
- Ім'я користувача:
- ваша адреса електронної пошти
- Пароль:
- ваш API-ключ
- IPv6:
- Додайте другу конфігурацію DDNS із версією IP-адреси IPv6 (use_ipv6), використовуючи в її URL оновлення &myipv6=[IP] замість &myip=[IP].
Спершу встановіть пакет luci-app-ddns (System → Software або opkg install luci-app-ddns ddns-scripts). OpenWrt автоматично підставляє [DOMAIN] та [IP] в URL.
Докладна інструкція з налаштування →OPNsense
Services → Dynamic DNS → Settings
- Тип сервісу:
- Custom
- Сервер:
- api.dnsbeacon.com
- Ім'я користувача:
- ваша адреса електронної пошти
- Пароль:
- ваш API-ключ
- Ім'я хоста:
- myhouse.dnsfollowme.uk
- IPv6:
- Додайте другий обліковий запис лише для IPv6: встановіть «Check ip method» на IPv6-сервіс і ввімкніть «Allow IPv6» у General Settings.
Спершу встановіть плагін os-ddclient (System → Firmware → Plugins) і виберіть сервіс Custom — він надсилає стандартні оновлення DynDNS2 на /nic/update.
Докладна інструкція з налаштування →DD-WRT
Services → DDNS
- Сервіс:
- Custom
- Сервер:
- api.dnsbeacon.com
- URL оновлення:
- /nic/update?hostname=
- Ім'я хоста:
- myhouse.dnsfollowme.uk
- Ім'я користувача:
- ваша адреса електронної пошти
- Пароль:
- ваш API-ключ
- IPv6:
- Лише IPv4 – інтерфейс DDNS надсилає лише IPv4; для IPv6 знадобився б власний cron-скрипт. Для IPv6 використовуйте клієнт DNS Beacon безпосередньо на цільовому пристрої.
Встановіть для DDNS Service значення Custom. DD-WRT автоматично додає ваше ім'я хоста та поточну IP до URL.
Докладна інструкція з налаштування →TP-Link Omada
Settings → Services → Dynamic DNS (або Device Config → DNS → Dynamic DNS)
- Service Provider:
- Custom
- Update URL:
- https://api.dnsbeacon.com/nic/update?hostname=[DOMAIN]&myip=[IP]
- Domain Name:
- myhouse.dnsfollowme.uk
- Username:
- ваша адреса електронної пошти
- Password:
- ваш API-ключ
- IPv6:
- Лише IPv4 – DDNS Omada поки не підтримує оновлення IPv6. Для IPv6 використовуйте клієнт DNS Beacon безпосередньо на цільовому пристрої.
Працює з Omada Controller v5+ і прошивками шлюзів, що мають пункт Custom DDNS (ER605, ER7206 тощо). Виберіть «Custom» як Service Provider і створіть новий запис Dynamic DNS — Omada автоматично підставляє [DOMAIN], [IP], [USERNAME] та [PASSWORD] в URL.
Докладна інструкція з налаштування →Aruba Instant
Configuration → Services → Dynamic DNS
- Provider:
- DynDNS
- URL:
- https://api.dnsbeacon.com/nic/update?hostname=<h>&myip=<a>
- Hostname:
- myhouse.dnsfollowme.uk
- Username:
- ваша адреса електронної пошти
- Password:
- ваш API-ключ
- IPv6:
- Лише IPv4 – Aruba Instant On не підтримує DDNS з IPv6. Для IPv6 використовуйте клієнт DNS Beacon безпосередньо на цільовому пристрої.
Aruba Instant (ArubaOS 8.x+) підтримує власні профілі Dynamic DNS. У вебінтерфейсі або через CLI (`dynamic-dns` / `ddns-profile`) встановіть провайдера «DynDNS» і перевизначте URL, щоб оновлення йшли на API DNS Beacon. Aruba підставляє <h> замість імені хоста та <a> замість поточної IP.
Докладна інструкція з налаштування →LANCOM
Communication → General → Action Table (LANconfig)
- Дія (URL):
- https://api.dnsbeacon.com/nic/update?hostname=%h&myip=%a
- Ім'я хоста:
- myhouse.dnsfollowme.uk
- Ім'я користувача:
- ваша адреса електронної пошти
- Пароль:
- ваш API-ключ
- IPv6:
- Заповнювач %z. Dual stack: додайте &myipv6=%z до URL дії. DS-Lite: використовуйте лише ?hostname=%h&myipv6=%z.
У LANconfig, у Communication → General → Action Table, створіть нову дію, що спрацьовує на «Established» / зміну IP. LANCOM підставляє %h замість імені хоста та %a замість поточної IPv4 (для IPv6 використовуйте %z). Вбудуйте свої облікові дані в URL як `https://<username>:<API key>@…`.
Докладна інструкція з налаштування →DrayTek Vigor
Applications → Dynamic DNS Setup
- Service Provider:
- User-Defined
- Provider Host:
- api.dnsbeacon.com
- Service API:
- /nic/update?hostname=myhouse.dnsfollowme.uk&myip=###IP###
- Domain Name:
- myhouse.dnsfollowme.uk
- Login Account:
- ваша адреса електронної пошти
- Пароль:
- ваш API-ключ
- IPv6:
- Лише IPv4 – Customized DDNS через ###IP### надає лише WAN-IPv4. Для IPv6 використовуйте клієнт DNS Beacon безпосередньо на цільовому пристрої.
Виберіть «User-Defined» як Service Provider. DrayTek автоматично підставляє ###IP### замість поточної WAN-IP; Login Account і пароль надсилаються як HTTP basic auth на /nic/update. Якщо роутер підключено до інтернету напряму, встановіть «Determine Real WAN IP» у «WAN IP».
Докладна інструкція з налаштування →Ubiquiti EdgeRouter
CLI (configure) — або GUI: Services → DNS → Dynamic DNS
- Протокол:
- dyndns2
- Server:
- api.dnsbeacon.com
- Hostname:
- myhouse.dnsfollowme.uk
- Login:
- ваша адреса електронної пошти
- Пароль:
- ваш API-ключ
- IPv6:
- Лише IPv4 – ddclient у складі EdgeOS ненадійно обробляє оновлення AAAA. Для IPv6 використовуйте клієнт DNS Beacon безпосередньо на цільовому пристрої.
EdgeOS використовує ddclient. У CLI: `set service dns dynamic interface eth0 service custom-dnsbeacon protocol dyndns2`, потім `server <API host>`, `host-name <hostname>`, `login <email>`, `password <API key>` — далі `commit; save`. Замініть eth0 на свій WAN-інтерфейс.
Докладна інструкція з налаштування →FortiGate
Network → DNS → Dynamic DNS
- Server:
- genericDDNS
- Адреса сервера:
- api.dnsbeacon.com
- Domain:
- myhouse.dnsfollowme.uk
- Ім'я користувача:
- ваша адреса електронної пошти
- Пароль:
- ваш API-ключ
- IPv6:
- FortiOS 7.0+: додайте другий запис DDNS із server-type ipv6 та addr-type ipv6.
FortiOS від версії 6.x підтримує тип сервера «genericDDNS», який викликає стандартний ендпоінт DynDNS2 /nic/update на будь-якому вказаному вами сервері. У CLI: `config system ddns` → `set ddns-server genericDDNS`, `set ddns-server-addr` з адресою API, `set ddns-domain` з вашим іменем хоста, `ddns-username` / `ddns-password` для автентифікації. Встановіть monitor-interface на свій WAN-інтерфейс.
Докладна інструкція з налаштування →bintec elmeg
Local Services → DynDNS Client → DynDNS Provider → New
- Server:
- api.dnsbeacon.com
- Update URL:
- /nic/update?hostname=<domain>&myip=<ipaddr>
- Hostname:
- myhouse.dnsfollowme.uk
- Ім'я користувача:
- ваша адреса електронної пошти
- Пароль:
- ваш API-ключ
- IPv6:
- Починаючи з прошивки 10.2.5 клієнт DynDNS повідомляє й IPv6 (зокрема DS-Lite) — увімкніть опцію IPv6 у записі провайдера; заповнювач згідно з довідкою прошивки.
У Local Services → DynDNS Client → DynDNS Provider створіть нового провайдера з цим сервером та URL оновлення. bintec підставляє <domain> замість імені хоста та <ipaddr> замість поточної WAN-IP; ім'я користувача й пароль надсилаються для автентифікації. Потім виберіть цього провайдера в реєстрації DynDNS.
Докладна інструкція з налаштування →Zyxel USG FLEX / ATP
Configuration → System → DDNS
- DDNS Provider:
- User customize
- Server / Host:
- api.dnsbeacon.com
- URL:
- /nic/update?hostname=<domain>&myip=<ipaddr>
- Domain Name:
- myhouse.dnsfollowme.uk
- Username:
- ваша адреса електронної пошти
- Password:
- ваш API-ключ
- IPv6:
- Лише IPv4 – функція DDNS у ZLD повідомляє лише IPv4 WAN-інтерфейсу. Для IPv6 використовуйте клієнт DNS Beacon безпосередньо на цільовому пристрої.
Виберіть «User customize» як DDNS Provider. Zyxel підставляє <domain> замість Domain Name та <ipaddr> замість WAN-IP; Username і Password надсилаються для автентифікації на /nic/update. Кінцевий «?» в URL обов'язковий.
Докладна інструкція з налаштування →Peplink Balance
Network → WAN → [з'єднання] → Dynamic DNS Settings
- Service:
- custom (User-defined)
- Server:
- api.dnsbeacon.com
- Hostname:
- myhouse.dnsfollowme.uk
- Username:
- ваша адреса електронної пошти
- Password:
- ваш API-ключ
- IPv6:
- Лише IPv4 – DDNS Peplink не повідомляє IPv6-адреси. Для IPv6 використовуйте клієнт DNS Beacon безпосередньо на цільовому пристрої.
Починаючи з прошивки 6.3 у Dynamic DNS Settings можна вказати власний DDNS-сервер. Опція custom використовує протокол DynDNS — введіть хост API як сервер. Ім'я користувача — ваш email, пароль — API-ключ.
Докладна інструкція з налаштування →VyOS
CLI (configure)
- Протокол:
- dyndns2
- Server:
- api.dnsbeacon.com
- Hostname:
- myhouse.dnsfollowme.uk
- Login:
- ваша адреса електронної пошти
- Пароль:
- ваш API-ключ
- IPv6:
- VyOS 1.4+: створіть окремий блок name для IPv6 (напр. dnsbeacon6) і додатково встановіть у ньому ip-version ipv6.
У CLI: `set service dns dynamic name dnsbeacon protocol dyndns2`, потім `server <API host>`, `host-name <hostname>`, `username <email>`, `password <API key>`, `address interface eth0` — далі `commit; save`. У VyOS 1.2/1.3 шлях — `service dns dynamic interface eth0 service …`.
Докладна інструкція з налаштування →MikroTik RouterOS
System → Scripts і System → Scheduler (WinBox або термінал)
- WAN-інтерфейс:
- інтерфейс із публічною IP, напр. ether1 або pppoe-out1 (у скрипті замініть ether1)
- Hostname:
- myhouse.dnsfollowme.uk
- Ім'я користувача:
- ваша адреса електронної пошти (<email> у скрипті)
- Пароль:
- ваш API-ключ (<api-key> у скрипті)
- Скрипт, рядок 1:
- :local a [/ip address get [find interface=ether1] address]; :local ip [:pick $a 0 [:find $a "/"]]
- Скрипт, рядок 2:
- :local r [/tool fetch url="https://api.dnsbeacon.com/nic/update?hostname=myhouse.dnsfollowme.uk&myip=$ip" user="<email>" password="<api-key>" output=user as-value]; :log info ("dnsbeacon: " . ($r->"data"))
- Scheduler:
- /system scheduler add name=dnsbeacon interval=5m on-event=dnsbeacon policy=read,write,test
- IPv6:
- У рядку 1 замініть /ip address на /ipv6 address, а [find interface=ether1] на [find interface=ether1 global]; у рядку 2 надсилайте &myipv6=$ip замість &myip=$ip.
RouterOS не має вбудованого клієнта DynDNS2 — IP Cloud працює лише з власним сервісом MikroTik. Тому оновлення виконує скрипт із двох рядків: рядок 1 зчитує IP WAN-інтерфейсу, рядок 2 викликає /nic/update через /tool fetch з HTTP basic-автентифікацією та записує відповідь у журнал. У DSL/PPPoE WAN-інтерфейс зазвичай називається pppoe-out1. За CGNAT/DS-Lite WAN-IP приватна й через IPv4 усе одно недоступна — тоді надсилайте myipv6 із глобальною IPv6-адресою. Стосується RouterOS 7 (та 6.45+).
Докладна інструкція з налаштування →Інші пристрої (сумісні з DynDNS2)
Будь-який пристрій, що підтримує DynDNS2, працює з такими значеннями:
- URL оновлення:
- https://api.dnsbeacon.com/nic/update?hostname=<host>&myip=<ip>
- Автентифікація:
- Basic Auth (email / API-ключ)
- IPv6 (необов'язково):
- додатковий параметр &myipv6=<ipv6>
Нативні клієнти оновлення
БетаЛегкий клієнт оновлення, що працює безпосередньо на пристрої — ідеально для ноутбуків, робочих станцій і серверів, які мають повідомляти свою публічну IP-адресу без DynDNS-конфігурації на роутері. Доступний для Windows, macOS і Linux.
- ✓Стан з першого погляду — іконка в треї на Windows, значок у смузі меню на macOS, команда dnsbeacon-client status на Linux: час останнього оновлення, повідомлена IP, наступний запуск.
- ✓Автозапуск під час завантаження, без ручного запуску; оновлення виконуються у фоні.
- ✓Розпізнає IPv4 та IPv6 окремо й може паралельно підтримувати обидві сім'ї адрес в актуальному стані.
- ✓Підписані інсталятори: MSI для Windows, нотаризований pkg для macOS (універсальний). Для Linux — deb, rpm або статичний бінарник для x86-64, ARM64 та ARMv7.
Усі три клієнти доступні в панелі керування в розділі «Завантаження»; інструкції нижче крок за кроком проводять через налаштування.
Клієнт для Windows
значок у треї → Налаштування
- Встановлення:
- завантажте MSI зі сторінки завантажень (панель керування → Завантаження) і встановіть його
- Ім'я хоста:
- myhouse.dnsfollowme.uk
- API-ключ:
- ключ dyndns_… з панелі керування (введення маскується)
- Інтервал:
- хвилини між перевірками IP (типово 5)
- IPv4 (A):
- прапорець «Оновлювати IPv4 (A)» — типово увімкнено
- IPv6 (AAAA):
- прапорець «Оновлювати IPv6 (AAAA)» — зніміть IPv4 для лише IPv6 (DS-Lite)
- Служба:
- служба Windows оновлює навіть без активного сеансу користувача
API-ключ — це ключ dyndns_… з панелі керування; паролі облікових записів сервер відхиляє. Служба оновлює себе автоматично; застосунок у треї показує стан і останню IP.
Докладна інструкція з налаштування →Клієнт для macOS
Термінал
- Встановлення:
- завантажте pkg зі сторінки завантажень (панель керування → Завантаження) і встановіть подвійним кліком
- Налаштування:
- sudo dnsbeacon-client configure --hostname myhouse.dnsfollowme.uk
- --hostname <fqdn>:
- ім'я хоста, яке підтримуватиметься актуальним
- --interval <min>:
- хвилини між перевірками IP (типово 5)
- --ipv4 / --no-ipv4:
- оновлювати IPv4 (A-запис) — типово увімкнено
- --ipv6 / --no-ipv6:
- оновлювати IPv6 (AAAA-запис) — типово вимкнено; --no-ipv4 --ipv6 для лише IPv6 (напр. DS-Lite)
- --api-key-stdin:
- читати API-ключ зі stdin (для скриптів); без цієї опції з'являється прихований запит
- Застосувати:
- sudo launchctl kickstart -k system/com.dnsbeacon.client
- Перевірити:
- dnsbeacon-client status або sudo dnsbeacon-client once --force
- Журнал:
- /Library/Logs/DynDnsClient/daemon.log
API-ключ — це ключ dyndns_… з панелі керування; паролі облікових записів сервер відхиляє. Після встановлення значок «DNS Beacon» у смузі меню показує стан; демон працює як служба launchd навіть без активного сеансу користувача та оновлює себе сам.
Докладна інструкція з налаштування →Клієнт для Linux
Термінал
- Встановлення:
- завантажте пакет зі сторінки завантажень (панель керування → Завантаження): sudo dpkg -i dnsbeacon-client_*.deb, sudo rpm -i dnsbeacon-client-*.rpm або sudo sh install.sh з tarball-а
- Налаштування:
- sudo dnsbeacon-client configure --hostname myhouse.dnsfollowme.uk
- --hostname <fqdn>:
- ім'я хоста, яке підтримуватиметься актуальним
- --interval <min>:
- хвилини між перевірками IP (типово 5)
- --ipv4 / --no-ipv4:
- оновлювати IPv4 (A-запис) — типово увімкнено
- --ipv6 / --no-ipv6:
- оновлювати IPv6 (AAAA-запис) — типово вимкнено; --no-ipv4 --ipv6 для лише IPv6 (напр. DS-Lite)
- --api-key-stdin:
- читати API-ключ зі stdin (для скриптів); без цієї опції з'являється прихований запит
- Застосувати:
- sudo systemctl restart dnsbeacon-client
- Перевірити:
- dnsbeacon-client status або sudo dnsbeacon-client once --force
- Журнал:
- journalctl -u dnsbeacon-client -f
API-ключ — це ключ dyndns_… з панелі керування; паролі облікових записів сервер відхиляє. Клієнт працює як служба systemd під root і оновлює з моменту завантаження навіть без активного сеансу користувача. Він підтримує себе актуальним тим самим шляхом, яким був установлений (dpkg, rpm або заміна бінарника). Для систем без dpkg/rpm — Alpine, Arch, прошивки NAS — є tarball з install.sh; бінарник статично злінкований і не має залежностей.
Докладна інструкція з налаштування →Власний домен
Ви можете підключити домен, який самостійно розміщуєте в одного з підтримуваних DNS-провайдерів. Ваш API-токен зберігається зашифрованим (AES-256-GCM) і використовується лише для оновлення DNS-записів цього домену.
Cloudflare
Передумова: домен делеговано на Cloudflare (неймсервери вказують на Cloudflare).
- На dash.cloudflare.com/profile/api-tokens створіть токен.
- Використайте шаблон «Edit zone DNS» — дозволи:
Zone:DNS:Edit. - У розділі Zone Resources оберіть або Specific zone → your-domain.com, або All zones.
- Скопіюйте токен і вставте його в панелі керування в Домени → Додати домен.
Hetzner DNS
Передумова: домен налаштовано як зону в Hetzner DNS Console.
- На dns.hetzner.com/settings/api-token створіть API-токен.
- Скопіюйте токен — він показується лише один раз.
- У панелі керування в Домени → Додати домен оберіть провайдера «Hetzner DNS» і вставте токен.
united-domains
Передумова: для зони в united-domains увімкнено платний додаток DNS API. Без нього токен не повертає жодних зон.
- Замовте додаток DNS API у портфоліо united-domains.
- Згенеруйте API-ключ у своєму клієнтському кабінеті.
- У панелі керування в Домени → Додати домен оберіть провайдера «united-domains» і вставте ключ.
Ліміт запитів: 1 200 запитів/год на токен.
IONOS
Передумова: домен у вашому обліковому записі IONOS, а доступ до API увімкнено в порталі розробника.
- Відкрийте developer.hosting.ionos.de/keys і створіть нову пару ключів (публічний префікс + секрет).
- Скопіюйте об'єднаний токен у форматі «<prefix>.<secret>» — він показується лише один раз.
- У панелі керування в Домени → Додати домен оберіть провайдера «IONOS» і вставте об'єднаний токен.
Записи TXT підтримуються — сертифікати Let's Encrypt через DNS-01 працюють для зон, розміщених в IONOS.
INWX
Передумова: домен у вашому обліковому записі INWX.
- Увійдіть у клієнтський кабінет INWX і створіть API-субкористувача без 2FA у розділі «Account → User management».
- Занотуйте ім'я користувача та пароль субкористувача.
- У панелі керування в Домени → Додати домен оберіть провайдера «INWX» і введіть ім'я користувача та пароль.
Важливо: вхід до API INWX не працює, коли на обліковому записі увімкнено 2FA через Mobile-TAN. Створіть для цього окремого субкористувача без 2FA — ваш основний обліковий запис може (і має) залишити 2FA увімкненою.
netcup
Передумова: домен керується через ваш обліковий запис netcup.
- У netcup Customer Control Panel у розділі «Stammdaten ändern → API» створіть нову пару API-ключів.
- Занотуйте номер клієнта, API-ключ та API-пароль (пароль показується лише один раз).
- У панелі керування в Домени → Додати домен оберіть провайдера «netcup» і вставте всі три значення.
Примітка: API netcup працює на рівні наборів записів (кожна зміна замінює весь набір записів). Якщо ви редагуєте DNS-записи вручну в CCP саме в той момент, коли ми встановлюємо TXT-запис Let's Encrypt, одна зі змін може загубитися. Для звичайного трафіку (оновлення DynDNS, поновлення сертифікатів) це не проблема.
OVHcloud
Передумова: домен у вашому обліковому записі OVHcloud, і ви використовуєте європейський ендпоінт (eu.api.ovh.com).
- Створіть новий API-застосунок на ovh.com/auth/api/createApp — ви отримаєте application key та application secret.
- Відкрийте OVH Token Maker, введіть application key і secret та згенеруйте consumer key.
- Важливо: надайте consumer key такі права (GET, POST, PUT, DELETE — кожне на
/domain/zone/*), підтвердьте у своєму обліковому записі OVH і скопіюйте отриманий consumer key. - У панелі керування в Домени → Додати домен оберіть провайдера «OVHcloud» і вставте всі три значення.
Примітка: типово ми використовуємо ендпоінт для ЄС. Обліковим записам CA/US потрібен інший базовий URL — зв'яжіться з нами заздалегідь.
deSEC
Передумова: (безкоштовний) обліковий запис deSEC.io з налаштованою там зоною.
- Створіть новий API-токен на desec.io/tokens.
- Одразу скопіюйте токен — він показується лише один раз.
- У панелі керування в Домени → Додати домен оберіть провайдера «deSEC» і вставте токен.
deSEC дружній до ACME-DNS-01 — сертифікати Let's Encrypt працюють без жодних додаткових налаштувань.
Gandi
Передумова: домен керується через ваш обліковий запис Gandi.
- Відкрийте admin.gandi.net і увійдіть.
- У розділі Authentication options → Personal Access Tokens створіть новий токен із дозволом «Manage DNS records».
- У панелі керування в Домени → Додати домен оберіть провайдера «Gandi» і вставте токен.
Gandi LiveDNS вимагає мінімального TTL 300 с — нижчі значення ми підвищуємо автоматично.
Mittwald
Передумова: обліковий запис Mittwald із проєктом, і домен налаштовано там як DNS-зону.
- У mStudio в розділі Profile → API Tokens створіть новий токен із правом запису до DNS-зон.
- Занотуйте ідентифікатор проєкту (UUID), якому належить зона — його видно в URL mStudio.
- У панелі керування в Домени → Додати домен оберіть провайдера «Mittwald» і вставте API-токен та ідентифікатор проєкту.
Примітка: Mittwald створює у вашому проєкті окремий об'єкт «DNS Zone» для кожного субдомену (делегування суб-зон). 10 DynDNS-хостів → 10 суб-зон — функціонально це нормально, але видно в інтерфейсі mStudio.
Infomaniak
Передумова: домен у вашому обліковому записі Infomaniak Manager.
- Відкрийте Manager → Profile → API keys і створіть токен зі скоупом «Domain».
- Занотуйте токен (показується лише один раз).
- У панелі керування в Домени → Додати домен оберіть провайдера «Infomaniak» і вставте токен.
Infomaniak нативно підтримує TXT-записи — сертифікати Let's Encrypt через DNS-01 працюють без додаткових налаштувань.
Scaleway
Передумова: домен зареєстровано в Scaleway і керується у вашому обліковому записі.
- У консолі Scaleway в розділі IAM → API keys створіть новий API-ключ.
- Занотуйте лише «Secret Key» — access key не потрібен.
- У панелі керування в Домени → Додати домен оберіть провайдера «Scaleway» і вставте Secret Key.
Scaleway використовує модель змін на основі PATCH — операції атомарні в межах запиту. Let's Encrypt DNS-01 працює нативно.
API та ендпоінти
Ендпоінт DynDNS2
Сумісний із роутерами ендпоінт оновлення:
GET https://api.dnsbeacon.com/nic/update?hostname=<host>[&myip=<ipv4>][&myipv6=<ipv6>] Authorization: Basic base64(<email>:<api-key>)
Можливі відповіді:
| good <ip> | Оновлення прийнято |
| nochg <ip> | IP не змінилася, оновлення DNS не потрібне |
| nohost | Ім'я хоста не існує або неактивне |
| badauth | Неправильний email або API-ключ |
| badparam | Недійсні параметри (напр. неправильно сформована IP) |
| abuse | IP-адреса не дозволена як ціль (зарезервований діапазон або регіональна політика) — не повторюйте запит |
| 911 | Помилка сервера — повторіть пізніше |
Тест із curl
curl -u "you@example.com:dyndns_..." \ "https://api.dnsbeacon.com/nic/update?hostname=myhouse.dnsfollowme.uk&myip=1.2.3.4"
Автоматичний SSL для ваших імен хостів
Випуск сертифікатів в один клік через Let's Encrypt — просто з панелі керування, без ACME-клієнта, без налаштувань на вашому боці. Працює для субдоменів на нашому домені та для вашого власного домену (BYOD).
- ✓Випуск в один клік із панелі керування — працює для субдоменів на нашому домені та для вашого власного домену (BYOD).
- ✓Автоматичне поновлення у фоні; найновіший сертифікат завжди доступний для завантаження.
- ✓Валідація DNS-01 — не потрібен відкритий порт 80, працює за NAT або DS-Lite.
- ✓Закріплення CAA гарантує, що сертифікати для ваших імен хостів можуть випускати лише авторизовані центри сертифікації.
Потрібен тариф PRO або BUSINESS.
FAQ
Мій роутер не надсилає оновлення — що робити?▼
Більшість роутерів (UniFi, Fritz!Box) надсилають оновлення лише тоді, коли WAN-IP справді змінюється. Щоб примусово оновити, вимкніть конфігурацію DynDNS у роутері, збережіть, знову увімкніть і збережіть. Вкладка «Імена хостів → Історія» в панелі керування показує, чи надходять оновлення.
Мій API-ключ — як ним користуватися?▼
Введіть його в роутері як пароль замість пароля облікового запису. Email залишається іменем користувача. API-ключ можна будь-коли відкликати, не змінюючи пароль облікового запису.
Чи можу я використовувати IPv6?▼
Так. Додайте «&myipv6=<your-ipv6>» до URL оновлення — сервіс створить AAAA-запис поряд з A-записом. Тарифи Free і Pro можуть використовувати обидва паралельно.
Що робити, якщо я втратив API-ключ?▼
API-ключі зберігаються лише у вигляді хешів, тож відновити їх неможливо. Видаліть старий ключ у панелі керування, створіть новий і оновіть налаштування роутера.
Скільки імен хостів/доменів я можу створити?▼
Free: 3 імені хоста, 1 власний домен, 3 API-ключі. Pro: без обмежень. Business: без обмежень + командний вхід.
Що таке перевірка домену?▼
Коли ви додаєте власний домен, сервіс за допомогою наданого токена звертається до DNS-провайдера й перевіряє, що зона існує і токен має доступ. Якщо все гаразд, домен позначається як перевірений і одразу готовий до використання.
Як увімкнути двофакторну автентифікацію?▼
У «Налаштування → Двофакторна автентифікація». Під час налаштування сервіс показує QR-код, який ви скануєте за допомогою Google Authenticator, Authy, Bitwarden або 1Password. Після активації ви отримаєте 8 одноразових резервних кодів — зберігайте їх у надійному місці. 2FA не впливає на API-ключі для /nic/update — роутерам, як і раніше, потрібні лише email + API-ключ.