Installer VIGIL-MESH sur Linux (desktop et serveur)

Prérequis

L’agent Linux s’adresse à deux usages : le poste desktop d’un utilisateur et le serveur (ou la machine de site) sans interface graphique. Dans les deux cas, l’installation crée une interface TUN et un service géré par systemd. Elle requiert les droits root, le temps de l’installation seulement.

• Une distribution Linux à base Debian ou Ubuntu (paquet .deb), sur architecture amd64 ou arm64.
• Les droits root (sudo) pour installer le paquet, créer l’interface TUN et activer le service.
• Le support des interfaces TUN dans le noyau (standard sur les distributions courantes).
• Pour un serveur sans écran : une clé pré-autorisée fournie par un administrateur, afin d’enrôler la machine sans interaction. Pour un desktop : une invitation, une clé, ou la file d’approbation.
• Un accès Internet sortant : aucune règle de pare-feu entrante ni redirection de port à préparer.

Télécharger

L’agent Linux se distribue en paquet .deb, pour les architectures amd64 et arm64. Le guide général se trouve sur /download ; les builds par plateforme sont listés sur /download/client, à partir d’un manifest signé qui publie le numéro de version et l’empreinte SHA-256 de chaque fichier.

1. 1
   Choisir le bon paquetSur /download/client, sélectionnez le paquet .deb correspondant à votre architecture : amd64 pour un serveur ou un poste x86-64, arm64 pour un ARM 64 bits (par exemple un mini-serveur ou une carte embarquée).
2. 2
   Récupérer le .deb et son empreinteTéléchargez le fichier .deb ainsi que l’empreinte SHA-256 publiée à côté, dans le manifest signé.
3. 3
   Vérifier l’intégritéCalculez l’empreinte du paquet téléchargé avec sha256sum, puis comparez-la à celle du manifest. Si les deux valeurs SHA-256 diffèrent, n’installez pas le paquet et retéléchargez-le.

Installer et lancer le service

1. 1
   Installer le paquetInstallez le .deb vérifié avec le gestionnaire de paquets (par exemple sudo apt install ./vigil-mesh_<version>_<arch>.deb). L’installation crée l’interface TUN et enregistre le service.
2. 2
   Activer et démarrer le serviceActivez puis démarrez le service au boot avec systemd (par exemple sudo systemctl enable --now vigil-mesh). Sur un serveur, l’agent tourne ainsi en tâche de fond, sans session graphique.
3. 3
   Contrôler l’étatVérifiez que le service est actif (par exemple systemctl status vigil-mesh) et consultez ses journaux en cas de besoin. L’agent reste connecté et se rétablit automatiquement après un redémarrage.

Enrôler

Une fois le service lancé, la machine doit être enrôlée pour rejoindre l’espace de travail. Sur un desktop, vous pouvez passer par une invitation, une clé pré-autorisée ou la file d’approbation. Sur un serveur sans écran, la clé pré-autorisée est la voie recommandée : elle enrôle la machine sans aucune interaction.

1. 1
   Obtenir une clé pré-autoriséeDemandez à un administrateur une clé pré-autorisée pour l’espace de travail. Elle autorise la machine à s’enrôler sans validation manuelle.
2. 2
   Enrôler l’agent avec la cléFournissez la clé à l’agent en ligne de commande (par exemple via la commande d’enrôlement du client, ou une variable d’environnement du service). La machine s’enrôle et ouvre sa session vers le mesh.
3. 3
   Confirmer l’adhésionVérifiez que la machine apparaît bien dans l’espace de travail et que sa session est établie. Elle est désormais membre du réseau.

Vérifier

Après l’enrôlement, vérifiez que l’agent est bien membre du mesh. Quelques contrôles suffisent, sur desktop comme sur serveur.

• Adresse stable : l’interface TUN a reçu une adresse IPv4 dans l’espace 100.64.0.0/10 et une adresse IPv6 ULA, qui ne changent pas d’une session à l’autre.
• Résolution par nom : MagicDNS résout localement les noms des autres appareils, sans qu’aucune requête ne quitte la machine.
• Joignabilité : un test simple (ping vers l’adresse mesh d’un autre nœud, puis accès à un service partagé) confirme que le chemin est ouvert.

Pour une procédure de vérification complète et le diagnostic des cas particuliers, suivez la page dédiée à la vérification après enrôlement.