Référence des paramètres du tunnel
Sur cette page 15 sections
- Ouvrir les paramètres d'un tunnel
- Ouvrir la page du type de tunnel
- Sélectionner Paramètres dans la ligne du tunnel
- Modifier un paramètre
- Comment les modifications sont appliquées
- Quel type de tunnel propose quel paramètre
- Ce que fait chaque paramètre
- Détails du tunnel
- Note du tunnel
- SslStream ?
- PROXY protocol ?
- Connexion héritée ?
- IP du serveur local
- IP du tunnel
- Paramètres dans la liste des tunnels
- Changer de serveur
- Changer d'AuthToken
- Pare-feu applicatif web
- Les mêmes paramètres via l'API
- Dépannage
- 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 #
-
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.
-
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.
-
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émarrage | Redé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ètre | HTTP | TCP - UDP | TLS | Serveur de fichiers | Serveur proxy | Proxy rotatif | Passerelle MCP |
|---|---|---|---|---|---|---|---|
| HTTPS uniquement ? | Oui | – | – | – | – | – | Oui |
| Réécrire le chemin ? | Oui | – | – | – | – | – | – |
| Authentification basique ? | Oui | – | – | Oui, type Default | – | – | Oui |
| SslStream ? | Oui | Oui, sauf pour UDP | Oui | – | – | – | – |
| HTTP/3 actif ? | Oui | – | – | – | – | – | Oui |
| Réservé ? | – | Oui | – | – | Oui | Oui | – |
| PROXY protocol ? | – | Oui, sauf pour UDP | – | – | – | – | – |
| Connexion héritée ? | Oui | Oui | Oui | Oui | Oui | – | Oui |
| Mode SSL | – | – | Oui | – | – | – | – |
| Fournisseurs SSO | Oui, sauf sur les tunnels d'équipe | – | – | – | – | – | – |
| Jeton de la passerelle | – | – | – | – | – | – | Oui |
| En-têtes | Oui | – | – | – | – | – | – |
| Délai d'expiration HTTP | Oui | – | – | – | – | – | Oui |
| Port du serveur | – | Oui | – | – | Oui, sauf pour VLESS | Oui | – |
| Note du tunnel | Oui | Oui | Oui | Oui | Oui | Oui | Oui |
| IP du serveur local | Serveur local uniquement | Serveur local uniquement | Serveur local uniquement | – | Serveur local uniquement | – | Serveur local uniquement |
| Arguments | Oui | Oui | Oui | – | Oui | – | – |
| Restriction IP | Oui | Oui | Oui | Oui | Oui | Oui | Oui |
| Date d'expiration | Oui | Oui | Oui | Oui | Oui | – | Oui |
| Limites de vitesse | Oui | Oui | Oui | Oui | Oui | – | Oui |
| Port sortant | Oui | Oui | Oui | Oui | Oui | Oui | Oui |
| Limite de bande passante | Oui | Oui | Oui | Oui | Oui | – | Oui |
| Trafic de bande passante | Oui | Oui | Oui | Oui | Oui | Oui | Oui |
| Utilisation de la bande passante | Oui | Oui | Oui | Oui | Oui | – | Oui |
| IP du tunnel | – | Oui | Oui | – | Oui | Oui | – |
| Journal des requêtes | Oui | Oui | Oui | Oui | Oui | – | Oui |
| Journal d'activité | Oui | Oui | Oui | Oui | Oui | Oui | Oui |
| Santé du tunnel | Oui | Oui | Oui | – | Oui | Oui | Oui |
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ètre | Fonction | Dé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 SSL | Détermine si Localtonet gère le HTTPS d'un tunnel TLS ou transmet le trafic chiffré tel quel à votre service. | TLS |
| Fournisseurs SSO | Oblige les visiteurs à se connecter avec l'un de vos fournisseurs d'identité avant de pouvoir ouvrir le tunnel. | Authentification unique (SSO) |
| Jeton de la passerelle | Affiche le jeton que vos clients MCP envoient pour se connecter à la passerelle. | Passerelle MCP |
| En-têtes | Ajoute des en-têtes de requête et de réponse fixes. | En-têtes et réécritures |
| Délai d'expiration HTTP | Définit combien de temps le tunnel attend la réponse de votre service à une requête. | En-têtes et réécritures |
| Port du serveur | Modifie le port auquel les utilisateurs se connectent sur le serveur Localtonet. | Ports |
| Note du tunnel | Un pense-bête privé sur l'usage du tunnel. | Cette page |
| IP du serveur local | Les adresses auxquelles votre serveur local est joignable. | Cette page |
| Arguments | Fait passer le tunnel par un réseau précis de l'appareil. | Choix du réseau |
| Restriction IP | Choisit les adresses IP autorisées à se connecter au tunnel. | Contrôle d'accès |
| Date d'expiration | Arrête le tunnel à une date donnée. | Limites et expiration |
| Limites de vitesse | Plafonne la vitesse d'envoi et de téléchargement. | Limites et expiration |
| Port sortant | Fixe les ports vers lesquels l'application Localtonet se connecte, pour les pare-feu stricts. | Ports |
| Limite de bande passante | Arrête le tunnel une fois qu'il a transféré une quantité de données définie. | Limites et expiration |
| Trafic de bande passante | Affiche sous forme de graphique les données qui ont transité par le tunnel. | Limites et expiration |
| Utilisation de la bande passante | Remet à zéro le compteur de données du tunnel. | Limites et expiration |
| IP du tunnel | Affiche les adresses IP du serveur sur lequel le tunnel s'exécute. | Cette page |
| Journal des requêtes | Affiche 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 tunnel | Affiche 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 dialogue | Ce qu'il faut saisir | Règles |
|---|---|---|
| Renommer le tunnel | Un 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 locale | L'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 local | Le 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ètre | Chemin après /api/v2/tunnels/<TUNNEL_ID>/ |
|---|---|
| Restriction IP | ip-restrictions |
| En-têtes | headers, host-header |
| Authentification basique | authentication |
| Date d'expiration | expiration |
| Port du serveur | server-port |
| Délai d'expiration HTTP | http-timeout |
| Limites de vitesse | rate-limit |
| Limite et utilisation de la bande passante | bandwidth-limit, bandwidth-usage, bandwidth-usage/reset |
| Arguments | arguments |
| HTTPS uniquement ?, HTTP/3 actif ?, Réécrire le chemin ? | https-only, http3, path-rewrite |
| SslStream ?, PROXY protocol ?, Mode SSL | ssl-stream, proxy-protocol, pass-through |
| Note du tunnel | note |
| Serveur | server |
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 ?.