Aide et guides
Instructions de configuration pour les routeurs, les fournisseurs DNS et l'API.
Pour commencer
- Crée un compte et confirme ton adresse e-mail.
- Dans le tableau de bord, va dans Noms d'hôte → Créer et ajoute un sous-domaine comme
myhouse.dnsfollowme.uk. - Dans l'onglet Clés API, crée une clé API (par ex. « Fritz!Box salon ») et copie-la en lieu sûr — elle ne s'affiche qu'une fois.
- Configure ton routeur selon Configuration du routeur — utilise la clé API comme mot de passe.
Configuration du routeur
Vous préférez installer un programme sur l'appareil plutôt que configurer votre routeur ? C'est à cela que servent les clients natifs.
IPv4 ou IPv6 ?
Les valeurs ci-dessus mettent à jour l'adresse IPv4 (enregistrement A), le cas normal sur les accès disposant d'une IPv4 publique. Pour l'IPv6 (enregistrement AAAA), l'appareil envoie en plus ou à la place le paramètre &myipv6=<IPv6>. La ligne « IPv6 » du tableau indique comment procéder sur cet appareil.
DS-Lite ou CGNAT (nombreux accès câble et fibre) : le routeur n'a alors pas d'IPv4 publique, et le service refuse une adresse WAN privée avec « abuse ». Dans ce cas, envoyez uniquement myipv6, ou utilisez le client DNS Beacon directement sur l'appareil cible : il détecte lui-même les deux familles d'adresses.
Fritz!Box (AVM)
Internet → Autoriser l'accès → DynDNS
- Fournisseur:
- Personnalisé
- URL de mise à jour:
- https://api.dnsbeacon.com/nic/update?hostname=<domain>&myip=<ipaddr>
- Nom de domaine:
- myhouse.dnsfollowme.uk
- Nom d'utilisateur:
- ton adresse e-mail
- Mot de passe:
- ta clé API
- IPv6:
- Variable <ip6addr>. Double pile : ajoutez &myipv6=<ip6addr> à l'URL de mise à jour. DS-Lite : envoyez uniquement ?hostname=<domain>&myipv6=<ip6addr>, sans <ipaddr>.
Synology NAS
Panneau de configuration → Accès externe → DDNS → Ajouter
- Fournisseur:
- Personnalisé
- Nom d'hôte:
- myhouse.dnsfollowme.uk
- Nom d'utilisateur:
- ton adresse e-mail
- Mot de passe:
- ta clé API
- URL du serveur:
- https://api.dnsbeacon.com/nic/update?hostname=__HOSTNAME__&myip=__MYIP__
- IPv6:
- DSM 7 : variable __MYIPV6__ ; ajoutez &myipv6=__MYIPV6__ à l'URL du serveur (en DS-Lite, supprimez &myip=__MYIP__). Les anciennes versions de DSM ne connaissent pas cette variable.
Ubiquiti UniFi
Settings → Internet → WAN → Dynamic DNS
- Service:
- custom (ou dyndns)
- Nom d'hôte:
- myhouse.dnsfollowme.uk
- Nom d'utilisateur:
- ton adresse e-mail
- Mot de passe:
- ta clé API
- Serveur:
- api.dnsbeacon.com/nic/update?hostname=%h&myip=%i
- IPv6:
- IPv4 uniquement – UniFi OS ne prend pas en charge les mises à jour AAAA. Pour l'IPv6, utilisez le client DNS Beacon directement sur l'appareil cible.
Remarque : UniFi n'envoie de mises à jour que lorsque l'IP WAN change réellement. Pour forcer une mise à jour, désactive la configuration DynDNS, enregistre, réactive, enregistre.
Guide détaillé →pfSense / OPNsense
Services → Dynamic DNS → Add
- Type de service:
- Custom
- URL de mise à jour:
- https://api.dnsbeacon.com/nic/update?hostname=%h&myip=%IP%
- Nom d'hôte:
- myhouse.dnsfollowme.uk
- Nom d'utilisateur:
- ton adresse e-mail
- Mot de passe:
- ta clé API
- IPv6:
- Créez une seconde entrée avec le Service Type « Custom (v6) » et utilisez &myipv6=%IP% au lieu de &myip=%IP% dans son URL de mise à jour.
OpenWrt
Services → Dynamic DNS
- Fournisseur:
- -- custom --
- URL de mise à jour:
- https://api.dnsbeacon.com/nic/update?hostname=[DOMAIN]&myip=[IP]
- Nom de domaine:
- myhouse.dnsfollowme.uk
- Nom d'utilisateur:
- ton adresse e-mail
- Mot de passe:
- ta clé API
- IPv6:
- Créez une seconde configuration DDNS avec la version d'adresse IP IPv6 (use_ipv6) et utilisez &myipv6=[IP] au lieu de &myip=[IP] dans son URL de mise à jour.
Installez d'abord le paquet luci-app-ddns (Système → Logiciels, ou opkg install luci-app-ddns ddns-scripts). OpenWrt remplace [DOMAIN] et [IP] dans l'URL automatiquement.
Guide détaillé →OPNsense
Services → Dynamic DNS → Settings
- Type de service:
- Custom
- Serveur:
- api.dnsbeacon.com
- Nom d'utilisateur:
- ton adresse e-mail
- Mot de passe:
- ta clé API
- Nom d'hôte:
- myhouse.dnsfollowme.uk
- IPv6:
- Créez un second compte réservé à l'IPv6 : réglez « Check ip method » sur un service IPv6 et activez « Allow IPv6 » dans General Settings.
Installez d'abord le plugin os-ddclient (System → Firmware → Plugins) et choisissez le service Custom : il envoie des mises à jour DynDNS2 standard vers /nic/update.
Guide détaillé →DD-WRT
Services → DDNS
- Service:
- Custom
- Serveur:
- api.dnsbeacon.com
- URL de mise à jour:
- /nic/update?hostname=
- Nom d'hôte:
- myhouse.dnsfollowme.uk
- Nom d'utilisateur:
- ton adresse e-mail
- Mot de passe:
- ta clé API
- IPv6:
- IPv4 uniquement – l'interface DDNS n'envoie que l'IPv4 ; l'IPv6 nécessiterait un script cron maison. Pour l'IPv6, utilisez le client DNS Beacon directement sur l'appareil cible.
Réglez le service DDNS sur Custom. DD-WRT ajoute automatiquement votre nom d'hôte et votre IP actuelle à l'URL.
Guide détaillé →TP-Link Omada
Settings → Services → Dynamic DNS (ou 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:
- ton adresse e-mail
- Password:
- ta clé API
- IPv6:
- IPv4 uniquement – le DDNS d'Omada ne prend pas encore en charge les mises à jour IPv6. Pour l'IPv6, utilisez le client DNS Beacon directement sur l'appareil cible.
Fonctionne avec Omada Controller v5+ et les firmwares des passerelles ER (ER605, ER7206…) qui exposent une entrée Custom DDNS. Choisissez « Custom » comme Service Provider et créez une nouvelle entrée Dynamic DNS — Omada remplace automatiquement [DOMAIN], [IP], [USERNAME] et [PASSWORD] dans l'URL.
Guide détaillé →Aruba Instant
Configuration → Services → Dynamic DNS
- Provider:
- DynDNS
- URL:
- https://api.dnsbeacon.com/nic/update?hostname=<h>&myip=<a>
- Hostname:
- myhouse.dnsfollowme.uk
- Username:
- ton adresse e-mail
- Password:
- ta clé API
- IPv6:
- IPv4 uniquement – Aruba Instant On ne prend pas en charge le DDNS en IPv6. Pour l'IPv6, utilisez le client DNS Beacon directement sur l'appareil cible.
Aruba Instant (ArubaOS 8.x+) prend en charge des profils Dynamic DNS personnalisés. Dans la WebUI ou via la CLI (`dynamic-dns` / `ddns-profile`), réglez le provider sur « DynDNS » et surchargez l'URL pour pointer vers l'API DNS Beacon. Aruba remplace <h> par le nom d'hôte et <a> par l'IP actuelle.
Guide détaillé →LANCOM
Communication → Général → Table d'actions (LANconfig)
- Action (URL):
- https://api.dnsbeacon.com/nic/update?hostname=%h&myip=%a
- Hostname:
- myhouse.dnsfollowme.uk
- Nom d'utilisateur:
- ton adresse e-mail
- Mot de passe:
- ta clé API
- IPv6:
- Variable %z. Double pile : ajoutez &myipv6=%z à l'URL de l'action. DS-Lite : utilisez uniquement ?hostname=%h&myipv6=%z.
Dans LANconfig, sous Communication → Général → Table d'actions, créez une action déclenchée sur « Established » / changement d'IP. LANCOM remplace %h par le nom d'hôte et %a par l'IPv4 actuelle (utilisez %z pour l'IPv6). Intégrez vos identifiants sous la forme `https://<nom d'utilisateur>:<clé API>@…` dans l'URL.
Guide détaillé →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:
- ton adresse e-mail
- Mot de passe:
- ta clé API
- IPv6:
- IPv4 uniquement – le Customized DDNS ne fournit que l'IPv4 WAN via ###IP###. Pour l'IPv6, utilisez le client DNS Beacon directement sur l'appareil cible.
Choisissez « User-Defined » comme Service Provider. DrayTek remplace automatiquement ###IP### par l'IP WAN actuelle ; le Login Account et le mot de passe sont envoyés en authentification HTTP basic vers /nic/update. Réglez « Determine Real WAN IP » sur « WAN IP » si le routeur est connecté directement à Internet.
Guide détaillé →Ubiquiti EdgeRouter
CLI (configure) — ou GUI : Services → DNS → Dynamic DNS
- Protocole:
- dyndns2
- Server:
- api.dnsbeacon.com
- Hostname:
- myhouse.dnsfollowme.uk
- Login:
- ton adresse e-mail
- Mot de passe:
- ta clé API
- IPv6:
- IPv4 uniquement – le ddclient livré avec EdgeOS ne gère pas les mises à jour AAAA de façon fiable. Pour l'IPv6, utilisez le client DNS Beacon directement sur l'appareil cible.
EdgeOS utilise ddclient. En CLI : `set service dns dynamic interface eth0 service custom-dnsbeacon protocol dyndns2`, puis `server <hôte API>`, `host-name <nom d'hôte>`, `login <e-mail>`, `password <clé API>` — puis `commit; save`. Remplacez eth0 par votre interface WAN.
Guide détaillé →FortiGate
Network → DNS → Dynamic DNS
- Server:
- genericDDNS
- Adresse du serveur:
- api.dnsbeacon.com
- Domain:
- myhouse.dnsfollowme.uk
- Nom d'utilisateur:
- ton adresse e-mail
- Mot de passe:
- ta clé API
- IPv6:
- FortiOS 7.0+ : créez une seconde entrée DDNS avec server-type ipv6 et addr-type ipv6.
FortiOS prend en charge depuis la version 6.x le type de serveur « genericDDNS », qui appelle l'endpoint DynDNS2 standard /nic/update sur n'importe quel serveur que vous spécifiez. En CLI : `config system ddns` → `set ddns-server genericDDNS`, `set ddns-server-addr` avec l'adresse de l'API, `set ddns-domain` avec votre nom d'hôte, `ddns-username` / `ddns-password` pour l'authentification. Réglez monitor-interface sur votre interface WAN.
Guide détaillé →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
- Nom d'utilisateur:
- ton adresse e-mail
- Mot de passe:
- ta clé API
- IPv6:
- À partir du firmware 10.2.5, le client DynDNS signale aussi l'IPv6 (DS-Lite inclus) : activez l'option IPv6 dans l'entrée du fournisseur ; variable selon l'aide du firmware.
Sous Local Services → DynDNS Client → DynDNS Provider, créez un nouveau provider avec ce serveur et cette URL de mise à jour. bintec remplace <domain> par le nom d'hôte et <ipaddr> par l'IP WAN actuelle ; le nom d'utilisateur et le mot de passe sont envoyés pour l'authentification. Sélectionnez ensuite ce provider dans l'enregistrement DynDNS.
Guide détaillé →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:
- ton adresse e-mail
- Password:
- ta clé API
- IPv6:
- IPv4 uniquement – la fonction DDNS de ZLD ne signale que l'IPv4 de l'interface WAN. Pour l'IPv6, utilisez le client DNS Beacon directement sur l'appareil cible.
Choisissez « User customize » comme DDNS Provider. Zyxel remplace <domain> par le Domain Name et <ipaddr> par l'IP WAN ; Username et Password sont envoyés en authentification vers /nic/update. Le « ? » final dans l'URL est obligatoire.
Guide détaillé →Peplink Balance
Network → WAN → [connexion] → Dynamic DNS Settings
- Service:
- custom (User-defined)
- Server:
- api.dnsbeacon.com
- Hostname:
- myhouse.dnsfollowme.uk
- Username:
- ton adresse e-mail
- Password:
- ta clé API
- IPv6:
- IPv4 uniquement – le DDNS de Peplink ne signale pas d'adresses IPv6. Pour l'IPv6, utilisez le client DNS Beacon directement sur l'appareil cible.
À partir du firmware 6.3, vous pouvez indiquer un serveur DDNS personnalisé sous Dynamic DNS Settings. L'option custom utilise le protocole DynDNS — saisissez l'hôte API comme serveur. Le nom d'utilisateur est votre e-mail, le mot de passe une clé API.
Guide détaillé →VyOS
CLI (configure)
- Protocole:
- dyndns2
- Server:
- api.dnsbeacon.com
- Hostname:
- myhouse.dnsfollowme.uk
- Login:
- ton adresse e-mail
- Mot de passe:
- ta clé API
- IPv6:
- VyOS 1.4+ : créez un bloc name distinct pour l'IPv6 (p. ex. dnsbeacon6) et ajoutez-y ip-version ipv6.
En CLI : `set service dns dynamic name dnsbeacon protocol dyndns2`, puis `server <hôte API>`, `host-name <nom d'hôte>`, `username <e-mail>`, `password <clé API>`, `address interface eth0` — puis `commit; save`. Sur VyOS 1.2/1.3, le chemin est `service dns dynamic interface eth0 service …`.
Guide détaillé →MikroTik RouterOS
System → Scripts et System → Scheduler (WinBox ou terminal)
- Interface WAN:
- interface portant l'IP publique, p. ex. ether1 ou pppoe-out1 (à mettre à la place de ether1 dans le script)
- Hostname:
- myhouse.dnsfollowme.uk
- Nom d'utilisateur:
- ton adresse e-mail (<email> dans le script)
- Mot de passe:
- ta clé API (<api-key> dans le script)
- Script, ligne 1:
- :local a [/ip address get [find interface=ether1] address]; :local ip [:pick $a 0 [:find $a "/"]]
- Script, ligne 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:
- Ligne 1 : remplacez /ip address par /ipv6 address et [find interface=ether1] par [find interface=ether1 global] ; ligne 2 : envoyez &myipv6=$ip au lieu de &myip=$ip.
RouterOS n'a pas de client DynDNS2 intégré : IP Cloud ne dialogue qu'avec le service propre de MikroTik. Un script de deux lignes s'occupe donc de la mise à jour : la ligne 1 lit l'IP de l'interface WAN, la ligne 2 appelle /nic/update via /tool fetch avec une authentification HTTP basique et écrit la réponse dans le journal. En DSL/PPPoE, l'interface WAN s'appelle généralement pppoe-out1. Derrière un CGNAT/DS-Lite, l'IP WAN est privée et de toute façon injoignable en IPv4 : envoyez alors myipv6 avec l'adresse IPv6 globale. Valable pour RouterOS 7 (et 6.45+).
Guide détaillé →Autres appareils (compatibles DynDNS2)
Tout appareil qui parle DynDNS2 fonctionne avec ce qui suit :
- URL de mise à jour:
- https://api.dnsbeacon.com/nic/update?hostname=<host>&myip=<ip>
- Authentification:
- Basic Auth (e-mail / clé API)
- IPv6 (optionnel):
- paramètre supplémentaire &myipv6=<ipv6>
Clients de mise à jour natifs
BetaUn client de mise à jour léger qui s'exécute sur l'appareil même — idéal pour les portables, stations de travail et serveurs qui doivent signaler leur IP publique sans que le routeur gère la configuration DynDNS. Disponible pour Windows, macOS et Linux.
- ✓Statut en un coup d'œil — icône dans la barre des tâches sous Windows, dans la barre des menus sous macOS, la commande dnsbeacon-client status sous Linux : dernière mise à jour, IP signalée, prochaine exécution.
- ✓Démarrage automatique au boot, sans déclenchement manuel ; les mises à jour s'exécutent en arrière-plan.
- ✓Détecte IPv4 et IPv6 séparément et peut maintenir les deux familles d'adresses à jour en parallèle.
- ✓Installateurs signés : MSI pour Windows, pkg notarié pour macOS (universel). Pour Linux, deb, rpm ou un binaire statique pour x86-64, ARM64 et ARMv7.
Les trois clients sont disponibles dans le tableau de bord, sous Téléchargements ; les guides ci-dessous décrivent la configuration pas à pas.
Client Windows
icône de la barre d'état → Paramètres
- Installation:
- téléchargez le MSI depuis la page Téléchargements (tableau de bord → Téléchargements) et installez-le
- Nom d'hôte:
- myhouse.dnsfollowme.uk
- Clé API:
- clé dyndns_… du tableau de bord (saisie masquée)
- Intervalle:
- minutes entre les vérifications d'IP (5 par défaut)
- IPv4 (A):
- case « Mettre à jour IPv4 (A) » — activée par défaut
- IPv6 (AAAA):
- case « Mettre à jour IPv6 (AAAA) » — décochez IPv4 pour IPv6 uniquement (DS-Lite)
- Service:
- le service Windows met à jour même sans session ouverte
La clé API est une clé dyndns_… du tableau de bord — le serveur refuse les mots de passe de compte. Le service se met à jour automatiquement ; l'app de la barre d'état affiche l'état et la dernière IP.
Guide détaillé →Client macOS
Terminal
- Installation:
- téléchargez le pkg depuis la page Téléchargements (tableau de bord → Téléchargements) et installez-le par double-clic
- Configurer:
- sudo dnsbeacon-client configure --hostname myhouse.dnsfollowme.uk
- --hostname <fqdn>:
- nom d'hôte à maintenir à jour
- --interval <min>:
- minutes entre les vérifications d'IP (5 par défaut)
- --ipv4 / --no-ipv4:
- mettre à jour l'IPv4 (enregistrement A) — activé par défaut
- --ipv6 / --no-ipv6:
- mettre à jour l'IPv6 (enregistrement AAAA) — désactivé par défaut ; --no-ipv4 --ipv6 pour IPv6 uniquement (p. ex. DS-Lite)
- --api-key-stdin:
- lire la clé API depuis stdin (pour les scripts) ; sans cette option, saisie masquée
- Appliquer:
- sudo launchctl kickstart -k system/com.dnsbeacon.client
- Vérifier:
- dnsbeacon-client status ou sudo dnsbeacon-client once --force
- Journal:
- /Library/Logs/DynDnsClient/daemon.log
La clé API est une clé dyndns_… du tableau de bord — le serveur refuse les mots de passe de compte. Après l'installation, l'icône « DNS Beacon » de la barre des menus affiche l'état ; le démon tourne comme service launchd même sans session ouverte et se met à jour tout seul.
Guide détaillé →Client Linux
Terminal
- Installation:
- téléchargez le paquet depuis la page Téléchargements (tableau de bord → Téléchargements) : sudo dpkg -i dnsbeacon-client_*.deb, sudo rpm -i dnsbeacon-client-*.rpm ou sudo sh install.sh depuis l'archive
- Configurer:
- sudo dnsbeacon-client configure --hostname myhouse.dnsfollowme.uk
- --hostname <fqdn>:
- nom d'hôte à maintenir à jour
- --interval <min>:
- minutes entre les vérifications d'IP (5 par défaut)
- --ipv4 / --no-ipv4:
- mettre à jour l'IPv4 (enregistrement A) — activé par défaut
- --ipv6 / --no-ipv6:
- mettre à jour l'IPv6 (enregistrement AAAA) — désactivé par défaut ; --no-ipv4 --ipv6 pour IPv6 uniquement (p. ex. DS-Lite)
- --api-key-stdin:
- lire la clé API depuis stdin (pour les scripts) ; sans cette option, saisie masquée
- Appliquer:
- sudo systemctl restart dnsbeacon-client
- Vérifier:
- dnsbeacon-client status ou sudo dnsbeacon-client once --force
- Journal:
- journalctl -u dnsbeacon-client -f
La clé d'API est une clé dyndns_… du tableau de bord — le serveur refuse les mots de passe de compte. Le client s'exécute comme service systemd sous root et met à jour dès le démarrage, même sans session ouverte. Il se met à jour tout seul, en empruntant le même chemin que celui de son installation (dpkg, rpm ou remplacement du binaire). Pour les systèmes sans dpkg/rpm — Alpine, Arch, firmware de NAS — une archive tar avec install.sh est fournie ; le binaire est lié statiquement et n'a aucune dépendance.
Guide détaillé →Apporte ton propre domaine
Tu peux rattacher un domaine que tu héberges toi-même chez un fournisseur DNS pris en charge. Ton jeton API est stocké chiffré en AES-256-GCM et n'est utilisé que pour mettre à jour les enregistrements DNS de ce domaine.
Cloudflare
Prérequis : le domaine est délégué à Cloudflare (serveurs de noms réglés sur Cloudflare).
- Sur dash.cloudflare.com/profile/api-tokens crée un jeton.
- Utilise le modèle « Edit zone DNS » — permissions :
Zone:DNS:Edit. - Sous Zone Resources choisis soit Specific zone → ton-domaine.com soit All zones.
- Copie le jeton et colle-le dans le tableau de bord sous Domaines → Ajouter un domaine.
Hetzner DNS
Prérequis : le domaine est configuré comme zone dans la console DNS Hetzner.
- Sur dns.hetzner.com/settings/api-token crée un jeton API.
- Copie le jeton — il n'est affiché qu'une seule fois.
- Dans le tableau de bord, sous Domaines → Ajouter un domaine, choisis le fournisseur « Hetzner DNS » et colle le jeton.
united-domains
Prérequis : l'option payante DNS API est activée pour la zone chez united-domains. Sans elle, le jeton ne renvoie aucune zone.
- Souscris à l'option DNS API dans le portefeuille united-domains.
- Génère la clé API dans ton espace client.
- Dans le tableau de bord, sous Domaines → Ajouter un domaine, choisis le fournisseur « united-domains » et colle la clé.
Limite de débit : 1 200 requêtes/heure par jeton.
IONOS
Prérequis : le domaine est dans ton compte IONOS et l'accès API est activé dans le portail développeurs.
- Ouvre developer.hosting.ionos.de/keys et crée une nouvelle paire de clés (public prefix + secret).
- Copie le jeton combiné au format « <prefix>.<secret> » — il n'est affiché qu'une seule fois.
- Dans le tableau de bord, sous Domaines → Ajouter un domaine, choisis le fournisseur « IONOS » et colle le jeton combiné.
Les enregistrements TXT sont pris en charge — les certificats Let's Encrypt via DNS-01 fonctionnent pour les zones hébergées chez IONOS.
INWX
Prérequis : le domaine est dans ton compte INWX.
- Connecte-toi à l'espace client INWX et crée un sous-utilisateur API sans 2FA dans « Compte → Gestion des utilisateurs ».
- Note le nom d'utilisateur et le mot de passe du sous-utilisateur.
- Dans le tableau de bord, sous Domaines → Ajouter un domaine, choisis le fournisseur « INWX » et saisis le nom d'utilisateur et le mot de passe.
Important : la connexion API INWX échoue si le compte a la 2FA Mobile-TAN activée. Crée un sous-utilisateur séparé sans 2FA pour cela — ton compte principal peut (et devrait) conserver la 2FA.
netcup
Prérequis : le domaine est géré via ton compte netcup.
- Dans le Customer Control Panel netcup sous « Stammdaten ändern → API », crée une nouvelle paire de clés API.
- Note le numéro client, la clé API et le mot de passe API (le mot de passe n'est affiché qu'une seule fois).
- Dans le tableau de bord, sous Domaines → Ajouter un domaine, choisis le fournisseur « netcup » et colle les trois valeurs.
Note : l'API netcup est basée sur recordset (chaque modification remplace l'intégralité du jeu d'enregistrements). Si tu édites des enregistrements DNS manuellement dans le CCP au moment où nous posons un enregistrement TXT Let's Encrypt, une modification peut être perdue. En fonctionnement normal (mises à jour DynDNS, renouvellements de certificats) ce n'est pas un problème.
OVHcloud
Prérequis : le domaine est dans ton compte OVHcloud et tu utilises l'endpoint européen (eu.api.ovh.com).
- Crée une nouvelle application API sur ovh.com/auth/api/createApp — tu obtiens une application key et un application secret.
- Ouvre l'OVH Token Maker, saisis l'application key et le secret, puis génère une consumer key.
- Important : accorde à la consumer key ces droits (GET, POST, PUT, DELETE chacun sur
/domain/zone/*), confirme dans ton compte OVH et copie la consumer key obtenue. - Dans le tableau de bord, sous Domaines → Ajouter un domaine, choisis le fournisseur « OVHcloud » et colle les trois valeurs.
Note : nous utilisons par défaut l'endpoint EU. Les comptes CA/US nécessitent une URL de base différente — merci de nous contacter au préalable.
deSEC
Prérequis : un compte (gratuit) chez deSEC.io avec une zone configurée.
- Crée un nouveau jeton API sur desec.io/tokens.
- Copie le jeton immédiatement — il n'est affiché qu'une seule fois.
- Dans le tableau de bord, sous Domaines → Ajouter un domaine, choisis le fournisseur « deSEC » et colle le jeton.
deSEC est compatible ACME-DNS-01 — les certificats Let's Encrypt fonctionnent sans configuration particulière.
Gandi
Prérequis : le domaine est géré via ton compte Gandi.
- Ouvre admin.gandi.net et connecte-toi.
- Dans Authentication options → Personal Access Tokens, crée un nouveau jeton avec la permission « Manage DNS records ».
- Dans le tableau de bord, sous Domaines → Ajouter un domaine, choisis le fournisseur « Gandi » et colle le jeton.
Gandi LiveDNS impose un TTL minimum de 300s — nous remontons automatiquement les valeurs inférieures.
Mittwald
Prérequis : un compte Mittwald avec un projet, et le domaine configuré comme zone DNS.
- Dans mStudio, sous Profil → API Tokens, crée un nouveau jeton avec accès en écriture aux zones DNS.
- Note l'ID de projet (UUID) qui contient la zone — visible dans l'URL mStudio.
- Dans le tableau de bord, sous Domaines → Ajouter un domaine, choisis le fournisseur « Mittwald » et colle le jeton API et l'ID de projet.
Note : Mittwald crée un objet « DNS Zone » distinct dans ton projet pour chaque sous-domaine (délégation de sous-zones). 10 hôtes DynDNS → 10 sous-zones — fonctionnellement correct, mais visible dans l'UI mStudio.
Infomaniak
Prérequis : le domaine est dans ton compte Infomaniak Manager.
- Ouvre Manager → Profil → Clés API et crée un jeton avec la portée « Domain ».
- Note le jeton (affiché une seule fois).
- Dans le tableau de bord, sous Domaines → Ajouter un domaine, choisis le fournisseur « Infomaniak » et colle le jeton.
Infomaniak supporte nativement les enregistrements TXT — les certificats Let's Encrypt via DNS-01 fonctionnent sans configuration particulière.
Scaleway
Prérequis : le domaine est enregistré chez Scaleway et géré dans ton compte.
- Dans la console Scaleway, sous IAM → API keys, crée une nouvelle clé API.
- Note uniquement le « Secret Key » — l'access key n'est pas nécessaire.
- Dans le tableau de bord, sous Domaines → Ajouter un domaine, choisis le fournisseur « Scaleway » et colle le Secret Key.
Scaleway utilise un modèle de changements basé sur PATCH — les opérations sont atomiques par requête. Let's Encrypt DNS-01 fonctionne nativement.
API et points d'accès
Point d'accès DynDNS2
Le point d'accès de mise à jour compatible avec les routeurs :
GET https://api.dnsbeacon.com/nic/update?hostname=<host>[&myip=<ipv4>][&myipv6=<ipv6>] Authorization: Basic base64(<email>:<api-key>)
Réponses possibles :
| good <ip> | Mise à jour acceptée |
| nochg <ip> | IP inchangée, aucune mise à jour DNS nécessaire |
| nohost | Le nom d'hôte n'existe pas ou est inactif |
| badauth | E-mail ou clé API incorrect |
| badparam | Paramètres invalides (par ex. IP mal formée) |
| abuse | Adresse IP non autorisée comme cible (plage réservée ou restriction régionale) — ne pas réessayer |
| 911 | Erreur serveur — réessaie plus tard |
Tester avec curl
curl -u "you@example.com:dyndns_..." \ "https://api.dnsbeacon.com/nic/update?hostname=myhouse.dnsfollowme.uk&myip=1.2.3.4"
SSL automatique pour tes noms d'hôtes
Émission de certificats en un clic via Let's Encrypt — directement depuis le dashboard, sans client ACME ni configuration de ton côté. Fonctionne pour les sous-domaines sur notre domaine et pour ton propre domaine (BYOD).
- ✓Émission en un clic depuis le dashboard — fonctionne pour les sous-domaines sur notre domaine et pour ton propre domaine (BYOD).
- ✓Renouvellement automatique en arrière-plan ; le certificat le plus récent reste toujours téléchargeable.
- ✓Validation DNS-01 — aucun port 80 ouvert nécessaire, fonctionne aussi derrière du NAT ou du DS-Lite.
- ✓L'épinglage CAA garantit que seules les autorités de certification autorisées peuvent émettre des certificats pour tes noms d'hôtes.
Nécessite un plan PRO ou BUSINESS.
FAQ
Mon routeur n'envoie pas de mises à jour — que faire ?▼
La plupart des routeurs (UniFi, Fritz!Box) n'envoient des mises à jour que lorsque l'IP WAN change réellement. Pour en forcer une, désactive la configuration DynDNS dans le routeur, enregistre, réactive, enregistre. L'onglet Noms d'hôte → Historique du tableau de bord montre si les mises à jour arrivent.
Ma clé API — comment l'utiliser ?▼
Saisis-la dans le routeur comme mot de passe à la place du mot de passe de ton compte. L'e-mail reste le nom d'utilisateur. Tu peux révoquer la clé API à tout moment sans changer le mot de passe de ton compte.
Puis-je utiliser IPv6 ?▼
Oui. Ajoute « &myipv6=<ton-ipv6> » à l'URL de mise à jour — le service créera un enregistrement AAAA en plus de l'enregistrement A. Les plans Free et Pro peuvent utiliser les deux en parallèle.
Que faire si je perds ma clé API ?▼
Les clés API ne sont stockées que sous forme de hash et ne peuvent pas être récupérées. Supprime l'ancienne clé dans le tableau de bord, crées-en une nouvelle et mets à jour ton routeur.
Combien de noms d'hôte/domaines puis-je créer ?▼
Free : 3 noms d'hôte, 1 domaine personnalisé, 3 clés API. Pro : illimité. Business : illimité + connexion d'équipe.
Qu'est-ce que la vérification de domaine ?▼
Quand tu ajoutes un domaine personnalisé, le service utilise le jeton fourni pour appeler le fournisseur DNS et vérifier que la zone existe et que le jeton y a accès. Si cela fonctionne, le domaine est marqué comme vérifié et peut être utilisé immédiatement.
Comment activer l'authentification à deux facteurs ?▼
Sous Paramètres → Authentification à deux facteurs. Lors de la configuration, le service affiche un code QR que tu scannes avec Google Authenticator, Authy, Bitwarden ou 1Password. À l'activation, tu reçois 8 codes de secours à usage unique — conserve-les en lieu sûr. Les clés API pour /nic/update ne sont pas affectées par la 2FA — les routeurs n'ont toujours besoin que de l'e-mail + la clé API.