Documentation
Configurer MagicDNS
MagicDNS associe à chaque machine un nom court et vous laisse la joindre par ce nom plutôt que par son adresse. La résolution se fait entièrement en local, directement depuis la carte réseau signée que distribue le contrôleur : aucune requête DNS ne quitte le nœud, si bien que personne à l'extérieur n'apprend qui cherche à joindre qui. Cette page décrit ce que MagicDNS apporte, comment nommer et renommer vos machines, et les quelques bonnes pratiques à retenir. Le modèle d'adressage complet (IPv4 CGNAT, IPv6 ULA) est détaillé dans /docs/adressage-dns.
Ce qu'apporte MagicDNS
Retenir des adresses IP n'a pas de sens pour un humain, et les adresses VIGIL sont tirées d'un espace privé peu mémorisable. MagicDNS résout ce problème en donnant à chaque machine un nom court et stable, résolu de la même manière partout dans le réseau. Vous joignez vos machines par un nom, vos scripts et signets restent lisibles, et l'adresse sous-jacente peut varier sans casser l'accès.
- Un nom court par machine, résolu de façon identique depuis n'importe quel membre du réseau.
- Une résolution purement locale : aucune dépendance à un serveur DNS extérieur pour les noms du réseau VIGIL.
- Aucune fuite de métadonnées : la liste de qui parle à qui n'est reconstituable ni par un résolveur DNS, ni par un observateur du réseau.
- Un espace de noms privé au réseau : deux organisations distinctes peuvent utiliser les mêmes noms sans interférence, chacune dans son propre maillage.
Résolution locale (aucune requête ne sort)
Le point important est que la résolution des noms VIGIL ne repose sur aucun serveur DNS extérieur. La correspondance nom vers adresse est déjà présente sur la machine, dans la carte réseau (netmap) signée que distribue le contrôleur, et l'agent la sert lui-même. Rien n'est demandé à un résolveur externe pour les noms du réseau.
- 1Le contrôleur distribue une carte réseau signéeElle contient, pour chaque machine du réseau, son nom et ses adresses VIGIL. La signature garantit que la carte n'a pas été altérée.
- 2L'agent résout les noms VIGIL localementQuand une application demande un nom du réseau, l'agent répond directement depuis la carte, sans émettre la moindre requête vers un résolveur externe.
- 3Aucune requête DNS ne quitte le nœudNi le fournisseur d'accès, ni un résolveur public, ni l'infrastructure VIGIL n'apprennent quel appareil cherche à en joindre un autre.
Nommer et renommer les machines
Les noms sont administrés, pas devinés. Chaque machine porte un nom interne stable, choisi à l'enrôlement puis modifiable, et c'est ce nom qui sert d'ancre. Le renommer met à jour la carte réseau signée sans changer l'adresse VIGIL sous-jacente : vos accès par adresse restent valides même après un renommage, et le changement se propage tout seul aux autres membres.
- Le nom initial est fixé à l'enrôlement de la machine ; il peut être modifié ensuite depuis la console.
- Le renommage se propage par la carte réseau signée que redistribue le contrôleur ; il n'exige aucune reconfiguration côté clients.
- L'adresse VIGIL ne change pas lors d'un renommage : un service, une règle ou un signet fondés sur l'adresse restent valides.
- L'espace de noms étant privé au réseau, un même nom peut coexister sans conflit dans deux organisations distinctes.
Bonnes pratiques
MagicDNS demande peu de réglages, mais quelques habitudes rendent un parc plus lisible et plus stable dans le temps. L'idée générale est de traiter les noms comme un annuaire administré : cohérent, prévisible, et découplé des adresses.
- Adoptez une convention de nommage claire et cohérente (rôle, site, environnement) : elle vaut pour toute la durée de vie du parc.
- Préférez le nom à l'adresse dans vos scripts, vos règles et vos signets : le nom survit à un changement d'emplacement ou de réseau physique.
- Renommez plutôt que de ré-enrôler : le renommage conserve l'identité et l'adresse de la machine, là où un ré-enrôlement crée une nouvelle identité.
- Rappelez-vous que seuls les noms du réseau VIGIL passent par MagicDNS ; les noms publics restent résolus par votre système, sans interception.
In English
MagicDNS gives every machine a short, stable name and lets you reach it by that name instead of its address. Resolution happens entirely on the device, straight from the signed network map the controller distributes, so no DNS query ever leaves the node and no third party learns which device is reaching which.
Names are administered, not guessed: each machine's name is set at enrolment and can be renamed later without changing its VIGIL address, and the change propagates through the signed netmap. MagicDNS only handles the mesh namespace — public names keep resolving through your system's usual resolver.