Documentation ELX-VNetwork — serveur, clients et dépannage

Monter le serveur

Le serveur demande une machine avec une adresse publique et un nom de domaine qui pointe vers elle. Le script d'installation fait le reste : il enregistre l'unité systemd, configure nginx et obtient un certificat.

Sur le serveur au domaine, en root

sudo DOMAIN=vnet.example.com sh install.sh
# puis ouvrez https://vnet.example.com/admin
# connectez-vous en admin / admin et changez le mot de passe

Le domaine doit se résoudre d'abordLe certificat est délivré en prouvant la maîtrise du nom : l'enregistrement DNS doit donc pointer vers le serveur avant l'exécution du script. Sinon, le script s'arrête exactement à cette étape et rien d'autre n'est cassé.

Les besoins sont modestes : un cœur et 512 Mo de mémoire portent des dizaines de machines connectées, car le serveur transmet les trames au lieu de les traiter.

Installer le client

Le client a besoin de deux choses : l'adresse de votre serveur et un code d'invitation venant de lui. Tout le reste — carte, service, adresse — il s'en charge.

Linux

sudo dpkg -i elx-vnetwork_*.deb
sudo elxvnet join -server https://vnet.example.com -invite ELX-XXXX-XXXX-XXXX
sudo systemctl enable --now elxvnet
elxvnet status

Windows, depuis une invite d'administrateur

cd "C:\Program Files\ELX-VNetwork"
elxvnet join -server https://vnet.example.com -invite ELX-XXXX-XXXX-XXXX
elxvnet -service restart

C'est par là que commence tout diagnosticelxvnet status affiche l'état de la connexion, l'adresse attribuée et tous les voisins du segment. La plupart des questions trouvent leur réponse dans cette seule ligne, avant d'ouvrir quoi que ce soit d'autre.

Segments et invitations

Un segment est un réseau indépendant. Les machines qui s'y trouvent se voient ; celles de segments différents non, bien qu'elles partagent un serveur. Un site, un client ou un banc d'essai en reçoit chacun un.

Créez un segment dans l'interface et donnez-lui un nom que vous reconnaîtrez encore dans un an.
Produisez un code d'invitation — à usage unique ou ouvert pour un lot de machines.
Installez le client avec ce code.
Validez la machine dans l'interface : jusque-là, elle attend au lieu d'être connectée.

La validation, voilà la protectionUn code qui a fuité ne suffit pas à entrer dans le réseau. La machine apparaît dans la liste d'attente et y reste jusqu'à ce qu'un humain la laisse entrer.

Lire le tableau des membres

Colonne	Ce qu'elle dit
Adresse	L'adresse permanente dans le segment, inchangée d'une reconnexion à l'autre
Version	La version du client — une version ancienne ici justifie le bouton de mise à jour
En ligne	Depuis combien de temps dure cette session ; un chiffre qui repart sans cesse à zéro signale une liaison instable
Vitesse	Le débit instantané dans les deux sens
Trafic	Les totaux de la session
Système	Le système d'exploitation, la mémoire occupée et la charge du processeur, toutes les trente secondes

La colonne système vient de ce que le noyau sait déjà ; rien de plus n'est installé sur la machine distante pour la produire.

Le terminal du navigateur

Toute machine Linux du segment s'ouvre en terminal depuis l'interface. C'est une session SSH ordinaire : la machine distante vous authentifie elle-même, avec ses propres comptes et sa propre politique de mots de passe. L'interface ne conserve pas ces identifiants et ne peut pas contourner cette vérification.

Ce que cela ne fait pasCela vous donne une console, pas un moyen de contourner la sécurité de la machine. Si SSH y est désactivé ou le compte verrouillé, le terminal échouera exactement comme n'importe quel autre client SSH.

Mettre à jour les clients

Windows. Le client se met à jour tout seul, sans rien demander.
Linux. Une machine restée sur une ancienne version se met à jour depuis le tableau des membres : l'interface ouvre une session SSH et effectue la mise à jour du paquet pour vous.
À la main. Téléchargez le nouveau paquet et installez-le comme précédemment ; l'invitation et l'adresse survivent à la mise à jour.

Notifications

Le serveur peut signaler qu'une machine a disparu ou est revenue, que quelqu'un attend une validation et que quelqu'un s'est trompé de mot de passe. La remise se fait par Telegram, par courriel ou les deux, avec les horaires dans votre propre fuseau.

Ce qu'il faut activer en premier« Machine hors ligne » pour les équipements qui comptent, et « en attente de validation ». Le reste devient utile quand le réseau est assez grand pour que vous ne regardiez plus l'interface tous les jours.

Quand une machine ne se connecte pas

Symptôme	Où regarder
`elxvnet status` n'indique aucune connexion	L'adresse du serveur, le certificat, ou un mandataire sortant qui intercepte le TLS
Connecté, mais aucune adresse attribuée	La machine attend encore une validation dans l'interface
Adresse attribuée, les voisins ne répondent pas	Le pare-feu local bloque la carte virtuelle — déclarez-la comme réseau privé
Windows voit la carte mais pas de voisinage réseau	La découverte du réseau et le partage de fichiers sont désactivés pour le profil de cette carte
La connexion tombe toutes les quelques minutes	Une liaison mobile à l'inactivité sévèrement coupée, ou deux clients installés avec la même identité
Tout marche sauf un protocole	Ce protocole est lié à une autre carte — vérifiez l'ordre et les métriques des interfaces

L'essai le plus rapideEnvoyez un ping à un voisin par son adresse. Si l'adresse répond et le nom non, le problème vient de la résolution de noms et non du réseau — et c'est un bien moindre mal.

Documentation