VIGIL MESH

Documentation

Vigie privée : prérequis et dimensionnement

Une vigie privée est le point de rendez-vous public de votre mesh : elle aide les nœuds à se découvrir et relaie le trafic quand une liaison directe n'est pas possible. Bien la dimensionner, c'est lui donner assez de CPU, de mémoire et surtout de débit réseau pour le nombre de connexions attendu. Cette page rappelle les prérequis d'exposition, donne un gabarit de référence — un objectif de conception, pas une garantie — expose la logique de capacité et de montée en charge, et rappelle un principe important : la vigie est jetable, son état se reconstruit rapidement.

Prérequis

Une vigie a besoin d'une adresse IP publique et de quelques ports joignables depuis l'internet. Ce sont ces points d'entrée qui permettent aux nœuds de la contacter pour se découvrir et, au besoin, faire relayer leur trafic. Le reste de la configuration réseau du mesh reste sortant côté nœuds ordinaires.

PortRôle
udp/443Plan de données QUIC — chemin principal des flux relayés
udp/4433Plan de contrôle / signalisation QUIC
tcp/443Repli et compatibilité lorsque l'UDP est bloqué

Le rôle de la vigie, sa place dans l'architecture et sa mise en place initiale sont décrits dans la page « Héberger une vigie privée » (/docs/vigie-privee).

Gabarit de référence

Pour donner un point de départ concret, VIGIL-MESH publie un gabarit de référence. Il s'agit d'un objectif de conception : la cible que l'architecture vise, et non un débit contractuel ni une mesure garantie sur votre infrastructure. Les chiffres réels dépendent de votre hébergeur, du profil de trafic et de la part de flux effectivement relayés.

Deux enseignements se dégagent de ce gabarit. D'abord, la ressource critique d'une vigie est le réseau — débit et paquets par seconde — bien avant le CPU ou la mémoire : c'est le débit de 5 Gbps qui borne l'ordre de grandeur des 10 000 connexions. Ensuite, le relais se raisonne par cœur, via le gate de 1 Gbps et 150 000 pps : c'est l'unité à partir de laquelle on estime la capacité d'une machine et sa marge.

Capacité et montée en charge

À partir du gate par cœur, la capacité d'une vigie s'estime en raisonnant sur la ressource qui sature en premier. Comme le facteur limitant est le réseau, c'est le débit agrégé et le nombre de paquets par seconde qu'il faut suivre, davantage que la charge CPU moyenne.

  • Estimer la charge par le trafic réellement relayé, pas par le nombre brut de nœuds : deux nœuds qui se joignent en direct ne consomment quasiment aucune bande passante de vigie.
  • Surveiller le débit agrégé et les paquets par seconde en priorité, puisque le réseau sature avant le CPU dans le gabarit de référence.
  • Ajouter des vigies plutôt que de gonfler une seule machine au-delà de ce qu'un cœur relaie proprement : la montée en charge se fait horizontalement.
  • Répartir les vigies au plus près des populations de nœuds pour raccourcir les chemins et limiter le trafic relayé.

La vigie est jetable

Une vigie ne conserve pas d'état précieux et irremplaçable : elle tient un état de rendez-vous et de session qui se reconstruit à partir des nœuds qui s'y reconnectent. C'est un choix d'architecture qui a une conséquence pratique forte : une vigie peut être remplacée, redéployée ou déplacée sans procédure de sauvegarde et de restauration complexe.

En pratique, cela invite à traiter les vigies comme des ressources interchangeables : préférer en redéployer une propre plutôt que de réparer longuement une instance dégradée, et prévoir plusieurs vigies pour qu'une défaillance isolée reste sans effet notable sur le mesh.

Lire ensuiteExploiter et superviser une vigie

In English

A private vigie is your mesh's public rendezvous point: it helps nodes discover each other and relays traffic when a direct path is not possible. It needs a public IP and reachable ports (udp/443, udp/4433, tcp/443), and its scarce resource is network throughput rather than CPU.

The reference template is a design goal, not a guarantee: 4 vCPU / 8 GiB / 5 Gbps aims for roughly 10,000 connections, with a per-core relay gate of at least 1 Gbps and 150,000 packets per second. A vigie is disposable — its state rebuilds from reconnecting nodes, targeting under 60 seconds — so scale out with more vigies rather than oversizing one.