Aller au contenu
Localtonet Localtonet Tableau de bord

Référence des paramètres du tunnel

Aide pour cette page
Sur cette page 15 sections
  1. Ouvrir les paramètres d'un tunnel
  2. Ouvrir la page du type de tunnel
  3. Sélectionner Paramètres dans la ligne du tunnel
  4. Modifier un paramètre
  5. Comment les modifications sont appliquées
  6. Quel type de tunnel propose quel paramètre
  7. Ce que fait chaque paramètre
  8. Détails du tunnel
  9. Note du tunnel
  10. SslStream ?
  11. PROXY protocol ?
  12. Connexion héritée ?
  13. IP du serveur local
  14. IP du tunnel
  15. Paramètres dans la liste des tunnels
  16. Changer de serveur
  17. Changer d'AuthToken
  18. Pare-feu applicatif web
  19. Les mêmes paramètres via l'API
  20. Dépannage
  21. Pages associées

Chaque tunnel dispose d'un panneau de paramètres dans le tableau de bord. Cette page indique où l'ouvrir, énumère chaque paramètre, précise quels types de tunnel le proposent et renvoie vers la page qui l'explique en détail.

Ouvrir les paramètres d'un tunnel #

  1. Ouvrir la page du type de tunnel #

    Dans le menu du tableau de bord, ouvrez Mes tunnels et choisissez le type : Mes tunnels › HTTP, TCP - UDP, TLS, Serveur de fichiers, Serveur proxy, Proxy rotatif ou Passerelle MCP.

  2. Sélectionner Paramètres dans la ligne du tunnel #

    Repérez le tunnel sous Vos tunnels et sélectionnez Paramètres dans la colonne Actions. Le panneau Paramètres du tunnel s'ouvre sur le côté de la page.

  3. Modifier un paramètre #

    Le panneau comporte les parties suivantes :

    • Détails du tunnel : des informations comme l'adresse du tunnel, la date de création et le nom de l'AuthToken, ainsi que les valeurs que vous pouvez modifier en les sélectionnant : le titre sur tous les types de tunnel, et aussi l'adresse locale et le port local sur les tunnels HTTP, TCP - UDP et TLS.
    • Les cibles d'équilibrage de charge du tunnel, sur les types de tunnel qui les prennent en charge. Voir Équilibrage de charge.
    • Afficher la commande SSH, sur les types de tunnel qui peuvent être démarrés avec un simple SSH. Voir SSH sans installation.
    • Paramètres : une ligne par paramètre. Une ligne comporte soit un interrupteur Oui / Non, soit un bouton (Gérer, Modifier, Afficher ou Effacer) qui ouvre une boîte de dialogue. L'icône d'information à côté d'un libellé explique le paramètre en une phrase.

    La plupart des interrupteurs demandent une confirmation avant de modifier quoi que ce soit, par exemple Activer HTTPS uniquement ? avec les boutons Activer et Annuler. L'activation de Authentification basique ? ou de Réécrire le chemin ? ouvre à la place une boîte de dialogue, et l'activation de Réservé ? sur un tunnel en cours d'exécution réserve le port sans poser de question.

Comment les modifications sont appliquées #

Certains paramètres sont appliqués à un tunnel en cours d'exécution sans l'interrompre. D'autres arrêtent le tunnel et le redémarrent avec la nouvelle valeur, ce qui prend un instant et coupe les connexions ouvertes.

Appliqués sans redémarrageRedémarrent un tunnel en cours d'exécution
HTTPS uniquement ?, Réécrire le chemin ?, HTTP/3 actif ?, Réservé ?, En-têtes, Délai d'expiration HTTP, Note du tunnel, Restriction IP, Date d'expiration, Port sortant, Limite de bande passante, Utilisation de la bande passante, l'interrupteur WAF Le titre, l'adresse locale et le port local dans Détails du tunnel, Authentification basique ?, SslStream ?, PROXY protocol ?, Connexion héritée ?, Port du serveur, Arguments, IP du serveur local, Limites de vitesse, le changement de serveur, le changement d'AuthToken

Un paramètre qui redémarre le tunnel ne peut être enregistré sur un tunnel en cours d'exécution que si l'application Localtonet de son appareil est connectée. Sinon, le tableau de bord répond « Vérifiez la connexion de l'appareil. » et conserve l'ancienne valeur. Sur un tunnel arrêté, la valeur est enregistrée et utilisée au prochain démarrage.

Quel type de tunnel propose quel paramètre #

Les libellés sont ceux qu'affiche la section Paramètres. « Oui » signifie que le type de tunnel dispose de la ligne.

ParamètreHTTPTCP - UDPTLSServeur de fichiersServeur proxyProxy rotatifPasserelle MCP
HTTPS uniquement ?Oui–––––Oui
Réécrire le chemin ?Oui––––––
Authentification basique ?Oui––Oui, type Default––Oui
SslStream ?OuiOui, sauf pour UDPOui––––
HTTP/3 actif ?Oui–––––Oui
Réservé ?–Oui––OuiOui–
PROXY protocol ?–Oui, sauf pour UDP–––––
Connexion héritée ?OuiOuiOuiOuiOui–Oui
Mode SSL––Oui––––
Fournisseurs SSOOui, sauf sur les tunnels d'équipe––––––
Jeton de la passerelle––––––Oui
En-têtesOui––––––
Délai d'expiration HTTPOui–––––Oui
Port du serveur–Oui––Oui, sauf pour VLESSOui–
Note du tunnelOuiOuiOuiOuiOuiOuiOui
IP du serveur localServeur local uniquementServeur local uniquementServeur local uniquement–Serveur local uniquement–Serveur local uniquement
ArgumentsOuiOuiOui–Oui––
Restriction IPOuiOuiOuiOuiOuiOuiOui
Date d'expirationOuiOuiOuiOuiOui–Oui
Limites de vitesseOuiOuiOuiOuiOui–Oui
Port sortantOuiOuiOuiOuiOuiOuiOui
Limite de bande passanteOuiOuiOuiOuiOui–Oui
Trafic de bande passanteOuiOuiOuiOuiOuiOuiOui
Utilisation de la bande passanteOuiOuiOuiOuiOui–Oui
IP du tunnel–OuiOui–OuiOui–
Journal des requêtesOuiOuiOuiOuiOui–Oui
Journal d'activitéOuiOuiOuiOuiOuiOuiOui
Santé du tunnelOuiOuiOui–OuiOuiOui

Les pages Serveur proxy et Proxy rotatif comportent d'autres lignes qui leur sont propres, comme Authentification du proxy, Contrôle d'accès, Paramètre upstream, Accès VPN, Test de débit, Jeton du tunnel et Connexion en IPv4 uniquement ?. Elles sont décrites dans Serveur proxy et Proxy rotatif. Un tunnel qui utilise le serveur Locale n'a pas de ligne Port sortant. « Serveur local uniquement » couvre aussi un tunnel dont la colonne Serveur affiche VPN.

Ce que fait chaque paramètre #

ParamètreFonctionDétails
HTTPS uniquement ?Sert l'URL publique uniquement en HTTPS.En-têtes et réécritures
Réécrire le chemin ?Ajoute un chemin devant chaque requête avant qu'elle n'atteigne votre service local.En-têtes et réécritures
Authentification basique ?Demande aux visiteurs un nom d'utilisateur et un mot de passe.Contrôle d'accès
SslStream ?Indique au tunnel que votre service local utilise lui-même HTTPS ou TLS.Cette page
HTTP/3 actif ?Permet aux clients d'accéder à l'URL publique en HTTP/3.En-têtes et réécritures
Réservé ?Conserve le même port de serveur lorsque le tunnel redémarre.Ports
PROXY protocol ?Transmet l'adresse d'origine du client à votre service dans un en-tête PROXY protocol.Cette page
Connexion héritée ?Une autre méthode de connexion à essayer lorsque le tunnel ne parvient pas à se connecter avec la méthode habituelle.Cette page
Mode SSLDétermine si Localtonet gère le HTTPS d'un tunnel TLS ou transmet le trafic chiffré tel quel à votre service.TLS
Fournisseurs SSOOblige les visiteurs à se connecter avec l'un de vos fournisseurs d'identité avant de pouvoir ouvrir le tunnel.Authentification unique (SSO)
Jeton de la passerelleAffiche le jeton que vos clients MCP envoient pour se connecter à la passerelle.Passerelle MCP
En-têtesAjoute des en-têtes de requête et de réponse fixes.En-têtes et réécritures
Délai d'expiration HTTPDéfinit combien de temps le tunnel attend la réponse de votre service à une requête.En-têtes et réécritures
Port du serveurModifie le port auquel les utilisateurs se connectent sur le serveur Localtonet.Ports
Note du tunnelUn pense-bête privé sur l'usage du tunnel.Cette page
IP du serveur localLes adresses auxquelles votre serveur local est joignable.Cette page
ArgumentsFait passer le tunnel par un réseau précis de l'appareil.Choix du réseau
Restriction IPChoisit les adresses IP autorisées à se connecter au tunnel.Contrôle d'accès
Date d'expirationArrête le tunnel à une date donnée.Limites et expiration
Limites de vitessePlafonne la vitesse d'envoi et de téléchargement.Limites et expiration
Port sortantFixe les ports vers lesquels l'application Localtonet se connecte, pour les pare-feu stricts.Ports
Limite de bande passanteArrête le tunnel une fois qu'il a transféré une quantité de données définie.Limites et expiration
Trafic de bande passanteAffiche sous forme de graphique les données qui ont transité par le tunnel.Limites et expiration
Utilisation de la bande passanteRemet à zéro le compteur de données du tunnel.Limites et expiration
IP du tunnelAffiche les adresses IP du serveur sur lequel le tunnel s'exécute.Cette page
Journal des requêtesAffiche les requêtes ou connexions enregistrées pour le tunnel.Journaux et inspection
Journal d'activitéListe les démarrages, les arrêts et les modifications de paramètres.Journaux et inspection
Santé du tunnelAffiche les résultats des vérifications de santé régulières.Journaux et inspection

Détails du tunnel #

Sélectionnez une valeur dans Détails du tunnel pour la modifier. L'enregistrement de l'une des trois redémarre un tunnel en cours d'exécution. L'adresse locale et le port local peuvent être modifiés ici sur les tunnels HTTP, TCP - UDP et TLS ; les autres types de tunnel n'affichent que le titre.

Boîte de dialogueCe qu'il faut saisirRègles
Renommer le tunnelUn nom que vous reconnaîtrez dans votre liste de tunnels, par exemple « Office NAS ».Obligatoire. 30 caractères au maximum : la boîte de dialogue compte jusqu'à 100, mais un titre de plus de 30 caractères est refusé avec « Le titre ne peut pas dépasser 30 caractères. »
Adresse localeL'endroit où l'application Localtonet trouve votre service. Utilisez 127.0.0.1 lorsque le service s'exécute sur le même appareil que l'application. Pour atteindre un autre appareil de votre réseau, saisissez son adresse, par exemple 192.168.1.20.Une adresse IPv4, une adresse IPv6 ou un nom d'hôte. Sans http://, sans chemin, sans port.
Port localLe port sur lequel votre service écoute, sur l'appareil qui l'exécute.Un nombre de 1 à 65535.

Note du tunnel #

Note du tunnel › Gérer ouvre la boîte de dialogue Note. Une note est un pense-bête sur l'usage du tunnel, visible uniquement par votre compte.

  • Une note peut contenir jusqu'à 499 caractères. La boîte de dialogue les compte au fur et à mesure de la saisie.
  • Les choix sous Étiquette placent une étiquette devant la note : Production, Préproduction, Test, Démo ou Temporaire. La note commence alors par, par exemple, Staging - . Choisir une autre étiquette remplace celle qui est déjà là.

SslStream ? #

Activez SslStream ? lorsque votre service local utilise lui-même HTTPS ou TLS, par exemple un serveur de développement qui n'écoute que sur https://localhost. Laissez-le désactivé pour un service qui parle en HTTP simple ou en TCP simple. Les tunnels HTTP, TCP et TLS disposent de cet interrupteur ; un tunnel UDP n'en a pas.

PROXY protocol ? #

Avec PROXY protocol ? activé, le tunnel transmet l'adresse d'origine du client à votre service dans un en-tête PROXY protocol. Ne l'activez que si votre service est configuré pour lire cet en-tête, car un service qui ne l'attend pas voit des octets inconnus au début de chaque connexion. Les tunnels TCP disposent de cet interrupteur ; un tunnel UDP n'en a pas.

Connexion héritée ? #

Connexion héritée ? fait passer le tunnel sur une autre méthode de connexion. Essayez-la si le tunnel ne parvient pas à se connecter avec la méthode habituelle, et désactivez-la de nouveau si elle n'apporte rien.

IP du serveur local #

Cette ligne n'apparaît que sur les tunnels dont la colonne Serveur affiche Locale ou VPN. La boîte de dialogue IP du serveur local contient les adresses auxquelles votre serveur local est joignable : une Adresse IPv4 et, facultativement, une Adresse IPv6. Laissez l'IPv6 vide si vous ne l'utilisez pas. Au moins une adresse est obligatoire. Une adresse qui ne fonctionne que sur l'appareil lui-même, comme 127.0.0.1, 0.0.0.0 ou ::1, est refusée avec « L'IP du serveur local doit être joignable depuis l'extérieur. »

IP du tunnel #

IP du tunnel › Afficher ouvre la boîte de dialogue IP du serveur avec l'adresse IPv4 et, lorsque le serveur en a une, l'adresse IPv6 du serveur sur lequel le tunnel s'exécute. Les clients peuvent se connecter au tunnel avec cette adresse au lieu du nom de domaine.

Les adresses IP des serveurs peuvent changer. Utilisez le nom de domaine dans les applications et les scripts chaque fois que possible.

Paramètres dans la liste des tunnels #

Deux paramètres se modifient depuis la liste des tunnels, et non depuis le panneau.

Changer de serveur #

Sélectionnez le code du serveur dans la colonne Serveur, choisissez un autre serveur dans la boîte de dialogue Changer de serveur et sélectionnez Valider. Un tunnel en cours d'exécution est redémarré sur le nouveau serveur.

  • Changer de serveur nécessite du solde. Sans solde, le tableau de bord répond « Vous devez acheter du solde pour utiliser cette fonctionnalité. »
  • Si le port de serveur du tunnel est déjà pris sur le nouveau serveur, vous obtenez « Le port de votre tunnel (PORT) n'est pas disponible sur le serveur sélectionné. Changez d'abord le port. » Changez le port comme décrit dans Ports, puis réessayez.
  • Les tunnels dont la colonne Serveur affiche Locale ou VPN ne peuvent pas être déplacés.

Lors d'un changement de serveur, la mise à jour du DNS peut prendre jusqu'à 3 heures.

Changer d'AuthToken #

Sélectionnez le nom du jeton dans la colonne AuthToken pour ouvrir Changer d'AuthToken, choisissez un autre AuthToken et sélectionnez Valider. Le tunnel passe alors sur l'appareil qui exécute l'application Localtonet avec ce jeton.

  • Un tunnel en cours d'exécution s'arrête, attend 2 secondes, puis redémarre avec l'AuthToken sélectionné. Un tunnel arrêté reste arrêté.
  • Si l'application associée au nouveau jeton n'est pas connectée, le jeton est tout de même changé et vous obtenez « L'AuthToken a été mis à jour, mais le tunnel n'a pas pu être redémarré. Connectez l'application Localtonet avec le jeton sélectionné et démarrez le tunnel. »
  • Les tunnels Proxy rotatif utilisent des groupes d'AuthToken. Changez plutôt les groupes.

Les AuthToken sont expliqués dans AuthToken.

Pare-feu applicatif web #

Les tunnels HTTP et Passerelle MCP disposent aussi d'un bouton en forme de bouclier dans la colonne Actions. Il ouvre le pare-feu du tunnel. Voir Pare-feu applicatif web.

Les mêmes paramètres via l'API #

La plupart des paramètres peuvent aussi être lus et modifiés avec l'API, sous le chemin du tunnel. L'authentification et la référence complète se trouvent dans API.

ParamètreChemin après /api/v2/tunnels/<TUNNEL_ID>/
Restriction IPip-restrictions
En-têtesheaders, host-header
Authentification basiqueauthentication
Date d'expirationexpiration
Port du serveurserver-port
Délai d'expiration HTTPhttp-timeout
Limites de vitesserate-limit
Limite et utilisation de la bande passantebandwidth-limit, bandwidth-usage, bandwidth-usage/reset
Argumentsarguments
HTTPS uniquement ?, HTTP/3 actif ?, Réécrire le chemin ?https-only, http3, path-rewrite
SslStream ?, PROXY protocol ?, Mode SSLssl-stream, proxy-protocol, pass-through
Note du tunnelnote
Serveurserver

Dépannage #

« Vérifiez la connexion de l'appareil. »

Le paramètre redémarre le tunnel, et l'application Localtonet de l'appareil du tunnel n'est pas connectée. Lancez l'application sur l'appareil, attendez que la colonne Connexion affiche ON, puis enregistrez de nouveau. Vous pouvez aussi arrêter le tunnel d'abord : sur un tunnel arrêté, la valeur est enregistrée sans redémarrage.

« Vous devez acheter du solde pour utiliser cette fonctionnalité. »

Le paramètre nécessite du solde sur le compte. C'est le cas des ports réservés, d'un port de serveur personnalisé, des ports sortants fixes, des restrictions IP et du changement de serveur. Voir Offres et solde.

« Vous n'avez pas l'autorisation de modifier ce tunnel. »

Vous travaillez en équipe et votre rôle n'inclut pas la modification des tunnels. Demandez au propriétaire de l'équipe de vous accorder cette autorisation. Voir Gestion d'équipe.

Une ligne du tableau est absente de mon panneau

Le panneau n'affiche que les lignes correspondant au type du tunnel, et quelques lignes dépendent du tunnel lui-même : IP du serveur local nécessite le serveur Locale ou VPN, Fournisseurs SSO n'est pas affiché sur les tunnels d'équipe, et un tunnel UDP n'a ni SslStream ? ni PROXY protocol ?.

Support