Довідка та інструкції

Fritz!Box (AVM)

Internet → Permit Access → DynDNS

Провайдер:

Custom

URL оновлення:

https://api.dnsbeacon.com/nic/update?hostname=<domain>&myip=<ipaddr>

Доменне ім'я:

myhouse.dnsfollowme.uk

Ім'я користувача:

ваша адреса електронної пошти

Пароль:

ваш API-ключ

Synology NAS

Control Panel → External Access → DDNS → Add

Провайдер:

Custom

Ім'я хоста:

myhouse.dnsfollowme.uk

Ім'я користувача:

ваша адреса електронної пошти

Пароль:

ваш API-ключ

URL сервера:

https://api.dnsbeacon.com/nic/update?hostname=__HOSTNAME__&myip=__MYIP__

Ubiquiti UniFi

Settings → Internet → WAN → Dynamic DNS

Сервіс:

custom (або dyndns)

Ім'я хоста:

myhouse.dnsfollowme.uk

Ім'я користувача:

ваша адреса електронної пошти

Пароль:

ваш API-ключ

Сервер:

api.dnsbeacon.com/nic/update?hostname=%h&myip=%i

Примітка: 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-ключ

OpenWrt

Services → Dynamic DNS

Провайдер:

-- custom --

URL оновлення:

https://api.dnsbeacon.com/nic/update?hostname=[DOMAIN]&myip=[IP]

Доменне ім'я:

myhouse.dnsfollowme.uk

Ім'я користувача:

ваша адреса електронної пошти

Пароль:

ваш API-ключ

Спершу встановіть пакет 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

Спершу встановіть плагін 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-ключ

Встановіть для 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-ключ

Працює з 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-ключ

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-ключ

У 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-ключ

Виберіть «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-ключ

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-ключ

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-ключ

У 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-ключ

Виберіть «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-ключ

Починаючи з прошивки 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-ключ

У 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 …`.

Інші пристрої (сумісні з DynDNS2)

Будь-який пристрій, що підтримує DynDNS2, працює з такими значеннями:

URL оновлення:

https://api.dnsbeacon.com/nic/update?hostname=<host>&myip=<ip>

Автентифікація:

Basic Auth (email / API-ключ)

IPv6 (необов'язково):

додатковий параметр &myipv6=<ipv6>

Клієнт для 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; бінарник статично злінкований і не має залежностей.

Cloudflare

Передумова: домен делеговано на Cloudflare (неймсервери вказують на Cloudflare).

1. На dash.cloudflare.com/profile/api-tokens створіть токен.
2. Використайте шаблон «Edit zone DNS» — дозволи: Zone:DNS:Edit.
3. У розділі Zone Resources оберіть або Specific zone → your-domain.com, або All zones.
4. Скопіюйте токен і вставте його в панелі керування в Домени → Додати домен.

Hetzner DNS

Передумова: домен налаштовано як зону в Hetzner DNS Console.

1. На dns.hetzner.com/settings/api-token створіть API-токен.
2. Скопіюйте токен — він показується лише один раз.
3. У панелі керування в Домени → Додати домен оберіть провайдера «Hetzner DNS» і вставте токен.

united-domains

Передумова: для зони в united-domains увімкнено платний додаток DNS API. Без нього токен не повертає жодних зон.

1. Замовте додаток DNS API у портфоліо united-domains.
2. Згенеруйте API-ключ у своєму клієнтському кабінеті.
3. У панелі керування в Домени → Додати домен оберіть провайдера «united-domains» і вставте ключ.

Ліміт запитів: 1 200 запитів/год на токен.

IONOS

Передумова: домен у вашому обліковому записі IONOS, а доступ до API увімкнено в порталі розробника.

1. Відкрийте developer.hosting.ionos.de/keys і створіть нову пару ключів (публічний префікс + секрет).
2. Скопіюйте об'єднаний токен у форматі «<prefix>.<secret>» — він показується лише один раз.
3. У панелі керування в Домени → Додати домен оберіть провайдера «IONOS» і вставте об'єднаний токен.

Записи TXT підтримуються — сертифікати Let's Encrypt через DNS-01 працюють для зон, розміщених в IONOS.

INWX

Передумова: домен у вашому обліковому записі INWX.

1. Увійдіть у клієнтський кабінет INWX і створіть API-субкористувача без 2FA у розділі «Account → User management».
2. Занотуйте ім'я користувача та пароль субкористувача.
3. У панелі керування в Домени → Додати домен оберіть провайдера «INWX» і введіть ім'я користувача та пароль.

Важливо: вхід до API INWX не працює, коли на обліковому записі увімкнено 2FA через Mobile-TAN. Створіть для цього окремого субкористувача без 2FA — ваш основний обліковий запис може (і має) залишити 2FA увімкненою.

netcup

Передумова: домен керується через ваш обліковий запис netcup.

1. У netcup Customer Control Panel у розділі «Stammdaten ändern → API» створіть нову пару API-ключів.
2. Занотуйте номер клієнта, API-ключ та API-пароль (пароль показується лише один раз).
3. У панелі керування в Домени → Додати домен оберіть провайдера «netcup» і вставте всі три значення.

Примітка: API netcup працює на рівні наборів записів (кожна зміна замінює весь набір записів). Якщо ви редагуєте DNS-записи вручну в CCP саме в той момент, коли ми встановлюємо TXT-запис Let's Encrypt, одна зі змін може загубитися. Для звичайного трафіку (оновлення DynDNS, поновлення сертифікатів) це не проблема.

OVHcloud

Передумова: домен у вашому обліковому записі OVHcloud, і ви використовуєте європейський ендпоінт (eu.api.ovh.com).

1. Створіть новий API-застосунок на ovh.com/auth/api/createApp — ви отримаєте application key та application secret.
2. Відкрийте OVH Token Maker, введіть application key і secret та згенеруйте consumer key.
3. Важливо: надайте consumer key такі права (GET, POST, PUT, DELETE — кожне на /domain/zone/*), підтвердьте у своєму обліковому записі OVH і скопіюйте отриманий consumer key.
4. У панелі керування в Домени → Додати домен оберіть провайдера «OVHcloud» і вставте всі три значення.

Примітка: типово ми використовуємо ендпоінт для ЄС. Обліковим записам CA/US потрібен інший базовий URL — зв'яжіться з нами заздалегідь.

deSEC

Передумова: (безкоштовний) обліковий запис deSEC.io з налаштованою там зоною.

1. Створіть новий API-токен на desec.io/tokens.
2. Одразу скопіюйте токен — він показується лише один раз.
3. У панелі керування в Домени → Додати домен оберіть провайдера «deSEC» і вставте токен.

deSEC дружній до ACME-DNS-01 — сертифікати Let's Encrypt працюють без жодних додаткових налаштувань.

Gandi

Передумова: домен керується через ваш обліковий запис Gandi.

1. Відкрийте admin.gandi.net і увійдіть.
2. У розділі Authentication options → Personal Access Tokens створіть новий токен із дозволом «Manage DNS records».
3. У панелі керування в Домени → Додати домен оберіть провайдера «Gandi» і вставте токен.

Gandi LiveDNS вимагає мінімального TTL 300 с — нижчі значення ми підвищуємо автоматично.

Mittwald

Передумова: обліковий запис Mittwald із проєктом, і домен налаштовано там як DNS-зону.

1. У mStudio в розділі Profile → API Tokens створіть новий токен із правом запису до DNS-зон.
2. Занотуйте ідентифікатор проєкту (UUID), якому належить зона — його видно в URL mStudio.
3. У панелі керування в Домени → Додати домен оберіть провайдера «Mittwald» і вставте API-токен та ідентифікатор проєкту.

Примітка: Mittwald створює у вашому проєкті окремий об'єкт «DNS Zone» для кожного субдомену (делегування суб-зон). 10 DynDNS-хостів → 10 суб-зон — функціонально це нормально, але видно в інтерфейсі mStudio.

Infomaniak

Передумова: домен у вашому обліковому записі Infomaniak Manager.

1. Відкрийте Manager → Profile → API keys і створіть токен зі скоупом «Domain».
2. Занотуйте токен (показується лише один раз).
3. У панелі керування в Домени → Додати домен оберіть провайдера «Infomaniak» і вставте токен.

Infomaniak нативно підтримує TXT-записи — сертифікати Let's Encrypt через DNS-01 працюють без додаткових налаштувань.

Scaleway

Передумова: домен зареєстровано в Scaleway і керується у вашому обліковому записі.

1. У консолі Scaleway в розділі IAM → API keys створіть новий API-ключ.
2. Занотуйте лише «Secret Key» — access key не потрібен.
3. У панелі керування в Домени → Додати домен оберіть провайдера «Scaleway» і вставте Secret Key.

Scaleway використовує модель змін на основі PATCH — операції атомарні в межах запиту. Let's Encrypt DNS-01 працює нативно.