Faire passer un tunnel par un réseau précis
Sur cette page 10 sections
- Avant de commencer
- Étapes
- Lister les réseaux de l'appareil
- Ouvrir le paramètre Arguments du tunnel
- Saisir le réseau
- Enregistrer
- Les arguments sous forme de texte
- À quoi sert le réseau sélectionné
- Lorsque le réseau n'est pas disponible
- Sélectionner un réseau pour l'ensemble du client
- Exemple : deux proxys sur deux modems
- Le même paramètre via l'API
- Dépannage
- Pages associées
Lorsqu'un appareil dispose de plusieurs connexions Internet, par exemple une seconde ligne ou un modem USB, vous pouvez faire passer un tunnel par un réseau précis. Les autres tunnels continuent d'utiliser la connexion par défaut. Vous choisissez le réseau avec deux valeurs : son nom et l'adresse IP de l'appareil sur ce réseau.
Avant de commencer #
- Un appareil avec au moins deux réseaux actifs, sur lequel le client Localtonet est installé. Consultez Installer.
- Un tunnel d'un type qui possède le paramètre Arguments : HTTP, TCP - UDP, TLS ou Serveur proxy.
- Sous Linux, exécutez le client en tant que root ou avec
sudosans mot de passe. Le client ajoute des règles de routage pour le réseau sélectionné avec la commandeip; sans cette autorisation, le trafic peut sortir par la route par défaut.
Étapes #
-
Lister les réseaux de l'appareil #
Sur l'appareil, exécutez :
Terminallocaltonet --networkLa commande n'a pas besoin d'AuthToken. Elle liste chaque réseau actif avec ses adresses IP, vérifie l'accès à Internet de chaque adresse IPv4, puis se termine :
SortieNetworkName: Ethernet 2 --net Ethernet 2 --ip 192.168.8.100 --> Internet available (public IP 203.0.113.25) -------------------------------------------------- NetworkName: Wi-Fi --net Wi-Fi --ip 192.168.1.20 --> Internet available (public IP 198.51.100.7) --net Wi-Fi --ip 2001:db8::20 --> IPv6, internet check not available --------------------------------------------------Chaque ligne qui commence par
--netest une paire toute prête nom de réseau et adresse IP. Notez la paire du réseau voulu. Une ligne qui se termine parNo internet accesscorrespond à une adresse dont la vérification d'accès à Internet a échoué. Après la liste, la commande affiche une courte explication de--netet--ip. -
Ouvrir le paramètre Arguments du tunnel #
Dans le tableau de bord, ouvrez la page du type de tunnel, sélectionnez Paramètres sur la ligne du tunnel, puis Arguments › Gérer. La boîte de dialogue Choix du réseau s'ouvre.
-
Saisir le réseau #
Activez Utiliser un réseau précis et renseignez les deux champs :
Champ Ce qu'il faut saisir Exemple Nom du réseau Le nom exactement tel que localtonet --networkl'affiche aprèsNetworkName:.Ethernet 2IP de l'appareil sur ce réseau L'adresse IPv4 ou IPv6 de l'appareil sur ce réseau, tirée d'une ligne --netde ce réseau.192.168.8.100Envoyé à l'application affiche les arguments obtenus, par exemple
--net Ethernet 2 --ip 192.168.8.100. -
Enregistrer #
Sélectionnez Enregistrer. Un tunnel en cours d'exécution est redémarré et utilise ensuite le réseau sélectionné.
Les arguments sous forme de texte #
Modifier en texte fait passer la boîte de dialogue à un seul champ Arguments, et Utiliser le formulaire revient en arrière. Le texte a cette forme :
--net <NETWORK_NAME> --ip <IP_ADDRESS>--netet--ipdoivent être indiqués ensemble. Avec un seul des deux, le tunnel n'a pas de réseau propre : il utilise le réseau par défaut, ou le réseau sélectionné pour l'ensemble du client.- Un nom de réseau contenant des espaces peut être écrit tel quel ou entre guillemets :
--net Wi-Fi 2 --ip 192.168.1.5et--net "Wi-Fi 2" --ip 192.168.1.5ont la même signification. - Le nom est d'abord comparé exactement. Un nom qui ne diffère que par les majuscules et minuscules est accepté s'il correspond exactement à un seul réseau.
- L'adresse IP doit être une adresse que l'appareil possède actuellement sur ce réseau.
À quoi sert le réseau sélectionné #
- La connexion du tunnel entre l'appareil et le serveur Localtonet.
- Pour un tunnel proxy, le trafic qui quitte l'appareil directement vers Internet, ainsi que les requêtes DNS correspondantes. Si le tunnel proxy a un Paramètre upstream, la connexion au proxy upstream n'est pas liée au réseau sélectionné.
- La connexion à votre service local, lorsque ce service est joint par le réseau sélectionné. Un service sur l'appareil lui-même (
127.0.0.1) ou sur un autre réseau local est joint de la manière habituelle.
Lorsque le réseau n'est pas disponible #
Lorsque le réseau sélectionné est absent, le tunnel ne bascule pas sur la connexion par défaut : ses connexions restent fermées. C'est important pour les proxys : le trafic ne doit pas sortir par une ligne différente de celle que vous avez choisie.
- Si le réseau est absent au démarrage du tunnel, le tunnel l'attend.
- Si le réseau disparaît plus tard, les connexions du tunnel restent fermées jusqu'à ce que la paire nom de réseau et adresse IP soit de nouveau disponible. Le client vérifie à nouveau toutes les quelques secondes et lorsque les réseaux de l'appareil changent, et le tunnel reprend de lui-même.
- Si l'appareil obtient une autre adresse IP sur ce réseau, la paire ne correspond plus et le tunnel reste fermé. Donnez à l'appareil une adresse fixe sur ce réseau, ou mettez à jour le paramètre.
Démarrez le client avec votre jeton et --debug (localtonet --authtoken <YOUR_TOKEN> --debug) pour voir la raison dans sa sortie d'erreur. La ligne commence par un horodatage et [debug][proxy], puis nomme le tunnel par son identifiant interne, le problème et la paire attendue :
[2026-11-14 10:15:30.123 UTC][debug][proxy] Tunnel <TUNNEL_IDENTIFIER>: Network interface 'Ethernet 2' was not found. Run 'localtonet --network' to list the interfaces. Its connections stay closed until --net Ethernet 2 --ip 192.168.8.100 is available.Parmi les autres problèmes qu'elle peut nommer figurent « '192.168.8.100' is not an address of network interface 'Ethernet 2'. », « Network interface 'Ethernet 2' is Down. » et « The --ip value is not an IP address. »
Sélectionner un réseau pour l'ensemble du client #
Pour sélectionner un réseau pour la connexion propre du client et pour chaque tunnel sans réseau propre, passez les deux mêmes options au démarrage :
localtonet --authtoken <YOUR_TOKEN> --net <NETWORK_NAME> --ip <IP_ADDRESS>- Les deux options sont obligatoires. Avec une seule, le client affiche « --net and --ip must be given together; the default network is used. » et continue sur le réseau par défaut.
- Si le réseau n'est pas disponible au démarrage, le client l'attend jusqu'à 30 secondes, puis s'arrête en indiquant la raison, au lieu de fonctionner sur un autre réseau.
- Un tunnel qui possède son propre réseau dans Arguments utilise celui-ci. Les options du client s'appliquent aux tunnels qui n'en ont pas.
Toutes les options de ligne de commande sont listées dans la Référence CLI.
Exemple : deux proxys sur deux modems #
Un ordinateur a deux modems USB. localtonet --network affiche --net Modem A --ip 192.168.8.100 et --net Modem B --ip 192.168.9.100. Créez deux tunnels Serveur proxy sur l'AuthToken de l'appareil. Dans le premier, ouvrez Arguments › Gérer et saisissez Modem A et 192.168.8.100 ; dans le second, saisissez Modem B et 192.168.9.100. Chaque proxy sort désormais par son propre modem, et un proxy cesse de transmettre du trafic lorsque son modem est débranché.
Le même paramètre via l'API #
Les arguments d'un tunnel peuvent être lus (GET) et définis (PATCH) sous /api/v2/tunnels/<TUNNEL_ID>/arguments. Envoyez une valeur vide pour les supprimer. Une valeur définie via l'API est utilisée au prochain démarrage du tunnel. Consultez API.
{ "arguments": "--net Ethernet 2 --ip 192.168.8.100" }Dépannage #
« Saisissez le nom du réseau. » ou « Saisissez l'adresse IP de l'appareil sur ce réseau. »
Les deux champs sont obligatoires tant que Utiliser un réseau précis est activé. Pour ne plus utiliser de réseau précis, désactivez l'interrupteur et enregistrez.
« Saisissez une adresse IP comme 192.168.8.100. »
Le second champ attend l'adresse IP de l'appareil sur ce réseau, et non le nom du réseau ni l'adresse IP publique.
« Vérifiez la connexion de l'appareil. »
L'enregistrement redémarre un tunnel en cours d'exécution, et l'application Localtonet de son appareil n'est pas connectée. Démarrez l'application, ou arrêtez le tunnel et enregistrez à nouveau.
Le tunnel est démarré mais ne transmet aucun trafic
Le réseau sélectionné n'est probablement pas disponible. Exécutez localtonet --network sur l'appareil et comparez le nom et l'adresse IP avec le paramètre. Corrigez le paramètre, ou rétablissez le réseau.
Sous Linux, le trafic sort toujours par la route par défaut
Le client n'a probablement pas pu ajouter les règles de routage. Exécutez-le en tant que root ou autorisez sudo sans mot de passe pour la commande ip, puis redémarrez le client. Le client n'ajoute aucune règle pour un réseau qui ne signale aucune passerelle.
localtonet --network affiche « No active network interface with an IP address was found. »
L'appareil n'a aucun réseau actif possédant une adresse. Connectez un réseau et exécutez à nouveau la commande.