Introduction

Les fonctionnalités à distance de Level (contrôle à distance, terminal, services, processus, etc.) utilisent une connexion basée sur WebRTC entre votre navigateur et l'appareil cible. Lorsque cette connexion ne peut pas être directe, elle bascule vers des serveurs relais. Si les sessions à distance sont lentes, échouent à se connecter, ou si vous voyez « connexion en cours… » indéfiniment, ce guide vous aide à identifier la source du problème.

Comment Level établit les connexions à distance

Level tente de se connecter dans cet ordre, en s'arrêtant dès qu'une tentative réussit :

P2P direct — votre navigateur se connecte directement à l'appareil. Latence la plus faible, aucun intermédiaire.
STUN — utilise global.stun.twilio.com pour traverser le NAT et découvrir un chemin direct.
TURN via UDP (port 3478) — le trafic est relayé via global.turn.twilio.com.
TURN via TCP (port 3478) — même relais, TCP à la place d'UDP pour les pare-feux plus restrictifs.
TURN via TLS (port 5349) — dernier recours ; relais chiffré pour les environnements les plus restrictifs.

Toutes les connexions sont initiées en sortie depuis le navigateur et l'agent. Vous ne devriez pas avoir besoin de règles de pare-feu entrantes.

ℹ️ REMARQUE : Les connexions par relais (TURN) ajoutent de la latence par rapport au P2P. Si vous êtes constamment sur relais, la session fonctionnera mais pourra sembler plus lente. L'objectif de ce guide est de vous amener au P2P ou, au minimum, de confirmer que le relais fonctionne correctement.

Tester votre connexion

Test réseau Twilio

Exécutez ceci depuis le navigateur de la machine que vous utilisez pour accéder à Level (le côté technicien, pas le point de terminaison) : Test réseau Twilio

Ceci vérifie si votre navigateur peut atteindre les serveurs STUN et TURN utilisés par Level. Si les tests TURN échouent ici, les sessions à distance échoueront ou expireront depuis votre emplacement.

Test Trickle ICE

L'outil Trickle ICE vérifie si votre navigateur peut recueillir un candidat server reflexive (srflx) via le serveur STUN de Level.

Utilisez cette valeur :

Serveur STUN : stun:global.stun.twilio.com:3478

Si aucun candidat srflx n'apparaît pas, le STUN est peut-être bloqué du côté technicien.

⚠️ AVERTISSEMENT : N'ajoutez pas turn:global.turn.twilio.com:3478 à Trickle ICE sans identifiants. Le navigateur rejettera la saisie avec une erreur de nom d'utilisateur ou de mot de passe TURN. Utilisez le test réseau Twilio ci-dessus pour tester la connectivité TURN de Level via UDP, TCP et TLS.

Causes courantes et solutions

Les sessions à distance échouent complètement à se connecter :

Le navigateur côté technicien ne peut pas atteindre les serveurs TURN. Exécutez le test réseau Twilio depuis votre navigateur pour le confirmer. En cas d'échec, votre réseau d'entreprise ou votre VPN bloque peut-être UDP 3478 ou TCP 3478 en sortie.
Le réseau côté agent bloque la même chose. Consultez les exigences réseau dans Dépannage hors ligne et confirmez que l'appareil peut atteindre global.turn.twilio.com en sortie sur le port 3478.

Les sessions à distance se connectent mais sont lentes ou se déconnectent fréquemment :

La connexion passe par le relais (TURN) plutôt que par P2P. Cela est attendu sur des réseaux fortement soumis au NAT ou à des pare-feux. Le relais ajoute une latence aller-retour — si les deux côtés ont accès à Internet, le relais TURN devrait tout de même être utilisable.
Vérifiez la perte de paquets entre l'agent et global.turn.twilio.com à l'aide d'un traceroute ou d'un ping.

Les sessions fonctionnent depuis certains réseaux mais pas d'autres :

Le problème est spécifique à la configuration du pare-feu de ce réseau. Utilisez Trickle ICE depuis ce réseau pour confirmer quels candidats sont bloqués.

Accès réseau requis

Pour que les connexions à distance fonctionnent, votre navigateur et l'appareil cible ont tous deux besoin d'un accès sortant vers :

Point de terminaison	Port	Protocole	Objectif
`global.stun.twilio.com`	3478	UDP	STUN — traversée NAT
`global.turn.twilio.com`	3478	TCP & UDP	Relais TURN
`global.turn.twilio.com`	5349	TCP	TURN TLS (dernier recours)

💡 CONSEIL : Commencez par UDP 3478 en sortie. La plupart des réseaux qui ont besoin de TURN peuvent l'utiliser sur UDP 3478 sans ouvrir autre chose. Ne passez à TCP 3478 ou 5349 que si UDP est bloqué.

Vérifier si une session est en P2P ou en relais

Level affiche le type de connexion directement dans l'interface — aucune capture de paquets n'est nécessaire.

Contrôle à distance — recherchez le badge de connexion en haut à gauche de la barre d'outils de session. Il affiche P2P ou Relais.
Gestion en arrière-plan (Terminal, Explorateur de fichiers, Processus, Services) — recherchez le badge en haut à droite de la barre d'outils de session. Il affiche Connecté : P2P ou Connecté : Relais.

Survolez le badge pour voir quel côté est sur relais — il indiquera si le problème se situe du côté technicien (votre navigateur), du côté appareil (l'agent), ou des deux. Cela vous indique exactement où concentrer l'investigation réseau.

FAQ

Le contrôle à distance se connecte mais semble lent. Est-ce un problème de relais ? Cela est possible, mais de nombreux facteurs influencent les performances de session. Commencez par vérifier le badge de connexion — s'il affiche P2P, le type de connexion n'est pas en cause et autre chose provoque le ralentissement. S'il affiche Relais, survolez le badge pour voir quel côté est sur relais, puis parcourez les exigences réseau pour ce côté.
Le test réseau Twilio réussit mais les sessions à distance échouent toujours. Le test s'exécute depuis votre navigateur. Le côté appareil a également besoin d'un accès sortant vers les mêmes points de terminaison TURN. Exécutez --check sur l'appareil (voir Dépannage des problèmes d'agent) et recherchez les échecs liés à TURN. Si l'appareil est sur un réseau plus restrictif que votre navigateur, il peut ne pas être en mesure d'atteindre global.turn.twilio.com.
Dois-je ouvrir des ports de pare-feu entrants pour l'accès à distance Level ? Non. Toutes les connexions sont initiées en sortie depuis le navigateur et l'agent. Vous n'avez pas besoin de règles entrantes.
Le badge indique Relais. Comment activer le P2P ? Survolez d'abord le badge — il vous indiquera quel côté est sur relais. Si c'est le côté appareil, vérifiez que l'appareil peut atteindre global.stun.twilio.com et global.turn.twilio.com en sortie sur UDP 3478. Si c'est le côté technicien (votre navigateur), exécutez le test réseau Twilio depuis ce réseau. Si les deux côtés affichent le relais, vérifiez les deux. Dans les environnements très restreints (filtrage de sortie strict, NAT de niveau opérateur), le relais peut simplement être le mode permanent — les sessions fonctionneront tout de même, mais avec une latence accrue.

Dépannage Relais/P2P