Comment fonctionne Localtonet
Sur cette page 10 sections
- Le parcours d'une requête
- Pas de redirection de port, pas d'IP publique
- Appareils et AuthTokens
- Tunnels
- De la création à la mise en service
- Régions de serveur
- Adresses publiques et types d'URL
- L'adresse reste-t-elle la même ?
- Chiffrement de bout en bout
- Lorsque le client se déconnecte
- Local comme serveur
- Étapes suivantes
Le client Localtonet sur votre appareil ouvre un tunnel chiffré sortant vers un serveur Localtonet. Le serveur donne à votre service une adresse publique et transmet le trafic dans ce tunnel jusqu'à l'adresse IP locale et au port que vous avez choisis.
Le parcours d'une requête #
- Un visiteur se connecte à l'adresse publique de votre tunnel. Cette adresse appartient à un serveur Localtonet de la région que vous avez choisie.
- Le serveur Localtonet envoie le trafic dans le tunnel que le client sur votre appareil a déjà ouvert.
- Le client Localtonet reçoit le trafic et se connecte à l'adresse IP locale et au port définis sur le tunnel, par exemple
127.0.0.1:3000. - Votre service répond, et la réponse refait le même chemin en sens inverse.
Pas de redirection de port, pas d'IP publique #
Votre appareil établit la connexion ; aucun port entrant n'a donc besoin d'être ouvert. Vous n'avez pas besoin d'adresse IP publique ni de modifier votre routeur. Cela fonctionne aussi derrière un NAT ou un CGNAT, sur les connexions domestiques et mobiles où la redirection de port est impossible.
Votre réseau doit tout de même autoriser la connexion sortante. Un pare-feu ou un produit de sécurité des postes de travail peut la bloquer.
Pour les tunnels HTTP et TCP, vous pouvez aussi vous passer du client : les paramètres du tunnel affichent une commande SSH qui ouvre le tunnel depuis n'importe quelle machine disposant d'un client SSH. Consultez SSH sans installation.
Appareils et AuthTokens #
Un AuthToken relie un appareil à votre compte. Vous démarrez le client avec lui, puis vous pouvez choisir cet appareil lorsque vous créez un tunnel.
- Un jeton par appareil. Créez un jeton pour chaque appareil sous Mes jetons et donnez-lui un nom que vous reconnaissez, tel que
Office-PC. Le nom n'est qu'une étiquette. Localtonet génère lui-même le jeton. - Une connexion par jeton. Une nouvelle connexion qui utilise le même jeton remplace la précédente ; ne démarrez donc pas deux appareils avec le même jeton.
- En ligne et Hors ligne. Mes jetons affiche chaque appareil comme En ligne tant que l'application Localtonet est connectée, et Hors ligne lorsqu'elle est déconnectée, même si ses tunnels sont toujours configurés.
- Gardez-le confidentiel. Quiconque possède le jeton peut l'utiliser pour se connecter à l'application en tant que cet appareil.
Un AuthToken ne protège pas un tunnel. Il identifie votre appareil, pas vos visiteurs. Un nouveau tunnel est accessible à toute personne qui en connaît l'adresse. Pour restreindre les visiteurs, consultez Contrôle d'accès.
En savoir plus sur les jetons : AuthTokens.
Tunnels #
Un tunnel est un ensemble de paramètres enregistrés qui relie une adresse publique à un service sur un appareil. Chaque tunnel mémorise :
| Paramètre | Ce qu'il détermine |
|---|---|
| Type de tunnel | Le protocole : HTTP, TCP, UDP, TLS, Serveur de fichiers, Serveur proxy et autres. Consultez Types de tunnel. |
| Jeton d'appareil | L'appareil qui reçoit le trafic. C'est le jeton avec lequel le client de cet appareil a été démarré. |
| Région du serveur | L'emplacement du serveur Localtonet qui héberge l'adresse publique. |
| Type d'URL | La manière dont l'adresse publique est choisie. |
| Adresse IP locale et Port local | L'endroit où le client envoie le trafic. Utilisez 127.0.0.1 pour un service situé sur le même appareil que le client. |
Un appareil peut desservir plusieurs tunnels. Mes jetons affiche le nombre de tunnels actifs et le nombre total de tunnels liés à chaque jeton. Pour déplacer un tunnel vers un autre appareil, sélectionnez le nom de son jeton dans la liste des tunnels et choisissez un autre jeton sous Changer d'AuthToken. Un tunnel en cours d'exécution s'arrête et redémarre avec le jeton sélectionné. Les tunnels Proxy rotatif font exception : ils utilisent des groupes de jetons au lieu d'un jeton unique.
De la création à la mise en service #
- Créer. Créer le tunnel enregistre seulement les paramètres. Rien n'est encore en ligne.
- Démarrer. Sélectionnez Démarrer. Si le client du jeton du tunnel est connecté, le tunnel passe en ligne.
- Démarrer alors que l'appareil est hors ligne. Le tableau de bord vous indique que le jeton est hors ligne et attend que l'application se connecte. Démarrer quand même active le tunnel immédiatement. Il compte comme actif et passe en ligne lorsque l'application se connecte.
- Arrêter. L'adresse publique ne répond plus. Le tunnel et ses paramètres sont conservés pour plus tard.
- Supprimer. Le point d'accès et les paramètres du tunnel sont supprimés.
Supprimer un jeton supprime ses tunnels. Les tunnels de ce jeton sont arrêtés et supprimés.
Régions de serveur #
Le champ Région du serveur détermine où l'adresse publique d'un tunnel est hébergée. L'indication du tableau de bord est la suivante : choisissez une région proche de votre appareil pour réduire la latence.
La liste est construite pour votre compte. Elle contient :
- Les régions Localtonet, une entrée par pays. La carte du réseau de la page d'accueil montre les emplacements.
- Vos propres serveurs, si vous en avez ajouté avec le Gestionnaire de serveurs. Seul votre compte les voit, et la liste sélectionne votre serveur par défaut.
- Local comme serveur, pour les types de tunnel qui le prennent en charge. Voir ci-dessous.
Vous pouvez déplacer un tunnel existant : sélectionnez le serveur du tunnel dans la liste des tunnels pour ouvrir Changer de serveur. Cela nécessite du solde, et lors d'un changement de serveur, les mises à jour DNS peuvent prendre jusqu'à 3 heures.
Adresses publiques et types d'URL #
Lorsque vous créez un tunnel, Type d'URL détermine la manière dont son adresse publique est choisie.
| Type d'URL | Ce que vous obtenez | Offre |
|---|---|---|
| Sous-domaine aléatoire | Localtonet génère un sous-domaine pour vous. Vous obtenez une adresse tout de suite. | Offre gratuite |
| Sous-domaine personnalisé | Vous saisissez vous-même le Sous-domaine et choisissez le Domaine auquel il appartient. | Solde requis |
| Domaine personnalisé | Vous utilisez un domaine qui vous appartient et que vous avez ajouté dans le Gestionnaire DNS. Consultez Domaines personnalisés. | Solde requis |
Tous les types de tunnel ne proposent pas tous les types d'URL :
| Type de tunnel | Sous-domaine aléatoire | Sous-domaine personnalisé | Domaine personnalisé |
|---|---|---|---|
| HTTP | Oui | Oui | Oui |
| Serveur de fichiers | Oui | Oui | Oui |
| Passerelle MCP | Oui | Oui | Oui |
| TLS | Oui | Oui | Non |
| TCP, UDP, UDP / TCP mixte | Oui | Oui | Non |
| Serveur proxy | Oui | Oui | Non |
| Proxy rotatif | Oui | Oui | Non |
Les tunnels TCP, UDP et proxy sont joints par un nom d'hôte et un Port du serveur.
L'adresse reste-t-elle la même ? #
- Un tunnel HTTP conserve son sous-domaine jusqu'à ce que vous supprimiez le tunnel.
- Pour les tunnels TCP, UDP et proxy, un tunnel créé sur un compte avec du solde démarre avec Réservé ? activé, ce qui conserve le même port d'un redémarrage à l'autre. Vous pouvez le modifier tunnel par tunnel ; consultez Ports.
- Avec l'offre gratuite, le port est libéré lorsque le tunnel s'arrête ; l'adresse peut donc changer.
Chiffrement de bout en bout #
Le tunnel entre votre appareil et les serveurs Localtonet est chiffré. Ce n'est pas la même chose qu'un chiffrement de bout en bout entre un visiteur et votre service :
- Les visiteurs accèdent à un tunnel HTTP en HTTPS, avec des certificats que Localtonet gère pour vous. Ce HTTPS se termine sur le serveur Localtonet, pas sur votre service. À partir de là, le trafic parvient à votre appareil par le tunnel chiffré.
- Pour un chiffrement de bout en bout, utilisez un tunnel TLS en mode pass-through, où votre service présente son propre certificat, ou un protocole déjà chiffré, tel que SSH.
Lorsque le client se déconnecte #
Un tunnel ne fonctionne que si trois éléments sont actifs : votre appareil, le client Localtonet et votre service local. Si le client perd sa connexion ou si vous le fermez :
- Les visiteurs ne peuvent plus joindre le service via l'adresse publique.
- L'appareil apparaît comme Hors ligne dans Mes jetons. Le tunnel lui-même reste démarré.
- Le client essaie de se reconnecter de lui-même. Un tunnel démarré repasse en ligne dès que l'application se connecte.
- Un tunnel démarré est facturé tant qu'il est démarré, même si son appareil est hors ligne. Arrêtez le tunnel pour mettre fin à la facturation. Consultez Offres et solde.
Pour que le client continue de fonctionner après une déconnexion de session ou un redémarrage, installez-le comme service : Exécuter comme service. Pour être prévenu lorsqu'un tunnel ou un jeton se déconnecte, configurez les Webhooks.
Local comme serveur #
Local comme serveur est une entrée de la liste Région du serveur. Avec elle, aucun serveur Localtonet n'héberge l'adresse publique. Le client Localtonet sur votre appareil ouvre lui-même l'écouteur, et les visiteurs se connectent directement à votre appareil. Le tableau de bord appelle aussi ces tunnels Client Relay.
- Elle est proposée lorsque vous créez des tunnels HTTP, TCP, UDP, TLS, Serveur proxy et Passerelle MCP. Le Serveur de fichiers et le Proxy rotatif ne la proposent pas.
- Lorsque vous la sélectionnez, le formulaire demande une IP du serveur relais : l'adresse IP de votre appareil à laquelle les visiteurs se connectent.
- L'appareil qui héberge l'écouteur doit rester connecté.
- Les tunnels Client Relay ont leur propre tarif, plus bas. Consultez Offres et solde.
| Message | Que faire |
|---|---|
| Saisissez l'IP du serveur local. | Renseignez IP du serveur relais. |
| L'IP du serveur local doit être joignable depuis l'extérieur. | Vous avez saisi une adresse de bouclage ou une autre adresse uniquement locale, telle que 127.0.0.1. Saisissez une adresse que vos visiteurs peuvent joindre. |